Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Notificaciones de SNS para productos SaaS
Para recibir notificaciones, te suscribes a los temas del AWS Marketplace Amazon Simple Notification Service (Amazon SNS) que se te proporcionaron durante la creación del producto. Los temas proporcionan notificaciones acerca de los cambios realizados en la suscripción y los derechos contractuales de los clientes para sus productos. Esto le permite saber cuándo debe proporcionar y revocar el acceso de determinados clientes.
nota
Durante el proceso de creación del producto, recibirá el nombre de recurso de Amazon (ARN) real en el tema de SNS. Por ejemplo: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE
Los siguientes temas de Amazon SNS están disponibles para los productos de software como servicio (SaaS):
-
Tema de Amazon SNS: aws-mp-entitlement-notification: este tema envía una notificación cuando los compradores crean un nuevo contrato, lo actualizan o lo renuevan, o cuando este caduca. Solo está disponible para productos con modelos de precios que incluyan un contrato (también conocidos como contratos SaaS y contratos SaaS con consumo (sobreuso)).
-
Tema de Amazon SNS: aws-mp-subscription-notification: este tema envía una notificación cuando un comprador se suscribe o cancela su suscripción a un producto e incluye el
offer-identifierpara ofertas privadas y una marca de pruebas gratuitas para las pruebas gratuitas de SaaS. Está disponible para todos los modelos de precios, incluidos los contratos y las suscripciones (también conocidos como suscripciones SaaS), contratos SaaS y contratos SaaS con consumo (sobreuso).
Para obtener más información sobre los escenarios en los que responde a estas notificaciones, consulte los temas siguientes:
Tema de Amazon SNS: aws-mp-entitlement-notification
Cada mensaje del tema aws-mp-entitlement-notification tiene el formato siguiente.
{ "action": "<action-name>", "customer-identifier": "X01EXAMPLEX", "product-code": "n0123EXAMPLEXXXXXXXXXXXX", }
El <action-name> siempre será
entitlement-updated.
nota
-
Para los mensajes de derechos, independientemente de la acción (nueva, de actualización, de renovación o caducada), el mensaje es el mismo. Es necesario realizar una llamada posterior a
GetEntitlementpara descubrir el contenido de la actualización. -
Para el contrato SaaS con consumo (sobreuso), a los vendedores se les proporciona el tema de SNS de aws-mp-subscription-notification. Es una notificación adicional que recibe un vendedor cuando añade los precios de sobreuso. Cuando un vendedor consigue nuevos clientes, en lugar de recibir solo
entitlement-updated(lo que puede referirse a cualquier tipo de acción), recibe un mensaje de suscripción en el que se indica que es un cliente nuevo. -
Para los acuerdos con fecha futura (FDA), este tema se inicia en la fecha de inicio del acuerdo (y no en la fecha de firma del acuerdo). También se inicia cuando se producen cambios posteriores en el derecho, como la cancelación, el reemplazo, la renovación o el vencimiento del acuerdo.
Los productos con precios contractuales (incluidos los contratos celebrados con ellos pay-as-you-go) deben responder a estos mensajes. Para obtener más información sobre cómo editar las respuestas, consulte Escenario: supervise los cambios en las suscripciones de los usuarios.
Tema de Amazon SNS: aws-mp-subscription-notification
Cada mensaje del tema aws-mp-subscription-notification tiene el formato siguiente.
{ "action": "<action-name>", "customer-identifier": "X01EXAMPLEX", "product-code": "n0123EXAMPLEXXXXXXXXXXXX", "offer-identifier": "offer-abcexample123", "isFreeTrialTermPresent":"true" }
El offer-identifier solo aparece en la notificación si se trata de una oferta privada.
La propiedad isFreeTrialTermPresent indica si la suscripción del comprador es una prueba gratuita. El valor JSON de esta propiedad no es un tipo de datos booleano. En su lugar, el valor se convierte en un tipo de datos de cadena. Para obtener más información, consulte Pruebas gratuitas de SaaS.
El <action-name> variará en función de la notificación. Las acciones posibles son:
-
subscribe-success: el mensajesubscribe-successindica cuándo puede el vendedor empezar a enviar registros de medición. -
subscribe-fail— Si se genera elsubscribe-failmensaje, es posible que el pago no se haya realizado correctamente aunque el comprador ya haya pasado de la página de inicio de SaaS AWS Marketplace a la del vendedor. El vendedor debe esperar a recibir el mensajesubscribe-successantes de permitir el consumo del producto. -
unsubscribe-pending: cuando un comprador se da de baja, primero se envía un mensajeunsubscribe-pending. Esto indica que el vendedor tiene un tiempo limitado (una hora aproximadamente) para enviar los registros de medición finales antes de que el comprador cancele por completo la operación. -
unsubscribe-success: el mensajeunsubscribe-successindica que se ha completado la cancelación, tras lo cual no se aceptarán más registros de mediciones.
nota
-
Si un comprador se da de baja y vuelve a suscribirse justo antes de que se envíe el mensaje
unsubscribe-successfinal, no se enviará el mensaje finalunsubscribe-successsino un mensajesubscribe-success. -
Para los acuerdos con fecha futura (FDA), la acción de suscripción exitosa se inicia en la fecha de inicio del acuerdo (y no en la fecha de firma del acuerdo).
Los productos con precios de suscripción (incluidos los contratos con pay-as-you-go) deben responder a estos mensajes. Para obtener más información sobre cómo responder, consulte los siguientes temas:
Suscripción de una cola SQS al tema SNS
Le recomendamos que suscriba una cola de Amazon SQS a los temas SNS proporcionados. Para obtener instrucciones detalladas sobre la creación de una cola de SQS y la suscripción de la cola a un tema, consulte el tema Suscripción de una cola de Amazon SQS a un tema de Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service.
nota
Solo puedes suscribirte a los temas AWS Marketplace de las redes sociales que Cuenta de AWS se utilizan para vender los productos. Sin embargo, puede reenviar los mensajes a una cuenta diferente. Para obtener más información, consulte Envío de mensajes de Amazon SNS a una cola de Amazon SQS de otra cuenta en la Guía para desarrolladores de Amazon Simple Notification Service.
Sondeo de la cola de SQS para notificaciones
Tras suscribir la cola de SQS a un tema de SNS, los mensajes se almacenan en SQS. Debe definir un servicio que realice un sondeo continuo de la cola, busque mensajes y los gestione en consecuencia.
