SNS | 更新（需要檢閱） - AMS 進階變更類型參考

修改現有 Amazon Simple Notification Service (SNS) 主題的屬性。

完整分類：管理 | 監控和通知 | SNS | 更新（需要檢閱）

變更類型詳細資訊

變更類型 ID	ct-0zzf0fjz76jmb
目前版本	1.0
預期的執行持續時間	240 分鐘
AWS 核准	必要
客戶核准	如果提交者則不需要
執行模式	手動

運作方式：

使用內嵌建立（您發出包含所有 RFC 和執行參數的create-rfc命令）或範本建立（您建立兩個 JSON 檔案，一個用於 RFC 參數，另一個用於執行參數），並使用兩個檔案作為輸入發出create-rfc命令。此處說明這兩種方法。
使用傳回的 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 參考。

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 （所有參數）：

將此變更類型的執行參數 JSON 結構描述輸出至檔案；此範例將其命名為 SnsUpdateParams.json.


aws amscm get-change-type-version --change-type-id "ct-3rcl9u1k017wu" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > SnsUpdateParams.json

修改並儲存 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"
}

將 RFC 範本 JSON 檔案輸出至名為 SnsUpdateRfc.json:


aws amscm create-rfc --generate-cli-skeleton > SnsUpdateRfc.json

修改並儲存 SnsUpdateRfc.json 檔案。例如，您可以將內容取代為類似以下內容：


{
"ChangeTypeVersion":    "1.0",
"ChangeTypeId":         "ct-0zzf0fjz76jmb",
"Title":                "Update-SNS-RFC"
}

建立 RFC，指定 SnsUpdate Rfc 檔案和 SnsUpdateParams 檔案：
```
aws amscm create-rfc --cli-input-json file://SnsUpdateRfc.json  --execution-parameters file://SnsUpdateParams.json
```
您會在回應中收到新 RFC 的 ID，並且可以使用它來提交和監控 RFC。在您提交之前，RFC 會保持在編輯狀態，不會啟動。

如需執行輸入參數的詳細資訊，請參閱變更類型的結構描述 ct-0zzf0fjz76jmb。


{
  "TopicArn": "arn:aws:sns:us-east-1:000000000000:Test-Stack"
}


{

  "TopicArn": "arn:aws:sns:us-east-1:000000000000:Test-Stack",
  "Parameters":{
    "DisplayName": "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::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"
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

SNS | 訂閱 DirectCustomerAlerts

SQS | 更新

SNS | 更新 （需要檢閱）

變更類型詳細資訊

其他資訊

更新 SNS 主題

注意

執行輸入參數

範例：必要參數

範例：所有參數

SNS | 更新（需要檢閱）