搜索 Systems Manager 参数 - Amazon Systems Manager
搜索参数（控制台）搜索参数 (Amazon CLI)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

搜索 Systems Manager 参数

在您的账户中具有大量参数时，可能很难一次找到有关单个或几个参数的信息。在这种情况下，您可以使用筛选工具根据指定的搜索条件搜索需要查找信息的参数。您可以使用 Amazon Systems Manager 控制台、Amazon Command Line Interface (Amazon CLI)、Amazon Tools for PowerShell 或 DescribeParameters API 搜索参数。

搜索参数（控制台）

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

  2. 在导航窗格中，选择 Parameter Store。

  3. 在搜索框中进行选择，然后选择所需的搜索方式。例如，Type 或 Name。

  4. 提供选定的搜索类型的信息。例如：

    • 如果按 Type (类型) 进行搜索，请从 String、StringList 或 SecureString 中进行选择。

    • 如果按 Name (名称) 进行搜索，请选择 contains、equals 或 begins-with，然后输入完整参数名称或其中的一部分。

      注意

      在控制台中，Name 的默认搜索类型为 contains。

  5. 按 Enter。

将使用搜索结果更新参数列表。

搜索参数 (Amazon CLI)

可以在 Amazon CLI 中使用 describe-parameters 命令查看有关一个或多个参数的信息。

以下示例展示了多个选项，您可以使用这些选项查看有关您的 Amazon Web Services 账户中的参数的信息。有关设置这些选项的更多信息，请参阅《Amazon Command Line Interface 用户指南》中的 describe-parameters。

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

    有关信息，请参阅安装或更新 Amazon CLI 的最新版本。

  2. 将以下命令中的示例值替换为反映在您的账户中创建的参数的值。

    Linux & macOS
    aws ssm describe-parameters \
    --parameter-filters "Key=Name,Values=MyParameterName"
    Windows
    aws ssm describe-parameters ^
    --parameter-filters "Key=Name,Values=MyParameterName"
    注意

    对于 describe-parameters，Name 的默认搜索类型为 Equals。在参数筛选条件中，指定 "Key=Name,Values=MyParameterName" 与指定 "Key=Name,Option=Equals,Values=MyParameterName" 相同。

    aws ssm describe-parameters \
    --parameter-filters "Key=Name,Option=Contains,Values=Product"
    aws ssm describe-parameters \
    --parameter-filters "Key=Type,Values=String"
    aws ssm describe-parameters \
    --parameter-filters "Key=Path,Values=/Production/West"
    aws ssm describe-parameters \
    --parameter-filters "Key=Tier,Values=Standard"
    aws ssm describe-parameters \
    --parameter-filters "Key=tag:tag-key,Values=tag-value"
    aws ssm describe-parameters \
    --parameter-filters "Key=KeyId,Values=key-id"
    注意

    在最后一个示例中，key-id 表示 Amazon Key Management Service (Amazon KMS) 密钥的 ID，该密钥用于加密在您的账户中创建的 SecureString 参数。或者，您也可以输入 alias/aws/ssm 以使用您的账户的默认 Amazon KMS 密钥。有关更多信息，请参阅 创建 SecureString 参数 (Amazon CLI)。

    如果成功，该命令将返回类似于以下内容的输出。

    {
    "Parameters": [
        {
            "Name": "/Production/West/Manager",
            "Type": "String",
            "LastModifiedDate": 1573438580.703,
            "LastModifiedUser": "arn:aws:iam::111122223333:user/Mateo.Jackson",
            "Version": 1,
            "Tier": "Standard",
            "Policies": []
        },
        {
            "Name": "/Production/West/TeamLead",
            "Type": "String",
            "LastModifiedDate": 1572363610.175,
            "LastModifiedUser": "arn:aws:iam::111122223333:user/Mateo.Jackson",
            "Version": 1,
            "Tier": "Standard",
            "Policies": []
        },
        {
            "Name": "/Production/West/HR",
            "Type": "String",
            "LastModifiedDate": 1572363680.503,
            "LastModifiedUser": "arn:aws:iam::111122223333:user/Mateo.Jackson",
            "Version": 1,
            "Tier": "Standard",
            "Policies": []
        }
    ]
}