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

FIFO 주제 소유자의 메시지 아카이브

메시지 아카이브 기능을 통해 주제에 게시된 모든 메시지의 단일 사본을 아카이브할 수 있습니다. 주제에 대한 메시지 아카이브 정책을 활성화하여 게시된 메시지를 주제 내에 저장할 수 있습니다. 그러면 해당 주제에 연결된 모든 구독의 메시지를 아카이브할 수 있습니다. 메시지는 최소 1일에서 최대 365일 동안 아카이브될 수 있습니다.

아카이브 정책을 설정하면 추가 요금이 부과됩니다. 요금 정보는 Amazon SNS 요금을 참조하세요.

AWS Management Console을 사용하여 메시지 아카이브 정책 생성

메시지 아카이브 주제 정책을 확인, 편집 및 비활성화하려면

API를 사용하여 메시지 아카이브 정책 생성

API를 사용하여 메시지 아카이브 정책을 생성하려면 주제에 ArchivePolicy 속성을 추가해야 합니다. API 작업 CreateTopic 및 SetTopicAttributes를 사용하여 ArchivePolicy를 설정할 수 있습니다. ArchivePolicy에는 Amazon SNS가 메시지를 보관하는 일수를 나타내는 단일 값인 MessageRetentionPeriod가 있습니다. 주제에 대한 메시지 아카이브를 활성화하려면 MessageRetentionPeriod를 0보다 큰 정수 값으로 설정합니다. 예를 들어 아카이브에서 메시지를 30일 동안 보존하려면 ArchivePolicy를 다음과 같이 설정합니다.

{
    "ArchivePolicy": {
        "MessageRetentionPeriod": "30"
    }
}

주제에 대한 메시지 아카이브를 비활성화하고 아카이브를 지우려면 다음과 같이 ArchivePolicy 설정을 해제합니다.

{}

SDK를 사용하여 메시지 아카이브 정책 생성

AWS SDK를 사용하려면 자격 증명을 사용하여 구성해야 합니다. 자세한 정보는 AWS SDK 및 도구 참조 가이드의 공유 config 및 credentials 파일을 참조하세요.

다음 코드 예시에서는 해당 주제에 게시된 모든 메시지를 30일 동안 보존하도록 Amazon SNS 주제에 ArchivePolicy를 설정하는 방법을 보여줍니다.

// Specify the ARN of the Amazon SNS topic to set the ArchivePolicy for.
String topicArn =
    "arn:aws:sns:us-east-2:123456789012:MyArchiveTopic.fifo";

// Set the MessageRetentionPeriod to 30 days for the ArchivePolicy.
String archivePolicy =
    "{\"MessageRetentionPeriod\":\"30\"}";

// Set the ArchivePolicy for the Amazon SNS topic
SetTopicAttributesRequest request = new SetTopicAttributesRequest()
    .withTopicArn(topicArn)
    .withAttributeName("ArchivePolicy")
    .withAttributeValue(archivePolicy);
sns.setTopicAttributes(request);

AWS CloudFormation을 사용하여 메시지 아카이브 정책 생성

AWS CloudFormation을 사용하여 아카이브 정책을 생성하려면 AWS CloudFormation 사용 설명서의 AWS::SNS::Topic 섹션을 참조하세요.

암호화된 아카이브에 대한 액세스 권한 부여

구독자가 암호화된 주제에서 메시지 재생을 시작할 수 있도록 하려면 먼저 다음 단계를 완료해야 합니다. 이전 메시지가 재생되므로 아카이브의 메시지를 암호화하는 데 사용된 KMS 키에 대한 Decrypt 액세스 권한을 Amazon SNS에 프로비저닝해야 합니다.

Amazon SNS에 암호 해독 권한 부여

Amazon SNS가 주제 아카이브 내에서 암호화된 메시지에 액세스하고 이를 구독한 엔드포인트에 재생하려면 Amazon SNS 서비스 보안 주체를 활성화하여 이러한 메시지를 해독해야 합니다.

다음은 주제 내에서 이전 메시지를 재생하는 동안 Amazon SNS 서비스 보안 주체가 저장된 메시지를 해독하도록 허용하는 데 필요한 정책의 예입니다.

{
    "Sid": "Allow SNS to decrypt archived messages",
    "Effect": "Allow",
    "Principal": {
        "Service": "sns.amazonaws.com"
    },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
    ],
    "Resource": "*"
}

Amazon CloudWatch를 사용하여 메시지 아카이브 지표 모니터링

Amazon CloudWatch에서 다음 지표를 사용하여 아카이브된 메시지를 모니터링할 수 있습니다. 워크로드의 이상 현상에 대한 알림을 받고 관련 영향을 방지하기 위해 이러한 지표에 Amazon CloudWatch 경보를 구성할 수 있습니다. 자세한 내용은 Amazon SNS의 로깅 및 모니터링을(를) 참조하십시오.

GetTopicAttributes API에는 구독자가 재생을 시작할 수 있는 가장 오래된 타임스탬프를 나타내는 BeginningArchiveTime 속성이 있습니다. 다음은 이 API 작업에 대한 샘플 응답입니다.

{
 "ArchivePolicy": {
    "MessageRetentionPeriod": "<integer>"
  },
  "BeginningArchiveTime": "<timestamp>",
  ...
}