기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# SaaS 제품에 대한 Amazon SNS 알림
**중요**
AWS Marketplace SaaS 제품에 대한 SNS 알림이 Amazon EventBridge 알림으로 대체되고 있습니다. SNS와 통합된 기존 SaaS 제품이 있는 경우 해당 제품은 계속 작동합니다. 새 목록은 결국 SNS 대신 Amazon EventBridge 사용으로 전환됩니다. 자세한 내용은 [Amazon EventBridge를 사용하여 SaaS 구독 이벤트 관리](saas-eventbridge-integration.md) 단원을 참조하십시오.
알림을 받으려면 제품 생성 중에 AWS Marketplace 제공된에 대한 Amazon Simple Notification Service(Amazon SNS) 주제를 구독합니다. 이 주제는 고객의 제품 구독 및 계약 권한 변경 사항에 대한 알림을 제공합니다. 이를 통해 특정 고객에 대한 액세스가 제공 및 취소된 시기를 알 수 있습니다.
**참고**
판매자는 제품 생성 프로세스 중에 SNS 주제에 대한 실제 Amazon 리소스 이름(ARN)을 받게 됩니다. 예: `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE`
서비스형 소프트웨어(SaaS) 제품에 제공되는 Amazon SNS 주제는 다음과 같습니다.
+ [Amazon SNS 주제: `aws-mp-entitlement-notification`](#saas-sns-message-body) - 이 주제는 구매자가 새 계약을 생성하거나, 기존 계약을 업그레이드 또는 갱신하거나, 계약이 만료될 때 알림을 제공합니다. 계약(**SaaS 계약** 및 **소비가 포함된 SaaS 계약(초과분)**이라고도 함)이 포함된 요금 모델을 사용하는 제품에만 제공됩니다.
+ [Amazon SNS 주제: `aws-mp-subscription-notification`](#saas-sns-subscription-message-body) - 이 주제는 구매자가 제품을 구독하거나 구독 해지할 때 알림을 제공하며, 비공개 제안의 `offer-identifier` 및 SaaS 무료 평가판의 무료 평가판 플래그를 포함하고 있습니다. 계약 및 구독(**SaaS 구독**, **SaaS 계약** 및 **소비가 포함된 SaaS 계약(초과분)**이라고도 함)을 포함한 모든 요금 모델에 제공됩니다.
이러한 알림에 응답하는 시나리오에 대한 자세한 내용은 다음 주제를 참조하세요.
+ [SaaS 구독 또는 Pay-As-You-Go 제품을와 통합 AWS Marketplace](saas-integrate-subscription.md)
+ [SaaS 계약 제품을와 통합 AWS Marketplace](saas-integrate-contract.md)
+ [SaaS 계약 기반 제품을와 통합 AWS Marketplace](saas-integrate-contract-with-pay.md)
## Amazon SNS 주제: `aws-mp-entitlement-notification`
`aws-mp-entitlement-notification` 주제의 각 메시지는 다음과 같은 형식입니다.
```
{
"action": "{{}}",
"customer-identifier": " {{X01EXAMPLEX}}",
"product-code": "{{n0123EXAMPLEXXXXXXXXXXXX}}",
}
```
{{}}은 항상 ` entitlement-updated`입니다.
**참고**
권한 메시지의 경우 작업(신규, 업그레이드, 갱신 또는 만료)에 관계없이 메시지는 동일합니다. 업데이트 내용을 검색하려면 후속 `GetEntitlement` 호출이 필요합니다.
**소비가 포함된 SaaS 계약(초과분)**의 경우 판매자에게 [`aws-mp-subscription-notification` SNS 주제](#saas-sns-subscription-message-body)가 제공됩니다. 판매자가 초과 요금을 추가할 때 받게 되는 추가 알림입니다. 판매자는 `entitlement-updated`만 얻는 대신 신규 고객을 확보하면(모든 종류의 조치를 의미할 수 있음) 고객이 신규 고객이라는 것을 알리는 구독 메시지를 받게 됩니다.
미래 날짜의 계약(FDA)의 경우 이 주제는 계약 시작 날짜(계약 서명 날짜가 아님)에 시작됩니다. 또한 계약의 취소, 교체, 갱신 또는 만료와 같은 권한에 후속 변경 사항이 발생할 때 시작됩니다.
계약 가격이 적용되는 제품(사용한 만큼만 지불 요금이 적용되는 계약 포함)은 이러한 메시지에 응답해야 합니다. 응답 방법에 대한 자세한 내용은 [시나리오: 사용자 구독 변경 사항 모니터링](saas-integrate-contract.md#saas-contract-monitor-changes) 섹션을 참조하세요.
## Amazon SNS 주제: `aws-mp-subscription-notification`
`aws-mp-subscription-notification` 주제의 각 메시지는 다음과 같은 형식입니다.
```
{
"action": "{{}}",
"customer-identifier": " {{X01EXAMPLEX}}",
"product-code": "{{n0123EXAMPLEXXXXXXXXXXXX}}",
"offer-identifier": "{{offer-abcexample123}}",
"isFreeTrialTermPresent":"true"
}
```
`offer-identifier`는 작업이 `subscribe-success` 또는 `subscribe-fail`인 경우에만 알림에 포함됩니다. 작업이 `unsubscribe-pending` 또는 `unsubscribe-success`일 때는 알림에 포함되지 않습니다. 2024년 1월 이전에 생성된 제안의 경우, 이 식별자는 비공개 제안에 대한 알림에만 포함됩니다. 2024년 1월 및 그 이후에 생성된 제안의 경우, 이 식별자는 비공개 제안 및 공개 제안을 포함한 모든 제안에 대한 알림에 포함됩니다.
제안 유형에 대한 자세한 내용은 [계약 갱신 대시보드](https://docs.aws.amazon.com//marketplace/latest/userguide/agreements-renewals-dashboard.html)에서 [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity)의 응답 또는 계약의 제안 표시 여부를 참조하세요.
**참고**
[DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity)의 경우 해당 제안에 대한 대상 지정 규칙의 패싯을 대상으로 하는를 계정 AWS 계정 에서 찾으면 비공개 제안입니다. 해당 제안 AWS 계정 에 대한 대상 지정 규칙의 패싯을 대상으로 하는가 계정에 없는 경우 공개 제안입니다.
`isFreeTrialTermPresent` 속성 정보는 구매자의 구독이 무료 평가판인지 여부를 나타냅니다. 이 속성의 JSON 값은 *부울* 데이터 유형이 아닙니다. 그 대신 값이 *문자열* 데이터 유형으로 변환됩니다. 자세한 내용은 [ SaaS 무료 평가판](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html)을 참조하세요.
{{}}은 알림에 따라 달라집니다. 가능한 작업은 다음과 같습니다.
+ `subscribe-success` - 판매자가 측정 기록을 전송할 수 있게 되면 `subscribe-success` 메시지가 그 사실을 알려줍니다. 구매자가 [계약 기반 제안](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html#private-offers-upgrades-and-renewals-process)을 수락하면 이 메시지가 새 `offer-identifier`와 함께 다시 전송됩니다.
+ `subscribe-fail` - `subscribe-fail` 메시지가 생성되면 구매자가 이미에서 AWS Marketplace 판매자의 SaaS 랜딩 페이지로 전환했더라도 결제가 실패했을 수 있습니다. 판매자는 `subscribe-success` 메시지를 기다렸다가 제품 사용을 허용해야 합니다.
+ `unsubscribe-pending` - 구매자가 구독을 해지하면 가장 먼저 `unsubscribe-pending` 메시지가 전송됩니다. 구독이 완전히 취소되기 전까지 제한된 시간(약 1시간) 동안 판매자가 최종 측정 기록을 받을 수 있음을 나타냅니다.
+ `unsubscribe-success` - `unsubscribe-success`는 취소 완료를 알리는 메시지이며, 취소 완료 후에는 더 이상 측정 기록이 수락되지 않습니다.
**참고**
구매자가 구독을 해지한 후 최종 `unsubscribe-success` 메시지가 전송되기 전에 즉시 다시 구독하면 최종 `unsubscribe-success` 메시지가 전송되지 않고 `subscribe-success` 메시지가 대신 전송됩니다.
미래 날짜의 계약(FDA)의 경우 `subscribe-success` 작업은 계약 시작 날짜(계약 서명 날짜가 아님)에 시작됩니다.
구독 요금이 적용되는 제품(사용한 만큼만 지불 요금이 적용되는 계약 포함)은 이러한 메시지에 응답해야 합니다. 응답 방법에 대한 자세한 내용은 다음 주제를 참조하세요.
+ [SaaS 구독 또는 Pay-As-You-Go 제품을와 통합 AWS Marketplace](saas-integrate-subscription.md)
+ [SaaS 계약 기반 제품을와 통합 AWS Marketplace](saas-integrate-contract-with-pay.md)
## SNS 주제에 대한 SQS 대기열 구독
Amazon SQS 대기열을 제공된 SNS 주제에 구독하는 것이 좋습니다. SQS 대기열을 생성하고 대기열을 주제에 구독하는 방법에 대한 자세한 지침은 *Amazon Simple Notification Service 개발자 안내서*의 [ Amazon SQS 대기열을 Amazon SNS 주제에 구독](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html)을 참조하세요.
**참고**
제품을 판매하는 데 AWS 계정 사용되는 에서만 AWS Marketplace SNS 주제를 구독할 수 있습니다. 하지만 메시지를 다른 계정에 전달할 수 있습니다. 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [다른 계정의 Amazon SQS 대기열로 Amazon SNS 메시지 전송](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html)을 참조하세요.
### 알림을 위한 SQS 대기열 폴링
SQS 대기열을 SNS 주제에 구독하면 메시지가 SQS에 저장됩니다. 대기열을 지속적으로 폴링하는 서비스를 정의하고, 메시지를 찾고, 그에 따라 메시지를 처리해야 합니다.