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

搜索 SSM 文档

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

使用自由文本搜索

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

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

注意

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

  • 搜索区分大小写。

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

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

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

  • 您可以将自由文本搜索与其他搜索选项,如:文档类型或者平台类型结合使用。

  • 文档名称前缀过滤器和自由文本搜索不能一起使用,它们是相互排斥的。

搜索 SSM 文档

  1. 访问 https://console.aws.amazon.com/systems-manager/,打开 Amazon Systems Manager 控制台。

  2. 在导航窗格中,选择 文档

    -或者-

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

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

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

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

  1. 安装并配置 Amazon Command Line Interface (Amazon CLI)(如果尚未执行该操作)。

    想要了解有关信息,请参阅安装或升级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” 的所有文档。

  • 如果您应用其他筛选条件,例如 Document name prefix(文档名称前缀)和 Platform types(平台类型),则 Systems Manager 将使用 AND 语句进行搜索。例如,如果指定 Document name prefix(文档名称前缀)=AWS 筛选条件和 Platform types(平台类型)=Linux 筛选条件,则搜索会返回特定于 Linux 平台的带有前缀“AWS”的所有文档。

注意

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