本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

若要接收通知，您可以訂閱產品建立期間 AWS Marketplace 提供給您的 Amazon Simple Notification Service (Amazon SNS) 主題。這些主題會針對您產品的客戶訂閱提供變更通知。例如，您可以使用這些通知來了解客戶何時接受私有優惠。

**注意**  
在產品建立過程中，會為您的產品建立 Amazon SNS 主題。若要訂閱通知，您需要 Amazon SNS 主題的 Amazon Resource Name (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`或 時， `offer-identifier`才會包含在通知中`subscribe-fail`。當動作為 `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 中。您必須定義持續輪詢佇列、尋找訊息並相應地處理它們的服務。