本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # SNS \$1 更新 （受管自動化） 修改現有 Amazon Simple Notification Service (SNS) 主題的屬性。 **完整分類：**管理 \$1 監控和通知 \$1 SNS \$1 更新 （受管自動化） ## 變更類型詳細資訊 **** | | | | --- |--- | | 變更類型 ID | ct-0zzf0fjz76jmb | | 目前版本 | 1.0 | | 預期的執行持續時間 | 240 分鐘 | | AWS 核准 | 必要 | | 客戶核准 | 如果提交者則不需要 | | 執行模式 | 手動 | ## 其他資訊 ### 更新 SNS 主題 #### 使用主控台更新 SNS 主題 AMS 主控台中此變更類型的螢幕擷取畫面： ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/managedservices/latest/ctref/images/guiSnsUpdateCT.png) 運作方式： 1. 導覽至**建立 RFC** 頁面：在 AMS 主控台的左側導覽窗格中，按一下 **RFCs**以開啟 RFCs清單頁面，然後按一下**建立 RFC**。 1. 在預設的**瀏覽變更類型檢視中選擇熱門的變更類型** (CT)，或在**依類別**選擇檢視中選擇 CT。 + **依變更類型瀏覽**：您可以在**快速建立**區域中按一下熱門的 CT，以立即開啟**執行 RFC** 頁面。請注意，您無法透過快速建立選擇較舊的 CT 版本。 若要排序 CTs，請使用**卡片**或**資料表**檢視中的所有**變更類型**區域。在任一檢視中，選取 CT，然後按一下**建立 RFC** 以開啟**執行 RFC** 頁面。如果適用，**建立舊版**選項會顯示在**建立 RFC** 按鈕旁。 + **依類別選擇**：選取類別、子類別、項目和操作，如果適用，CT 詳細資訊方塊會開啟，其中包含**使用較舊版本建立**的選項。按一下**建立 RFC** 以開啟**執行 RFC** 頁面。 1. 在**執行 RFC** 頁面上，開啟 CT 名稱區域以查看 CT 詳細資訊方塊。需要**主旨** （如果您在**瀏覽變更類型**檢視中選擇 CT，則會為您填寫）。開啟**其他組態**區域以新增 RFC 的相關資訊。 在**執行組態**區域中，使用可用的下拉式清單或輸入必要參數的值。若要設定選用的執行參數，請開啟**其他組態**區域。 1. 完成後，請按一下**執行**。如果沒有錯誤，**RFC 成功建立**的頁面會顯示已提交的 RFC 詳細資訊，以及初始的**執行輸出**。 1. 開啟**執行參數**區域以查看您提交的組態。重新整理頁面以更新 RFC 執行狀態。或者，取消 RFC 或使用頁面頂端的選項建立 RFC 的副本。 #### 使用 CLI 更新 SNS 主題 運作方式： 1. 使用內嵌建立 （您發出包含所有 RFC 和執行參數的`create-rfc`命令） 或範本建立 （您建立兩個 JSON 檔案，一個用於 RFC 參數，另一個用於執行參數），並使用兩個檔案作為輸入發出`create-rfc`命令。此處說明這兩種方法。 1. 使用傳回的 RFC ID 提交 RFC： `aws amscm submit-rfc --rfc-id ID`命令。 監控 RFC： `aws amscm get-rfc --rfc-id ID`命令。 若要檢查變更類型版本，請使用下列命令： ``` aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID ``` **注意** 您可以將任何`CreateRfc`參數與任何 RFC 搭配使用，無論它們是否為變更類型結構描述的一部分。例如，若要在 RFC 狀態變更時取得通知，請將此行新增至請求的 `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` RFC 參數部分 （而非執行參數）。如需所有 CreateRfc 參數的清單，請參閱 [AMS 變更管理 API 參考](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html)。 *INLINE CREATE* （最小參數）： 使用內嵌提供的執行參數發出建立 RFC 命令 （在內嵌提供執行參數時逸出引號），然後提交傳回的 RFC ID。例如，您可以將內容取代為如下內容： ``` aws amscm create-rfc --change-type-id "ct-0zzf0fjz76jmb" --change-type-version "1.0" --title "Update SNS Topic" --execution-parameters "{\"TopicArn\": \"arn:aws:sns:us-east-1:123456789101:My-SNS-Topic\", \"Priority\": \"Medium\", \"Parameters\": {\"DisplayName\": \"My-SNS-Topic\", \"KmsMasterKeyId\": \"arn:aws:kms:us-east-1:123456789101:key/cfe0542d-3be9-4166-9eac-d0cd6af61445\"}}" ``` *範本 CREATE* （所有參數）： 1. 將此變更類型的執行參數 JSON 結構描述輸出至檔案；此範例將其命名為 SnsUpdateParams.json. ``` aws amscm get-change-type-version --change-type-id "ct-3rcl9u1k017wu" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > SnsUpdateParams.json ``` 1. 修改並儲存 SnsUpdateParams 檔案。例如，您可以將內容取代為如下內容： ``` { "TopicArn": "arn:aws:sns:us-east-1:123456789101:Test-Stack", "Parameters": { "DisplayName": "My-Test-Stack", "DeliveryPolicy": "{\"http\":{\"defaultHealthyRetryPolicy\":{\"minDelayTarget\":20,\"maxDelayTarget\":20,\"numRetries\":3,\"numMaxDelayRetries\":0,\"numNoDelayRetries\":0,\"numMinDelayRetries\":0,\"backoffFunction\":\"linear\"},\"disableSubscriptionOverrides\":false,\"defaultRequestPolicy\":{\"headerContentType\":\"text/plain; charset=UTF-8\"}}}", "DataProtectionPolicy": "{\"Name\":\"__example_data_protection_policy\",\"Description\":\"Exampledataprotectionpolicy\",\"Version\":\"2021-06-01\",\"Statement\":[{\"DataDirection\":\"Inbound\",\"Principal\":[\"arn:aws:iam::123456789101:user/ExampleUser\"],\"DataIdentifier\":[\"arn:aws:dataprotection::aws:data-identifier/CreditCardNumber\"],\"Operation\":{\"Deidentify\":{\"MaskConfig\":{\"MaskWithCharacter\":\"#\"}}}}]}", "KmsMasterKeyARN": "arn:aws:kms:ap-southeast-2:123456789101:key/bb43bd18-3a75-482e-822d-d0d3a5544dc8", "TracingConfig": "Active" }, "Priority": "Medium" } ``` 1. 將 RFC 範本 JSON 檔案輸出至名為 SnsUpdateRfc.json: ``` aws amscm create-rfc --generate-cli-skeleton > SnsUpdateRfc.json ``` 1. 修改並儲存 SnsUpdateRfc.json 檔案。例如，您可以將內容取代為如下內容： ``` { "ChangeTypeVersion": "1.0", "ChangeTypeId": "ct-0zzf0fjz76jmb", "Title": "Update-SNS-RFC" } ``` 1. 建立 RFC，指定 SnsUpdate Rfc 檔案和 SnsUpdateParams 檔案： ``` aws amscm create-rfc --cli-input-json file://SnsUpdateRfc.json --execution-parameters file://SnsUpdateParams.json ``` 您會在回應中收到新 RFC 的 ID，並使用它來提交和監控 RFC。在您提交之前，RFC 會保持在編輯狀態，不會啟動。 #### 提示 若要進一步了解 AWS Simple Notification Service (SNS)，請參閱 [Amazon Simple Notification Service](https://aws.amazon.com/sns/)。另請參閱 [Amazon SNS 入門](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)。 ## 執行輸入參數 如需執行輸入參數的詳細資訊，請參閱 [變更類型的結構描述 ct-0zzf0fjz76jmb](schemas.md#ct-0zzf0fjz76jmb-schema-section)。 ## 範例：必要參數 ``` { "TopicArn": "arn:aws:sns:us-east-1:000000000000:Test-Stack" } ``` ## 範例：所有參數 ``` { "TopicArn": "arn:aws:sns:us-east-1:000000000000:Test-Stack", "Parameters":{ "DisplayName": "Test-Stack", "AddSubscriptions": [ { "Protocol": "http", "Endpoint": "http://example.com/webhook" }, { "Protocol": "https", "Endpoint": "https://example.com/webhook" }, { "Protocol": "email", "Endpoint": "test@example.com" }, { "Protocol": "email-json", "Endpoint": "test@example.com" }, { "Protocol": "sms", "Endpoint": "+1234567890" }, { "Protocol": "sqs", "Endpoint": "arn:aws:sqs:us-east-1:000000000000:TestQueue" }, { "Protocol": "application", "Endpoint": "arn:aws:sns:us-east-1:000000000000:endpoint/GCM/MyApplication" }, { "Protocol": "lambda", "Endpoint": "arn:aws:lambda:us-east-1:000000000000:function:TestFunction" }, { "Protocol": "firehose", "Endpoint": "arn:aws:firehose:us-east-1:000000000000:deliverystream/TestStream" } ], "RemoveSubscriptions": [ "arn:aws:sns:us-east-1:000000000000:Test-Stack:12345678-1234-1234-1234-123456789012" ], "DeliveryPolicy": "{\"http\":{\"defaultHealthyRetryPolicy\":{\"minDelayTarget\":20,\"maxDelayTarget\":20,\"numRetries\":3,\"numMaxDelayRetries\":0,\"numNoDelayRetries\":0,\"numMinDelayRetries\":0,\"backoffFunction\":\"linear\"},\"disableSubscriptionOverrides\":false,\"defaultRequestPolicy\":{\"headerContentType\":\"text/plain; charset=UTF-8\"}}}", "DataProtectionPolicy": "{\"Name\":\"__example_data_protection_policy\",\"Description\":\"Exampledataprotectionpolicy\",\"Version\":\"2021-06-01\",\"Statement\":[{\"DataDirection\":\"Inbound\",\"Principal\":[\"arn:aws:iam::123456789012:user/ExampleUser\"],\"DataIdentifier\":[\"arn:aws:dataprotection::aws:data-identifier/CreditCardNumber\"],\"Operation\":{\"Deidentify\":{\"MaskConfig\":{\"MaskWithCharacter\":\"#\"}}}}]}", "KmsMasterKeyARN": "arn:aws:kms:ap-southeast-2:123456789023:key/bb43bd18-3a75-482e-822d-d0d3a5544dc8", "TracingConfig": "Active" }, "Priority": "Medium" } ```