適用於 SaaS 產品的 Amazon SNS 通知 - AWS Marketplace
Amazon SNS 主題：aws-mp-entitlement-notificationAmazon SNS 主題：aws-mp-subscription-notification訂閱 SQS 佇列至 SNS 主題

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

適用於 SaaS 產品的 Amazon SNS 通知

若要接收通知，請訂閱在產品建立期間提供給您的 AWS Marketplace Amazon 簡單通知服務 (Amazon SNS) 主題。這些主題提供有關客戶訂閱和產品合約權利變更的通知。這使您可以知道何時為特定客戶提供和撤銷訪問權限。

注意

在產品建立過程中，您會收到 SNS 主題的實際 Amazon 資源名稱 (ARN)。例如：arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE

下列 Amazon SNS 主題適用於軟體即服務 (SaaS) 產品：

  • Amazon SNS 主題：aws-mp-entitlement-notification— 當買家建立新合約、升級、續約或到期時，本主題會通知您。這僅適用於具有包含合約的定價模式的產品 (也稱為 SaaS 合約和 SaaS 消費合約 (超額))。

  • Amazon SNS 主題：aws-mp-subscription-notification— 當買方訂閱或取消訂閱產品時，本主題會通知您，並包括私人優惠和 SaaS 免費試offer-identifier用的免費試用標誌。這適用於所有定價模式，包括合約和訂閱 (也稱為 SaaS 訂閱、SaaS 合約和 SaaS 合約 (超額)。

若要深入了解您回應這些通知的案例，請參閱下列主題：

Amazon SNS 主題：aws-mp-entitlement-notification

aws-mp-entitlement-notification主題中的每個訊息都具有下列格式。

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}

<action-name>將永遠是 entitlement-updated。

注意

  • 對於權益訊息，無論動作為何 (新增、升級、續約或已過期)，訊息都是相同的。需要後續呼叫，才能探索更新的內容。GetEntitlement

  • 對於 SaaS 消費合同（超額），賣方提供 aws-mp-subscription-notificationSNS 主題。這是賣家在加入超額價格時收到的額外通知。當賣家收購新客戶時，賣家會收到訂閱訊息，指出這是新客戶，而不是僅取得 entitlement-updated (這可能是任何類型的行動)。

  • 對於 future 日期的合約 (FDA)，本主題是在合約開始日期 (而非合約簽署日期) 啟動。它也會在權利文件中發生後續變更時啟動，例如取消、取代、續約或合約到期。

具有合約定價的產品 (包括簽訂的合約 pay-as-you-go) 必須回應這些訊息。如需如何回應的詳細資訊，請參閱案例：監視使用者訂閱的變更。

Amazon SNS 主題：aws-mp-subscription-notification

aws-mp-subscription-notification主題中的每個訊息都具有下列格式。

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
    "offer-identifier": "offer-abcexample123",
    "isFreeTrialTermPresent":"true"
}

如果選件是私人選件，則offer-identifier只會顯示在通知中。

該isFreeTrialTermPresent屬性指示買方的訂閱是否為免費試用。此屬性的 JSON 值不是布林資料類型。而是將該值轉換為字符串數據類型。如需詳細資訊，請參閱 SaaS 免費試用。

<action-name>將根據通知而有所不同。可能的動作包括：

  • subscribe-success— 當賣方可以開始發送計量記錄時的subscribe-success消息。

  • subscribe-fail— 如果產生subscribe-fail訊息，即使買方已從賣方的 SaaS 登陸頁面轉換 AWS Marketplace 為賣方的 SaaS 登陸頁面，付款也可能失敗。賣方應等待消subscribe-success息，然後才允許消費產品。

  • unsubscribe-pending— 當買家取消訂閱時，系統會先傳送unsubscribe-pending訊息。這表示賣家在完全取消買家之前，有限的時間（約一小時）可以取得最終計量記錄。

  • unsubscribe-success— 消unsubscribe-success息表示取消完成，之後將不接受進一步的計量記錄。

注意

  • 如果買家在最終unsubscribe-success訊息送出前取消訂閱，然後立即成功重新訂閱，系統將不會傳送最終unsubscribe-success訊息，而是會傳送subscribe-success訊息。

  • 針對 future 日期的合約 (FDA)，會在合約開始日期 (而非合約簽署日期) 啟動訂閱成功動作。

訂閱定價的產品 (包括與簽訂的合約 pay-as-you-go) 必須回覆這些訊息。如需如何回應的相關資訊，請參閱下列主題：

訂閱 SQS 佇列至 SNS 主題

我們建議您將 Amazon SQS 佇列訂閱提供的 SNS 主題。如需建立 SQS 佇列和訂閱佇列至主題的詳細指示，請參閱 Amazon 簡單通知服務開發人員指南中的將 Amazon SQS 佇列訂閱至 Amazon SNS 主題。

注意

您只能從 AWS 帳戶 用來銷售產品的 AWS Marketplace SNS 主題訂閱。但是，您可以將郵件轉寄到其他帳戶。如需詳細資訊，請參閱 Amazon 簡單通知服務開發人員指南中的將 Amazon SNS 訊息傳送至不同帳戶中的 Amazon SQS 佇列。

輪詢 SQS 佇列是否有通知

在您訂閱 SQS 佇列至 SNS 主題後，訊息就會儲存在 SQS 中。您必須定義一項服務，以持續輪詢佇列、尋找訊息並據此處理訊息。