• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# 在 Systems Manager 中搜索 Parameter Store 参数
<a name="parameter-search"></a>

在您的账户中具有大量参数时，可能很难一次找到有关单个或几个参数的信息。在这种情况下，您可以使用筛选工具根据指定的搜索条件搜索需要查找信息的参数。您可以使用 AWS Systems Manager 控制台、AWS Command Line Interface (AWS CLI)、AWS Tools for PowerShell 或 [DescribeParameters](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeParameters.html) API 搜索参数。

**Topics**
+ [使用控制台来搜索参数](#parameter-search-console)
+ [使用 AWS CLI 来搜索参数](#parameter-search-cli)

## 使用控制台来搜索参数
<a name="parameter-search-console"></a>

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **Parameter Store**。

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

1. 提供选定的搜索类型的信息。例如：
   + 如果按 `Type` (类型) 进行搜索，请从 `String`、`StringList` 或 `SecureString` 中进行选择。
   + 如果按 `Name` (名称) 进行搜索，请选择 `contains`、`equals` 或 `begins-with`，然后输入完整参数名称或其中的一部分。
**注意**  
在控制台中，`Name` 的默认搜索类型为 `contains`。

1. 按 **Enter** 键。

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

**注意**  
您的搜索结果可能比第一页显示的结果还要多。使用参数列表主题处的右箭头 (**>**)（如有）查看下一组结果。

## 使用 AWS CLI 来搜索参数
<a name="parameter-search-cli"></a>

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

以下示例展示了多个选项，您可以使用这些选项查看有关您的 AWS 账户中的参数的信息。有关设置这些选项的更多信息，请参阅 *AWS Command Line Interface 用户指南*中的 [https://docs.aws.amazon.com/cli/latest/reference/ssm/describe-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/describe-parameters.html)。

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

   有关更多信息，请参阅[安装或更新 AWS CLI 的最新版本](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。

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

------
#### [ 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* 表示 AWS Key Management Service (AWS KMS) 密钥的 ID，该密钥用于加密在您的账户中创建的 `SecureString` 参数。或者，您也可以输入 **alias/aws/ssm** 以使用您的账户的默认 AWS KMS 密钥。有关更多信息，请参阅 [使用 AWS CLI 来创建 SecureString 参数](param-create-cli.md#param-create-cli-securestring)。

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

   ```
   {
       "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": []
           }
       ]
   }
   ```