• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板,就像現在一樣。如需詳細資訊,請參閱 Amazon CloudWatch Dashboard 文件。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 Parameter Store 中指派參數政策
參數政策讓您可以將特定條件 (例如過期日期或存留時間) 指派給一個參數,以協助您管理一群不斷增長的參數。參數政策在強制您更新或刪除存放在 中的組態資料方面特別有用 AWS Systems Manager。 Parameter StoreParameter Store提供以下類型的政策:Expiration、 ExpirationNotification和 NoChangeNotification。
如果您管理需要自動輪換、跨帳戶存取或精細稽核記錄的登入資料,建議您使用 AWS Secrets Manager。Secrets Manager 專為管理秘密而打造,例如資料庫登入資料、API 金鑰和支援的第三方軟體提供的秘密。如需詳細資訊,請參閱什麼是 AWS Secrets Manager? AWS Secrets Manager 《 使用者指南》中的 。
Parameter Store 使用非同步、定期掃描,強制執行參數政策。建立政策之後,您不需要執行額外的動作,即可強制執行政策。Parameter Store 會依據您指定的條件,獨立執行由政策定義的動作。
注意
參數政策適用於使用進階參數方案的參數。如需詳細資訊,請參閱在 中選擇參數層 Parameter Store。
參數政策為一 JSON 陣列,如下表所示。當您建立新的進階參數時,可以指派政策,或藉由更新參數來指派政策。Parameter Store 支援以下類型的參數政策。
| 政策 | 詳細資訊 | 範例 |
|---|---|---|
|
Expiration |
此政策會刪除參數。您可以透過使用 注意此範例使用 |
|
|
ExpirationNotification |
此政策在 Amazon EventBridge (EventBridge) 中啟動事件,藉此通知您有關過期的資訊。使用此政策,您可以在過期時間到達之前接收到通知,以天或小時為單位。 |
|
|
NoChangeNotification |
如果在指定的時間段沒有修改參數,此政策會啟動 EventBridge 中的事件。例如,當核准的 AMI ID 需要在一段時間內檢閱或更新時,此政策類型非常有用。 此政策會讀取參數的 |
|
您可以將多個政策指派給一個參數。例如,您可以指派 Expiration 和 ExpirationNotification 政策,讓系統觸發 EventBridge 事件來通知您參數即將刪除。您最多可以將十 (10) 個政策指派給一個參數。
以下範例顯示 PutParameter API 請求語法,該請求會將四個政策指派給新的 SecureString 參數,名為 /myapp/prod/vendor/merchant-id。
{ "Name": "/myapp/prod/vendor/merchant-id", "Description": "Parameter with policies", "Value": "merchant-739482", "Type": "SecureString", "Overwrite": "True", "Policies": [ { "Type": "Expiration", "Version": "1.0", "Attributes": { "Timestamp": "2018-12-02T21:34:33.000Z" } }, { "Type": "ExpirationNotification", "Version": "1.0", "Attributes": { "Before": "30", "Unit": "Days" } }, { "Type": "ExpirationNotification", "Version": "1.0", "Attributes": { "Before": "15", "Unit": "Days" } }, { "Type": "NoChangeNotification", "Version": "1.0", "Attributes": { "After": "20", "Unit": "Days" } } ] }
將政策新增至現有參數
本節包含如何使用 AWS Systems Manager 主控台、 AWS Command Line Interface (AWS CLI) 和 將政策新增至現有參數的相關資訊 AWS Tools for Windows PowerShell。如需關於如何建立包含政策的新參數的資訊,請參閱 在 Systems Manager 中建立 Parameter Store 參數。
使用主控台將政策新增至現有參數
請使用下列程序,以使用 Systems Manager 主控台,將政策新增至現有參數。
將政策新增至現有參數
在 https://https://console.aws.amazon.com/systems-manager/
開啟 AWS Systems Manager 主控台。 在導覽窗格中,選擇 Parameter Store。
-
選擇您要更新之參數旁的選項,以納入政策,然後選擇 Edit (編輯)。
-
選擇 Advanced (進階)。
-
(選用) 在 Parameter policies (參數政策) 部分,請選擇 Enabled (啟用)。您可以為該參數指定過期日期和一個或多個通知政策。
-
選擇儲存變更。
重要
-
Parameter Store 會保留參數的政策,直到您用新的政策覆寫該政策或將其移除。
-
若要從現有參數中移除所有政策,請編輯參數,並使用括弧和大括號套用空的政策,如以下所示:
[{}] -
如果您將新政策新增至已經有政策的參數,則 Systems Manager 會覆寫連接到該參數的政策。現有的政策會被刪除。如果您想要將政策新增至已經有一個或多個政策的參數,則複製並貼上原有的政策,輸入新的政策,然後儲存您的變更。
使用 將政策新增至現有參數 AWS CLI
請使用下列步驟,利用 AWS CLI將政策新增至現有參數。
將政策新增至現有參數
如果您尚未安裝並設定 AWS Command Line Interface (AWS CLI),請安裝並設定 。
如需相關資訊,請參閱安裝或更新最新版本的 AWS CLI。
-
執行以下命令,將政策新增至現有參數。將每個
範例資源預留位置取代為您自己的資訊。下列範例包含過期政策,會在 15 天後刪除 參數。此範例也包含通知政策,該政策會在參數被刪除的五 (5) 天以前產生 EventBridge 事件。最後,它包含
NoChangeNotification政策,如果 60 天之後該參數沒有變更。此範例使用名為 的參數,/myapp/prod/vendor/merchant-id並以商家 ID 做為加密值和 AWS Key Management Service AWS KMS key。如需詳細資訊 AWS KMS keys,請參閱《 AWS Key Management Service 開發人員指南》中的AWS Key Management Service 概念。 -
執行以下命令,以驗證參數的詳細資訊。將
參數名稱取代為您自己的資訊。
重要
-
Parameter Store 會保留參數的政策,直到您用新的政策覆寫該政策或將其移除。
-
若要從現有參數中移除所有的政策,請編輯該參數,並套用由括弧和大括號組成的空白政策。將每個
範例資源預留位置取代為您自己的資訊。例如: -
如果您將新政策新增至已經有政策的參數,則 Systems Manager 會覆寫連接到該參數的政策。現有的政策會被刪除。如果您想要將政策新增至已經有一個或多個政策的參數,則複製並貼上原有的政策,輸入新的政策,然後儲存您的變更。
將政策新增至現有參數 (Tools for Windows PowerShell)
請使用下列程序,以使用 Tools for Windows PowerShell,將政策新增至現有參數。將每個範例資源預留位置取代為您自己的資訊。
將政策新增至現有參數
-
開啟 Tools for Windows PowerShell 並執行以下命令,以指定您的登入資料。您必須在 Amazon Elastic Compute Cloud (Amazon EC2) 中擁有管理員許可,或必須在 AWS Identity and Access Management (IAM) 中授予適當的許可。
Set-AWSCredentials ` –AccessKeyaccess-key-name` –SecretKeysecret-key-name -
執行以下命令,以設定 PowerShell 工作階段的區域。此範例會使用美國東部 (俄亥俄) 區域 (US-east-2)。
Set-DefaultAWSRegion ` -Region us-east-2 -
執行以下命令,將政策新增至現有參數。將每個
範例資源預留位置取代為您自己的資訊。Write-SSMParameter ` -Name "parameter name" ` -Value "parameter value" ` -Type "parameter type" ` -Policies "[{policies-enclosed-in-brackets-and-curly-braces}]" ` -Overwrite下列範例包含過期政策,該政策會在 2020 年 5 月 13 日午夜 (GMT) 刪除 參數。此範例也包含通知政策,該政策會在參數被刪除的五 (5) 天以前產生 EventBridge 事件。最後,它包含
NoChangeNotification政策,如果 60 天之後該參數沒有變更。此範例使用名為 的參數,/myapp/prod/vendor/merchant-id並以商家 ID 做為加密值和 AWS 受管金鑰。Write-SSMParameter ` -Name "/myapp/prod/vendor/merchant-id" ` -Value "merchant-739482" ` -Type "SecureString" ` -Policies "[{\"Type\":\"Expiration\",\"Version\":\"1.0\",\"Attributes\":{\"Timestamp\":\"2018-05-13T00:00:00.000Z\"}},{\"Type\":\"ExpirationNotification\",\"Version\":\"1.0\",\"Attributes\":{\"Before\":\"5\",\"Unit\":\"Days\"}},{\"Type\":\"NoChangeNotification\",\"Version\":\"1.0\",\"Attributes\":{\"After\":\"60\",\"Unit\":\"Days\"}}]" ` -Overwrite -
執行以下命令,以驗證參數的詳細資訊。將
參數名稱取代為您自己的資訊。(Get-SSMParameterValue -Name "parameter name").Parameters
重要
-
Parameter Store 會保留參數的政策,直到您用新的政策覆寫該政策或將其移除。
-
若要從現有參數中移除所有的政策,請編輯該參數,並套用由括弧和大括號組成的空白政策。例如:
Write-SSMParameter ` -Name "parameter name" ` -Value "parameter value" ` -Type "parameter type" ` -Policies "[{}]" -
如果您將新政策新增至已經有政策的參數,則 Systems Manager 會覆寫連接到該參數的政策。現有的政策會被刪除。如果您想要將政策新增至已經有一個或多個政策的參數,則複製並貼上原有的政策,輸入新的政策,然後儲存您的變更。