SaaS 產品的 Amazon SNS 通知 - AWS Marketplace

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

SaaS 產品的 Amazon SNS 通知

若要接收通知,您可以訂閱 Amazon Simple Notification Service (Amazon SNS) 主題,以便在產品建立期間 AWS Marketplace 提供給您。這些主題提供客戶訂閱的變更通知,以及您產品的合約權利。這可讓您知道何時提供和撤銷特定客戶的存取權。

注意

在產品建立過程中,您將收到 SNS 主題的實際 Amazon Resource Name (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 – 本主題會在買方訂閱或取消訂閱產品時通知您,並包含offer-identifier適用於私有優惠的 和適用於 SaaS 免費試用版的免費試用旗標。這適用於所有定價模型,包括合約和訂閱 (也稱為 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-notification SNS 主題。這是賣方在新增超額定價時收到的額外通知。當賣方取得新客戶時,而不是只取得 entitlement-updated(可能指任何類型的動作),賣方會收到訂閱訊息,指出這是新客戶。

  • 對於未來日期的協議 (FDAs),此主題會在協議開始日期 (而非協議簽署日期) 啟動。當權利發生後續變更時,例如取消、替換、續約或協議到期時,也會啟動。

具有合約定價的產品 (包括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的訊息。如果買方接受以協議為基礎的優惠,此訊息會再次與新的 一起傳送offer-identifier

  • subscribe-fail – 如果產生subscribe-fail訊息,即使買方已從 轉換 AWS Marketplace 到賣方的 SaaS 登陸頁面,付款仍可能失敗。賣方應等待subscribe-success訊息,才能允許使用產品。

  • unsubscribe-pending – 當買方取消訂閱時,unsubscribe-pending會先傳送訊息。這表示賣方在買方完全取消之前,取得最終計量記錄的時間有限 (約一小時)。

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

注意
  • 如果買方取消訂閱,然後在傳送最終unsubscribe-success訊息之前立即成功重新訂閱,則不會傳送最終unsubscribe-success訊息,而是subscribe-success傳送訊息。

  • 對於未來日期的協議 (FDAs),subscribe-success動作會在協議開始日期 (而非協議簽署日期) 啟動。

具有訂閱定價的產品 (包括具有pay-as-you-go的合約) 必須回應這些訊息。如需如何回應的詳細資訊,請參閱下列主題:

訂閱 SQS 佇列至 SNS 主題

我們建議訂閱 Amazon SQS 佇列至提供的 SNS 主題。如需建立 SQS 佇列和訂閱佇列至主題的詳細說明,請參閱《Amazon Simple Notification Service 開發人員指南》中的訂閱 Amazon SQS 佇列至 Amazon SNS 主題

注意

您只能從 AWS 帳戶 用來銷售產品的 訂閱 AWS Marketplace SNS 主題。不過,您可以將訊息轉送到不同的 帳戶。如需詳細資訊,請參閱《Amazon Simple Notification Service 開發人員指南》中的將 Amazon SNS 訊息傳送至不同帳戶中的 Amazon SQS 佇列

輪詢 SQS 佇列以取得通知

將 SQS 佇列訂閱 SNS 主題之後,訊息會儲存在 SQS 中。您必須定義持續輪詢佇列、尋找訊息並據以處理的服務。