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

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

搜索 SSM 文档

您可以使用自由文本搜索或基于筛选条件的搜索,在 AWS Systems Manager 文档存储中搜索 SSM 文档。本节介绍如何使用这两种功能查找 SSM 文档。

使用自由文本搜索

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

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

注意

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

  • 免费文本搜索 区分大小写。

  • 搜索词需要最少 3 个字符,最多 20 个字符。

  • 免费文本搜索最多可接受五个搜索词。

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

  • 您可以将免费文本搜索与 Document type (文档类型)Platform type (平台类型) 等其他搜索选项结合使用。

  • 文档名称前缀筛选条件和免费文本搜索不能一起使用。它们相互排斥。

搜索 SSM 文档

  1. 通过以下网址打开 AWS Systems Manager 控制台:https://console.amazonaws.cn/systems-manager/

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

    -或者-

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

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

使用 AWS CLI 执行免费文本文档搜索

使用 CLI 执行免费文本文档搜索

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

    有关信息,请参阅安装或升级 AWS 命令行工具

  2. 要使用单个字词执行免费文本文档搜索,请运行以下命令。在该命令中,替换 search_term 替换为您自己的信息。

    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 语句的词进行搜索,请运行以下命令。在该命令中,替换 search_term_1search_term_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 Documents (文档) 页面将自动显示以下筛选条件。

  • 文档名称前缀

  • 平台类型

  • 文档类型

  • 标记密钥


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

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


                    在 SSM 文档页面上应用多个筛选条件选项。

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

  • 如果您多次应用同一个 筛选条件(例如文档名称前缀),则 Systems Manager 使用 OR 语句进行搜索。例如,如果您指定一个 Document name prefix (文档名称前缀)=AWS 的筛选条件和 Document name prefix (文档名称前缀)=Lambda 的第二个筛选条件,则搜索将返回前缀为“AWS”的所有文档和前缀为“Lambda”的所有文档。

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

注意

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