As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
SNSNotificações da Amazon para produtos SaaS
Para receber notificações, você assina os tópicos do Amazon Simple Notification Service (AmazonSNS) AWS Marketplace fornecidos durante a criação do produto. Os tópicos fornecem notificações sobre alterações nas assinaturas e nos direitos contratuais dos clientes para seus produtos. Isso permite que você saiba quando fornecer e revogar o acesso de clientes específicos.
nota
Durante o processo de criação do produto, você receberá o nome real do recurso Amazon (ARN) para o SNS tópico. Por exemplo: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE
Os seguintes SNS tópicos da Amazon estão disponíveis para produtos de software como serviço (SaaS):
-
SNSTópico da Amazon: aws-mp-entitlement-notification: este tópico notifica você quando os compradores criam um novo contrato, o atualizam, o renovam ou ele expira. Isso só está disponível para produtos com modelos de preços que incluem um contrato (também conhecido como Contratos de SaaS e Contratos de SaaS com consumo (excedentes)).
-
SNSTópico da Amazon: aws-mp-subscription-notification: este tópico notifica você quando um comprador assina ou cancela a assinatura de um produto e inclui o
offer-identifierpara ofertas privadas e um sinalizador de avaliações gratuitas de SaaS. Isso está disponível para todos os modelos de preços, incluindo contratos e assinaturas (também conhecidos como Assinaturas de SaaS, Contratos de SaaS e Contratos de SaaS com consumo (excedentes).
Para saber mais sobre os cenários nos quais você responde a essas notificações, consulte os seguintes tópicos:
SNSTópico da Amazon: aws-mp-entitlement-notification
Cada mensagem no tópico aws-mp-entitlement-notification tem o formato a seguir.
{ "action": "<action-name>", "customer-identifier": "X01EXAMPLEX", "product-code": "n0123EXAMPLEXXXXXXXXXXXX", }
A ferramenta <action-name> sempre será
entitlement-updated.
nota
-
Para mensagens de autorização, independentemente da ação (nova, atualização, renovação ou expirada), a mensagem é a mesma. É necessária uma chamada subsequente para
GetEntitlementpara descobrir o conteúdo da atualização. -
Para contratos SaaS com consumo (excedentes), os vendedores recebem o tópico. aws-mp-subscription-notification SNS Essa é uma notificação extra que o vendedor recebe quando adiciona preços excedentes. Quando um vendedor adquire novos clientes, em vez de apenas obter
entitlement-updated(o que pode se referir a qualquer tipo de ação), o vendedor recebe uma mensagem de assinatura indicando que se trata de um novo cliente. -
Para contratos com data futura (FDAs), este tópico é iniciado na data de início do contrato (e não na data de assinatura do contrato). Também é iniciado quando ocorrem alterações subsequentes no direito, como cancelamento, substituição, renovação ou expiração do contrato.
Os produtos com preços contratuais (incluindo contratos com pay-as-you-go) devem responder a essas mensagens. Para obter mais informações sobre como responder, consulte Cenário: monitorar as alterações nas assinaturas dos usuários.
SNSTópico da Amazon: aws-mp-subscription-notification
Cada mensagem no tópico aws-mp-subscription-notification tem o formato a seguir.
{ "action": "<action-name>", "customer-identifier": "X01EXAMPLEX", "product-code": "n0123EXAMPLEXXXXXXXXXXXX", "offer-identifier": "offer-abcexample123", "isFreeTrialTermPresent":"true" }
O offer-identifier só vai aparecer na notificação se a oferta for privada.
A propriedade isFreeTrialTermPresent indica se a assinatura do comprador é uma avaliação gratuita. O JSON valor dessa propriedade não é um tipo de dados booleano. Em vez disso, o valor é convertido em um tipo de dados de string. Para obter mais informações, consulte Avaliações gratuitas de SaaS.
A ferramenta <action-name> variará de acordo com a notificação. As ações possíveis são:
-
subscribe-success: a mensagemsubscribe-successindica quando o vendedor pode começar a enviar registros de medição. Se uma oferta baseada em contrato for aceita pelo comprador, essa mensagem será enviada novamente com a nova.offer-identifier -
subscribe-fail— Se asubscribe-failmensagem for gerada, o pagamento pode ter falhado, mesmo que o comprador já tenha feito a transição da página inicial SaaS AWS Marketplace para a página de destino SaaS do vendedor. O vendedor deve aguardar a mensagemsubscribe-successantes de permitir o consumo do produto. -
unsubscribe-pending: quando um comprador cancela a assinatura, uma mensagemunsubscribe-pendingé enviada primeiro. Isso indica que o vendedor tem um tempo limitado (cerca de uma hora) para enviar os registros finais de medição antes que o comprador seja totalmente cancelado. -
unsubscribe-success: a mensagemunsubscribe-successsinaliza a conclusão do cancelamento, após o qual nenhum outro registro de medição será aceito.
nota
-
Se um comprador cancelar a assinatura e se inscrever novamente imediatamente antes do envio da mensagem
unsubscribe-successfinal, a mensagemunsubscribe-successfinal não será enviada e, em vez disso, uma mensagemsubscribe-successserá enviada. -
Para contratos com data futura (FDAs), a
subscribe-successação é iniciada na data de início do contrato (e não na data de assinatura do contrato).
Os produtos com preços de assinatura (incluindo contratos com pay-as-you-go) devem responder a essas mensagens. Para obter mais informações sobre como responder, consulte os tópicos a seguir:
Inscrevendo uma SQS fila no tópico SNS
Recomendamos que você inscreva uma SQS fila da Amazon nos tópicos fornecidosSNS. Para obter instruções detalhadas sobre como criar uma SQS fila e inscrever a fila em um tópico, consulte Inscrever uma fila da Amazon em um tópico da SQS Amazon no Guia do desenvolvedor do SNS Amazon Simple Notification Service.
nota
Você só pode se inscrever em AWS Marketplace SNS tópicos do Conta da AWS usado para vender os produtos. No entanto, você pode encaminhar as mensagens para uma conta diferente. Para obter mais informações, consulte Enviar SNS mensagens da Amazon para uma SQS fila da Amazon em uma conta diferente no Guia do desenvolvedor do Amazon Simple Notification Service.
Pesquisando a SQS fila para notificações
Depois de inscrever sua SQS fila em um SNS tópico, as mensagens são armazenadas emSQS. Defina um serviço que continuamente sonde a fila, procure mensagens e manipule-as da forma adequada.
