기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

 AWS Systems Manager Automation은 Amazon Simple Notification Service에 사전 정의된 실행서를 제공합니다. 실행서에 대한 자세한 내용은 [실행서 작업](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)을 참조하세요. 실행서 콘텐츠를 보는 방법에 대한 자세한 내용은 [실행서 콘텐츠 보기](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>

 **설명** 

 `AWS-EnableSNSTopicDeliveryStatusLogging` 실행서는 `HTTP`, Amazon Data Firehose, Lambda, `Platform application`또는 Amazon Simple Queue Service(Amazon SQS) 엔드포인트에 대한 전송 상태 로깅을 구성합니다. 이를 통해 Amazon SNS는 실패한 알림과 성공한 알림의 샘플 비율을 Amazon CloudWatch에 로깅할 수 있습니다. 주제에 대한 전송 상태 로깅이 이미 구성된 경우 실행서는 기존 구성을 입력 파라미터에 지정한 새 값으로 바꿉니다.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-EnableSNSTopicDeliveryStatusLogging) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ EndpointType

  유형: 문자열

  유효한 값:
  + HTTP
  + Firehose
  + Lambda
  + 애플리케이션
  + SQS

  설명: (필수) 전송 상태 알림 메시지를 로깅하려는 Amazon SNS 주제 엔드포인트의 유형입니다.
+ TopicArn

  유형: 문자열

  설명: (필수) 전송 상태 로깅을 구성하려는 Amazon SNS 주제의 ARN입니다.
+ SuccessFeedbackRoleArn

  유형: 문자열

  설명: (필수) Amazon SNS가 CloudWatch에 성공한 알림 메시지에 대한 로그를 보내는 데 사용하는 IAM 역할의 ARN입니다.
+ SuccessFeedbackSampleRate

  유형: 문자열

  유효한 값: 0\$1100

  설명: (필수) 지정된 Amazon SNS 주제에 대해 샘플링할 성공 메시지의 백분율입니다.
+ FailureFeedbackRoleArn

  유형: 문자열

  설명: (필수) Amazon SNS가 실패 알림 메시지에 대한 로그를 CloudWatch로 전송하는 데 사용하는 IAM 역할의 ARN입니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `iam:PassRole` 
+  `sns:GetTopicAttributes` 
+  `sns:SetTopicAttributes` 

 **문서 단계** 
+  `aws:executeAwsApi` - Amazon SNS 주제에 `SuccessFeedbackRoleArn` 파라미터 값을 적용합니다.
+  `aws:executeAwsApi` - Amazon SNS 주제에 `SuccessFeedbackSampleRate` 파라미터 값을 적용합니다.
+  `aws:executeAwsApi` - Amazon SNS 주제에 `FailureFeedbackRoleArn` 파라미터 값을 적용합니다.
+  `aws:executeScript` - Amazon SNS 주제에서 전송 상태 로깅이 활성화되었는지 확인합니다.

 **출력** 

VerifyDeliveryStatusLoggingEnabled.GetTopicAttributesResponse - `GetTopicAttributes` API 작업의 응답입니다.

VerifyDeliveryStatusLoggingEnabled.VerifyDeliveryStatusLoggingEnabled - 전송 상태 로깅의 성공적인 확인을 나타내는 메시지입니다.

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

 **설명** 

 `AWSConfigRemediation-EncryptSNSTopic` 실행서는 AWS Key Management Service () 고객 관리형 키를 사용하여 지정한 Amazon Simple Notification Service(Amazon SNS AWS KMS) 주제에 대한 암호화를 활성화합니다. 이 실행서는 Amazon SNS 주제가 최소 권장 보안 모범 사례에 따라 암호화되도록 하기 위한 기준으로만 사용해야 합니다. 다양한 고객 관리형 키를 사용하여 여러 주제를 암호화하는 것이 좋습니다.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-EncryptSNSTopic) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

  설명: (필수) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다.
+ KmsKeyArn

  유형: 문자열

  설명: (필수) Amazon SNS 주제를 암호화하는 데 사용하려는 AWS KMS 고객 관리형 키의 Amazon 리소스 이름(ARN)입니다.
+ TopicArn

  유형: 문자열

  설명: (필수) 암호화하려는 Amazon SNS 주제의 ARN입니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+  `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>

 **설명** 

Amazon SNS에 알림을 게시합니다.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-PublishSNSNotification) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ 메시지

  유형: 문자열

  설명: (필수) SNS 알림에 포함할 메시지입니다.
+ TopicArn

  유형: 문자열

  설명: (필수) 알림을 게시할 SNS 주제의 ARN입니다.