搜尋 Systems Manager 參數

當您的帳戶中有大量參數時，可能很難一次找到僅一個或幾個參數的相關資訊。在此情況下，您可以使用篩選工具，根據所指定的搜尋條件，來搜尋需要相關資訊的項目。您可以使用 AWS Systems Manager 主控台、、AWS Command Line Interface (AWS CLI)、AWS Tools for PowerShell 或 DescribeParameters API 來搜尋參數。

搜尋參數 (主控台)

1. 開啟位於 https://console.aws.amazon.com/systems-manager/ 的 AWS Systems Manager 主控台。

2. 在導覽窗格中，選擇 Parameter Store。

   -或-

   如果 AWS Systems Manager 首頁先開啟，選擇選單圖示 ( ) 以開啟導覽窗格，然後選擇 Parameter Store。

3. 在搜尋方塊中選擇，然後選擇您要搜尋的方式。例如 Type 或 Name。

4. 為您選取的搜尋類型提供資訊。例如：

   • 如果要依據 Type 搜尋，請選擇 String、StringList 或 SecureString。

   • 如果要依據 Name 搜尋，請選擇 contains、equals 或 begins-with，然後輸入全部或部分參數名稱。

     注意

     在主控台中，Name 的預設搜尋類型為 contains。

5. 按 Enter 鍵。

參數的清單會隨您的搜尋結果更新。

搜尋參數 (AWS CLI)

使用 describe-parameters 命令來檢視 AWS CLI 中一或多個參數的資訊。

下列範例示範可用來檢視 AWS 帳戶 帳戶中參數相關資訊的各種選項。如需這些選項的詳細資訊，請參閱《AWS Command Line Interface 使用者指南》中的 describe-parameters 一節。

1. 如果您尚未安裝並設定 AWS Command Line Interface (AWS CLI)，請進行相應的操作。

   如需相關資訊，請參閱安裝或更新最新版本的 AWS 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 代表 AWS Key Management Service (AWS KMS) 金鑰的 ID，此金鑰用於加密您的帳戶中建立的 SecureString 參數。或者，您可以輸入 alias/aws/ssm 以使用帳戶的預設 AWS KMS 金鑰。如需更多詳細資訊，請參閱 建立 SecureString 參數 (AWS 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": []
           }
       ]
   }