本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `AWS-EnableSNSTopicDeliveryStatusLogging`
<a name="aws-enable-sns-topic-delivery-status-logging"></a>

 **Description** 

 `AWS-EnableSNSTopicDeliveryStatusLogging` Runbook 會設定 `HTTP`、Amazon Data Firehose、Lambda`Platform application`、 或 Amazon Simple Queue Service (Amazon SQS) 端點的交付狀態記錄。這可讓 Amazon SNS 將失敗的提醒和成功提醒通知的範例百分比記錄到 Amazon CloudWatch。如果已針對主題設定交付狀態記錄，則 Runbook 會將現有的組態取代為您為輸入參數指定的新值。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-EnableSNSTopicDeliveryStatusLogging) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 的使用者許可。
+ EndpointType

  類型：字串

  有效值：
  + HTTP
  + Firehose
  + Lambda
  + 應用程式
  + SQS

  描述：（必要） 您要記錄交付狀態通知訊息的 Amazon SNS 主題端點類型。
+ TopicArn

  類型：字串

  描述：（必要） 您要為其設定交付狀態記錄之 Amazon SNS 主題的 ARN。
+ SuccessFeedbackRoleArn

  類型：字串

  描述：（必要） Amazon SNS 用來將日誌成功通知訊息傳送至 CloudWatch 的 IAM 角色 ARN。
+ SuccessFeedbackSampleRate

  類型：字串

  有效值：0-100

  描述：（必要） 指定 Amazon SNS 主題要取樣的成功訊息百分比。
+ FailureFeedbackRoleArn

  類型：字串

  描述：（必要） Amazon SNS 用來將失敗通知訊息日誌傳送至 CloudWatch 的 IAM 角色 ARN。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `iam:PassRole` 
+  `sns:GetTopicAttributes` 
+  `sns:SetTopicAttributes` 

 **文件步驟** 
+  `aws:executeAwsApi` - 將 `SuccessFeedbackRoleArn` 參數的值套用至 Amazon SNS 主題。
+  `aws:executeAwsApi` - 將 `SuccessFeedbackSampleRate` 參數的值套用至 Amazon SNS 主題。
+  `aws:executeAwsApi` - 將 `FailureFeedbackRoleArn` 參數的值套用至 Amazon SNS 主題。
+  `aws:executeScript` - 確認已在 Amazon SNS 主題上啟用交付狀態記錄。

 **輸出** 

VerifyDeliveryStatusLoggingEnabled.GetTopicAttributesResponse - `GetTopicAttributes` API 操作的回應。

VerifyDeliveryStatusLoggingEnabled.VerifyDeliveryStatusLoggingEnabled - 指出成功驗證交付狀態記錄的訊息。