AWS-EnableSNSTopicDeliveryStatusLogging

설명

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

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

Linux, macOS, Windows

파라미터

• AutomationAssumeRole

  유형: 문자열

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

• EndpointType

  유형: 문자열

  유효 값:

  • HTTP

  • Firehose

  • Lambda

  • Application

  • 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 파라미터에 다음 작업이 필요합니다.

• 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 - 전송 상태 로깅의 성공적인 확인을 나타내는 메시지입니다.