搜索 SSM 文档 - Amazon Web Services Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

搜索 SSM 文档

您可以搜索Amazon Web Services Systems Manager(SSM) 文档存储通过使用自由文本搜索或基于筛选器的搜索。本部分介绍如何使用这两种功能来查找 SSM 文档。

使用自由文本搜索

Systems Manager 上的搜索框文档页面支持自由文本搜索。自由文本搜索会将您输入的一个或多个搜索词与每个 SSM 文档中的文档名称进行比较。如果输入单个搜索词,例如ansible,然后 Systems Manager 返回发现此术语的所有 SSM 文档。如果输入多个搜索词,Systems Manager 将使用OR网页。例如,如果指定ansiblelinux,然后搜索返回所有要么关键字的名称。

如果输入自由文本搜索词并选择搜索选项,例如平台类型,则搜索使用AND语句,并返回所有带有关键字的文档名称和指定平台类型的文档。

注意

请注意以下有关自由文本搜索的详细信息。

  • 自由文本搜索区分大小写。

  • 搜索词至少需要三个字符,最多包含 20 个字符。

  • 自由文本搜索最多可接受五个搜索词。

  • 如果在搜索词之间输入空格,系统会在搜索时包含空格。

  • 您可以将自由文本搜索与其他搜索选项(如文档类型或者平台类型

  • 这些区域有:文档名称前缀过滤器和自由文本搜索不能一起使用。它们是互斥的。

搜索 SSM 文档

  1. 打开Amazon Web Services Systems Manager控制台https://console.aws.amazon.com/systems-manager/

  2. 在导航窗格中,选择 Documents

    -或者-

    如果Amazon Web Services Systems Manager首先打开主页,选择菜单图标( ) 打开导航窗格中的,然后选择选择文档在导航窗格中,选择。

  3. 在搜索框中输入您的搜索词,然后按 Enter。

执行自由文本文档搜索,使用AmazonCLI

使用 CLI 执行自由文本文档搜索

  1. 安装和配置Amazon命令行界面 (AmazonCLI),如果尚未执行该操作。

    想要了解有关信息,请参阅安装或升级Amazon命令行工具

  2. 要使用单个术语执行自由文本文档搜索,请运行以下命令。在此命令中,替换搜索术语提供您自己的信息。

    aws ssm list-documents --filters Key="SearchKeyword",Values="search_term"

    下面是一个示例。

    aws ssm list-documents --filters Key="SearchKeyword",Values="aws-asg" --region us-east-2

    要使用多个术语进行搜索,可创建AND语句中,运行以下命令。在此命令中,替换搜索术语 1搜索术语 2提供您自己的信息。

    aws ssm list-documents --filters Key="SearchKeyword",Values="search_term_1","search_term_2","search_term_3" --region us-east-2

    下面是一个示例。

    aws ssm list-documents --filters Key="SearchKeyword",Values="aws-asg","aws-ec2","restart" --region us-east-2

使用筛选器

Systems Manager文档页面会在您选择搜索框时自动显示以下筛选器。

  • 文档名称前缀

  • 平台类型

  • 文档类型

  • 标记密钥


                    “SSM 文档” 页面上的筛选选项。

您可以使用单个筛选器搜索 SSM 文档。如果要返回一组更具体的 SSM 文档,可以应用多个筛选器。下面是一个使用平台类型文档名称前缀筛选条件。


                    在 “SSM 文档” 页面上应用多个筛选器选项。

如果应用多个筛选器,Systems Manager 会根据您选择的筛选器创建不同的搜索语句:

  • 如果您应用相同过滤多次,例如文档名称前缀,然后 Systems Manager 通过使用OR网页。例如,如果您指定一个文档名称前缀=AWS和第二个过滤器文档名称前缀=Lambda,然后搜索返回所有带有前缀”AWS“以及带有前缀的所有文档”Lambda“。

  • 如果您申请不同的过滤器,例如文档名称前缀平台类型,然后 Systems Manager 通过使用AND网页。例如,如果指定了文档名称前缀=AWS筛选器和平台类型=Linux过滤器,然后搜索返回所有带有前缀”AWS”,这些都是 Linux 平台特定的。

注意

使用筛选条件的搜索区分大小写。