

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

# 在 上接收 AMI 產品的 Amazon SNS 通知 AWS Marketplace
<a name="ami-notification"></a>

若要接收您產品的客戶訂閱變更通知，您可以訂閱 Amazon Simple Notification Service (Amazon SNS) 主題，以在產品建立期間 AWS Marketplace 提供給您。例如，您可以知道客戶何時接受私有優惠。 [Amazon SNS 主題： aws-mp-subscription-notification](#ami-sns-subscription-message-body)是適用於 AMI 產品的 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。

**Topics**
+ [Amazon SNS 主題： aws-mp-subscription-notification](#ami-sns-subscription-message-body)
+ [訂閱 Amazon SQS 佇列至 Amazon SNS 主題](#subscribing-an-sqs-queue-to-an-sns-topic)

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

`subscribe-success` 和 `aws-mp-subscription-notification` `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`或 時， `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-an-sqs-queue-to-an-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-an-sqs-for-notifications"></a>

將 SQS 佇列訂閱 SNS 主題後，訊息會儲存在 SQS 中。您必須定義持續輪詢佇列、尋找訊息並相應地處理它們的服務。