

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# での AMI 製品の Amazon SNS 通知の受信 AWS Marketplace
<a name="ami-notification"></a>

製品のカスタマーサブスクリプションの変更に関する通知を受け取るには、製品の作成時に AWS Marketplace 提供される の Amazon Simple Notification Service (Amazon SNS) トピックをサブスクライブできます。例えば、顧客がプライベートオファーを承認するタイミングがわかります。[Amazon SNS トピック: aws-mp-subscription-notification](#ami-sns-subscription-message-body) は、AMI 製品で使用できる 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)にお問い合わせください。

**Topics**
+ [Amazon SNS トピック: aws-mp-subscription-notification](#ami-sns-subscription-message-body)
+ [Amazon SNS トピックへ Amazon SQS キューをサブスクライブする](#subscribing-an-sqs-queue-to-an-sns-topic)

## Amazon SNS トピック: aws-mp-subscription-notification
<a name="ami-sns-subscription-message-body"></a>

`aws-mp-subscription-notification` トピック内の `subscribe-success` および `subscribe-fail` アクションのメッセージは、それぞれ次の形式になっています。

```
{
    "action": "action-name",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
    "offer-identifier": "offer-abcexample123"
}
```

*<action-name>* は、通知によって異なります。指定できるアクションは以下のとおりです。
+ `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 キューをサブスクライブする
<a name="subscribing-an-sqs-queue-to-an-sns-topic"></a>

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 キューのポーリング
<a name="polling-an-sqs-for-notifications"></a>

SQS キューを SNS トピックにサブスクライブすると、メッセージは SQS に保存されます。継続的にキューをポーリングし、メッセージを探して必要に応じて処理するサービスを定義する必要があります。