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

# Amazon SNS
<a name="automation-ref-sns"></a>

 AWS Systems Manager 自動化為 Amazon Simple Notification Service 提供預先定義的 Runbook。如需有關執行手冊的詳細資訊，請參閱 [Working with runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)。如需如何檢視 Runbook 內容的詳細資訊，請參閱 [檢視 Runbook 內容](automation-runbook-reference.md#view-automation-json)。

**Topics**
+ [`AWS-EnableSNSTopicDeliveryStatusLogging`](aws-enable-sns-topic-delivery-status-logging.md)
+ [`AWSConfigRemediation-EncryptSNSTopic`](automation-aws-encrypt-sns-topic.md)
+ [`AWS-PublishSNSNotification`](automation-aws-publishsnsnotification.md)

# `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 - 指出成功驗證交付狀態記錄的訊息。

# `AWSConfigRemediation-EncryptSNSTopic`
<a name="automation-aws-encrypt-sns-topic"></a>

 **Description** 

 `AWSConfigRemediation-EncryptSNSTopic` Runbook 會在您使用 () 客戶受管金鑰指定的 Amazon Simple Notification Service AWS Key Management Service (Amazon SNS AWS KMS) 主題上啟用加密。此 Runbook 應僅用作基準，以確保您的 Amazon SNS 主題根據最低建議的安全最佳實務進行加密。我們建議使用不同的客戶受管金鑰加密多個主題。

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

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（必要） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。
+ KmsKeyArn

  類型：字串

  描述：（必要） 您要用來加密 Amazon SNS 主題之客戶受管金鑰的 AWS KMS Amazon Resource Name (ARN)。 Amazon SNS 
+ TopicArn

  類型：字串

  描述：（必要） 您要加密之 Amazon SNS 主題的 ARN。

**必要的 IAM 許可**

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

 **文件步驟** 
+  `aws:executeAwsApi` - 加密您在 `TopicArn` 參數中指定的 Amazon SNS 主題。
+  `aws:assertAwsResourceProperty` - 確認加密已在 Amazon SNS 主題上啟用。

# `AWS-PublishSNSNotification`
<a name="automation-aws-publishsnsnotification"></a>

 **Description** 

發佈通知至 Amazon SNS。

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

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

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

  類型：字串

  描述：(必要) 要包含在 SNS 通知的訊息。
+ TopicArn

  類型：字串

  描述：(必要) 要發佈通知之 SNS 主題的 ARN。