翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# コンテナ製品の Amazon SNS 通知
通知を受け取るには、製品の作成時に AWS Marketplace 提供される の Amazon Simple Notification Service (Amazon SNS) トピックをサブスクライブできます。このトピックでは、製品の顧客のサブスクリプションの変更に関する通知が提供されます。例えば、これらの通知を使用すると、顧客がプライベートオファーを承諾した時期を知ることができます。
**注記**
製品作成プロセス中に、製品の Amazon SNS トピックが作成されます。通知をサブスクライブするには、Amazon SNS トピックの Amazon リソースネーム (ARN) が必要です (例: `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE`)。ARN は、サーバー製品の販売者ポータルでは使用できません。ARN をリクエストするには、[AWS Marketplace オペレーションチーム](https://aws.amazon.com/marketplace/management/contact-us)にお問い合わせください。
次の Amazon SNS トピックはコンテナ製品で使用できます。
+ [Amazon SNS トピック: `aws-mp-subscription-notification`](#container-sns-subscription-message-body) - このトピックは、購入者が製品をサブスクライブまたはサブスクライブを解除した時に通知します。これは、時間単位や長期の時間単位を含む時間単位の料金モデルで利用できます。
## Amazon SNS トピック: `aws-mp-subscription-notification`
`aws-mp-subscription-notification` トピック内の各メッセージの形式は次のとおりです。
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
"offer-identifier": "offer-abcexample123"
}
```
** は、通知によって異なります。指定できるアクションは以下のとおりです。
+ `subscribe-success`
+ `subscribe-fail`
+ `unsubscribe-pending`
+ `unsubscribe-success`
アクションが `subscribe-success` または `subscribe-fail` の場合にのみ、`offer-identifier` は通知に含まれます。アクションが `unsubscribe-pending` または `unsubscribe-success` の場合、通知には含まれません。2024 年 1 月より前に作成されたオファーの場合、この識別子はプライベートオファーの通知にのみ含まれます。2024 年 1 月以降に作成されたオファーの場合、この識別子はプライベートオファーとパブリックオファーの両方を含むすべてのオファーの通知に含まれます。
オファータイプの詳細については、[DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) からのレスポンスまたは[契約更新ダッシュボード](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) の場合、そのオファーのターゲットルールのファセットをターゲットとする がアカウント AWS アカウント で見つかった場合、これはプライベートオファーです。そのオファーのターゲットルールのファセットをターゲットとする が AWS アカウント アカウントにない場合は、パブリックオファーです。
## Amazon SNS トピックへ Amazon SQS キューをサブスクライブする
Amazon SQS キューを指定された SNS トピックにサブスクライブすることを推奨します。SQS キューを作成し、そのキューをトピックにサブスクライブする方法の詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「[Amazon SNS トピックへ Amazon SQS キューをサブスクライブする](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 に保存されます。継続的にキューをポーリングし、メッセージを探して必要に応じて処理するサービスを定義する必要があります。