本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 容器 产品的 Amazon SNS 通知
<a name="container-notification"></a>

要接收通知，您可以订阅商品创建期间向您提供的亚马逊简单通知服务 (Amazon SNS) Simple Notification Service 主题 AWS Marketplace 。这些主题提供有关客户产品订阅发生更改的通知。例如，您可以通过这些通知了解客户何时接受专属报价。

**注意**  
在产品创建过程中，会为您的产品创建一个 Amazon SNS 主题。要订阅通知，您需要 Amazon SNS 主题的 Amazon 资源名称（ARN）（例如 `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE`）。服务器产品的卖家门户中没有该 ARN。请联系 [AWS Marketplace 运营团队](https://aws.amazon.com/marketplace/management/contact-us)请求该 ARN。

以下 Amazon SNS 主题适用于容器产品：
+ [Amazon SNS 主题：`aws-mp-subscription-notification`](#container-sns-subscription-message-body) – 当买家订阅或取消订阅产品时，此主题会向您发送通知。此通知适用于按小时定价模式，包括长期按小时定价模式和按年计费模式。

## Amazon SNS 主题：`aws-mp-subscription-notification`
<a name="container-sns-subscription-message-body"></a>

`aws-mp-subscription-notification` 主题中的每条消息都采用以下格式。

```
{
    "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 SQS 队列订阅 Amazon SNS 主题
<a name="subscribing-sqs-queue-to-sns-topic"></a>

我们建议为 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 SNS 消息发送到不同账户的 Amazon SQS 队列](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html)。

### 轮询 SQS 队列以获取通知
<a name="polling-the-sqs-for-notifications"></a>

在您的 SQS 队列订阅 SNS 主题后，消息将存储在 SQS 中。您需要定义一项服务，以不断轮询该队列，查找消息并相应地处理它们。