EventBridge Eventos de Amazon - AWS Marketplace

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.

EventBridge Eventos de Amazon

Como vendedor, puedes usar Amazon EventBridge para recibir notificaciones de eventos en AWS Marketplace. Por ejemplo, puedes recibir un evento a partir del AWS Marketplace momento en que se crea una oferta. El evento contiene detalles como el identificador, la fecha de caducidad y los detalles del producto. EventBridge es un servicio de bus de eventos que puede utilizar para conectar sus aplicaciones con datos de diversas fuentes. Para obtener más información, consulta la Guía del EventBridge usuario de Amazon. En las siguientes secciones se proporciona información detallada sobre los eventos del servicio Marketplace Catalog de la EventBridge consola.

Este tema

Acción del vendedor Evento recibido Tema relacionado
El proveedor de software independiente (ISV) crea una oferta y la pone a disposición para su compra Offer Released Eventos para nuevas ofertas
Un socio de canal utiliza el producto de ISV para crear una oferta Offer Released Eventos para nuevas ofertas
El socio de canal crea una oferta Offer Released Eventos para nuevas ofertas
ISV crea un nuevo conjunto de ofertas OfferSet Released Eventos para nuevas ofertas
El socio de canal crea un nuevo conjunto de ofertas OfferSet Released Eventos para nuevas ofertas
El conjunto de cambios se realiza correctamente Change Set Succeeded Eventos para conjuntos de cambios
Error al realizar el conjunto de cambios Change Set Failed Eventos para conjuntos de cambios
El conjunto de cambios se ha cancelado Change Set Cancelled Eventos para conjuntos de cambios
Se han detectado vulnerabilidades de seguridad en el producto del ISV Products Security Report Created Eventos de informe resumido de seguridad
El cliente se suscribe al producto SaaS Purchase Agreement Created Eventos para celebrar acuerdos
Se modifica el acuerdo de SaaS del cliente Purchase Agreement Amended Eventos para celebrar acuerdos
El cliente cancela la suscripción a SaaS Purchase Agreement Ended Eventos para celebrar acuerdos
Los derechos de SaaS del cliente cambian License Updated Eventos relacionados con las licencias
Se revocan los derechos de SaaS del cliente License Deprovisioned Eventos relacionados con las licencias

Eventos para nuevas ofertas

Cuando los vendedores crean una oferta y la ponen a la venta, pueden recibir un evento con el siguiente tipo de detalle: Offer Released.

nota

Para obtener información sobre la creación de EventBridge reglas, consulta EventBridge las reglas de Amazon en la Guía del EventBridge usuario de Amazon.

El siguiente es un ejemplo del cuerpo del evento para una nueva oferta creada por un ISV.

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "Offer Released", "source": "aws.marketplacecatalog", "account": "123456789012", "time": "2023-08-26T00:00:00Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/offer-1234567890123" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "offer": { "id": "offer-1234567890123", "arn": "arn:aws:catalog:us-east-1:123456789012:Offer/offer-1234567890123", "name": "Offer Name", "expirationDate": "2025-08-26T00:00:00Z" }, "product": { "id": "bbbbaaaa-abcd-1111-abcd-666666666666", "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666", "title": "Product Title" }, "manufacturer": { "accountId": "123456789012", "name": "Manufacturer Account Name" }, "sellerOfRecord": { "accountId": "123456789012", "name": "Seller Account Name" }, "targetedBuyerAccountIds": [ "999988887777", "111122223333" ] } }

A continuación se muestra un ejemplo del cuerpo de un evento para cuando un socio de canal independiente utiliza el producto de un ISV para crear una oferta.

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "Offer Released", "source": "aws.marketplacecatalog", "account": "123456789012", "time": "2023-08-26T00:00:00Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "offer": { "id": "offer-1234567890123", "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123", "name": "Offer Name", "expirationDate": "2025-08-26T00:00:00Z" }, "product": { "id": "bbbbaaaa-abcd-1111-abcd-666666666666", "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666", "title": "Product Title" }, "manufacturer": { "accountId": "123456789012", "name": "Manufacturer Account Name" }, "sellerOfRecord": { "accountId": "987654321098", "name": "Seller Account Name" }, "targetedBuyerAccountIds": ["999988887777", "111122223333"], } } }

A continuación se muestra un ejemplo del cuerpo del evento en el que un socio de canal crea una oferta.

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "Offer Released", "source": "aws.marketplacecatalog", "account": "987654321098", "time": "2023-08-26T00:00:00Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "offer": { "id": "offer-1234567890123", "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123", "name": "Offer Name", "expirationDate": "2025-08-26T00:00:00Z" }, "product": { "id": "bbbbaaaa-abcd-1111-abcd-666666666666", "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666", "title": "Product Title" }, "manufacturer": { "accountId": "123456789012", "name": "Manufacturer Account Name" }, "sellerOfRecord": { "accountId": "987654321098", "name": "Seller Account Name" }, "targetedBuyerAccountIds": ["999988887777", "111122223333"], } } }

A continuación se muestra un ejemplo del cuerpo de un evento para un nuevo conjunto de ofertas publicado por un socio (ISV o socio de canal).

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "OfferSet Released", "source": "aws.marketplacecatalog", "account": "123456789012", "time": "2023-08-26T00:00:00Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/OfferSet/offerset-1234567890123" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "offerSet": { "id": "offerset-1234567890123", "arn": "arn:aws:catalog:us-east-1:987654321098:OfferSet/offerset-1234567890123", "name": "Offer Set Name", }, "associatedOffers": [ { "offer": { "id": "offer-1234567890123", "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123", "name": "Offer Name", } }, ... ] } }

Eventos para conjuntos de cambios

Cuando se complete un conjunto de cambios, los vendedores, los socios de canal y los administradores del mercado privado pueden recibir un evento. La API del AWS Marketplace catálogo envía un evento cuando un conjunto de cambios se completa con el estado correcto, fallido o cancelado. El origen de estos eventos es aws.marketplacecatalog, y los posibles valores de los tipos de detalles son Change Set Succeeded, Change Set Failed yChange Set Cancelled.

nota

Para obtener información sobre los conjuntos de cambios, consulte Trabajar con conjuntos de cambios en la Referencia de la API de AWS Marketplace Catalog.

Cada evento contiene detalles de la solicitud de cambio, como el ID del conjunto de cambios, el nombre del conjunto de cambios, el tipo de detalle del evento, el código de error (para las solicitudes fallidas) y la hora de inicio y finalización de la solicitud. Esto le permite supervisar los conjuntos de cambios sin tener que consultar continuamente la DescribeChangeSet acción ni comprobar el AWS Marketplace Management Portal estado de las solicitudes de cambio.

nota

Para obtener información sobre la creación de EventBridge reglas, consulta EventBridge las reglas de Amazon en la Guía del EventBridge usuario de Amazon.

El siguiente es un ejemplo del cuerpo de evento para un tipo de detalle de Change Set Succeeded.

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "Change Set Succeeded", "source": "aws.marketplacecatalog", "account": "123456789012", "time": "2022-11-01T13:12:22Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg" ], "detail": { "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "Catalog": "AWSMarketplace", "ChangeSetId": "76yesvf8y165pa4f98td2crtg", "ChangeSetName": "Create my product", "StartTime": "2018-02-27T13:45:22Z", "EndTime": "2018-02-27T14:55:22Z" } }

El siguiente es un ejemplo del cuerpo de evento para un tipo de detalle de Change Set Failed.

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "Change Set Failed", "source": "aws.marketplacecatalog", "account": "123456789012", "time": "2022-11-01T13:12:22Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg" ], "detail": { "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "Catalog": "AWSMarketplace", "ChangeSetId": "76yesvf8y165pa4f98td2crtg", "ChangeSetName": "Create my product", "StartTime": "2018-02-27T13:45:22Z", "EndTime": "2018-02-27T14:55:22Z", "FailureCode": "CLIENT_ERROR" } }

El siguiente es un ejemplo del cuerpo de evento para un tipo de detalle de Change Set Cancelled.

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "Change Set Cancelled", "source": "aws.marketplacecatalog", "account": "123456789012", "time": "2022-11-01T13:12:22Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg" ], "detail": { "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "Catalog": "AWSMarketplace", "ChangeSetId": "76yesvf8y165pa4f98td2crtg", "ChangeSetName": "Create my product", "StartTime": "2018-02-27T13:45:22Z", "EndTime": "2018-02-27T14:55:22Z" } }

Eventos de informe resumido de seguridad

Cuando se detectan vulnerabilidades de seguridad en los productos de un vendedor, puede recibir un evento de informe resumido y recordatorios periódicos en caso de problemas pendientes con los productos. El origen de estos eventos es aws.marketplacecatalog y el tipo de detalle es Products Security Report Created.

Cada evento incluye un resumen del número de productos y versiones con problemas detectados, un recuento del número de versiones más recientes afectadas y la fecha en que es necesario resolverlos para evitar una restricción temporal de estos productos o versiones.

nota

Para obtener información sobre la creación de EventBridge reglas, consulta EventBridge las reglas de Amazon en la Guía del EventBridge usuario de Amazon.

Para obtener más información sobre la administración de los eventos de seguridad, consulte la publicación de blog How to improve the security of your product catalog in AWS Marketplace en el AWS Blog.

El siguiente es un ejemplo del cuerpo de evento para un tipo de detalle de Products Security Report Created.

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "Products Security Report Created", "source": "aws.marketplacecatalog", "account": "123456789012", "time": "2023-10-31T00:00:00Z", "region": "us-east-1", "resources": [], "detail": { "numberOfProductsWithIssues": 1, "numberOfVersionsWithIssues": 1, "numberOfLatestVersionsWithIssues": 1, "newIssuesFound": true, "upcomingResolutionDueDate": "2023-12-01T00:00:00Z", "requestId": "533fa17d-3e97-5051-bcaf-1fae45fb3f8b" } }

Eventos para abonos

Cuando se produce un error en un desembolso a la cuenta bancaria del vendedor debido a que los datos de la cuenta bancaria no son válidos, AWS Marketplace ISVs es posible que los socios del canal reciban una notificación.

En el siguiente código de evento JSON, el valor de source de estos eventos es aws.marketplace y el valor de detail-type es Disbursement Paused. El valor de resources muestra la cuenta bancaria número de recurso de Amazon (ARN).

{ "version": "0", "id": "01234567-0123-0123-0123-0123456789ab", "detail-type": "Disbursement Paused", "source": "aws.marketplace", "account":"<account id of end user>", "time": "2022-11-01T13:12:22Z", "region": "us-east-1", "resources": ["arn:aws:payments:us-east-1:1234567890:paymentinstrument:123"], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace" } }

Para resolver el problema de los detalles de la cuenta bancaria no válidos, añade los datos de tu cuenta bancaria en el Portal AWS Marketplace de Administración. Para obtener instrucciones, consulte Para añadir los detalles de la cuenta bancaria.

Para obtener más información sobre la creación de EventBridge reglas de Amazon, consulta Reglas de Amazon EventBridge en la Guía del EventBridge usuario de Amazon.

Eventos para celebrar acuerdos

Cuando se producen eventos relacionados con un acuerdo, los vendedores pueden recibir notificaciones sobre los cambios en el ciclo de vida del acuerdo de compra.

Para obtener información sobre la creación de EventBridge reglas, consulta EventBridge las reglas de Amazon en la Guía del EventBridge usuario de Amazon.

A continuación se muestra un ejemplo del cuerpo del evento Purchase Agreement Created - Proposer.

nota

En el caso de la oferta privada de socios de canal (CPPO), se rellenará el identificador de autorización de reventa y, en el caso de la oferta directa de Marketplace (MPPO), este valor será nulo.

{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Created - Proposer", "source": "aws.agreement-marketplace", "account": "<ISV's or CP's account id>", "time": "2024-08-30T21:36:03Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "agreement": { "id": "agmt-4mwg1nevbokzw95eca5797ixs", "intent": "NEW", "status": "ACTIVE", "acceptanceTime": "2024-06-26T21:36:03Z", "startTime": "2024-08-30T21:36:03Z", "endTime": "2025-05-30T21:36:03Z" }, "resaleAuthorization": { "id": "resaleauthz-yaxjqxiskysxa" }, "acceptor": { "accountId": "845735284135" }, "proposer": { "accountId": "123456512334" }, "offer": { "id": "offer-1234567890123" } } }

A continuación se muestra un ejemplo del cuerpo del evento correspondiente al acuerdo de compra creado: fabricante.

{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Created - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV's account id>", "time": "2024-08-30T21:36:03Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "agreement": { "id": "agmt-4mwg1nevbokzw95eca5797ixs", "intent": "NEW", "status": "ACTIVE", "acceptanceTime": "2024-06-26T21:36:03Z", "startTime": "2024-08-30T21:36:03Z", "endTime": "2025-05-30T21:36:03Z" }, "resaleAuthorization": { "id": "resaleauthz-yaxjqxiskysxa" }, "acceptor": { "accountId": "845735284135" }, "proposer": { "accountId": "123456512334" }, "offer": { "id": "offer-1234567890123" } } }

El siguiente es un ejemplo del cuerpo del evento Acuerdo de compra modificado: proponente.

{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Amended - Proposer", "source": "aws.agreement-marketplace", "account": "<ISV or CP's account id>", "time": "2024-08-30T21:36:03Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "agreement": { "id": "agmt-4mwg1nevbokzw95eca5797ixs", "intent": "AMEND", "status": "ACTIVE", "acceptanceTime": "2024-06-26T21:36:03Z", "startTime": "2024-08-30T21:36:03Z", "endTime": "2025-05-30T21:36:03Z" }, "resaleAuthorization": { "id": "resaleauthz-yaxjqxiskysxa" }, "acceptor": { "accountId": "845735284135" }, "proposer": { "accountId": "123456512334" }, "offer": { "id": "offer-1234567890123" } } }

El siguiente es un ejemplo del cuerpo del evento del acuerdo de compra modificado: fabricante.

{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Amended - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV's account id>", "time": "2024-08-30T21:36:03Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "agreement": { "id": "agmt-4mwg1nevbokzw95eca5797ixs", "intent": "AMEND", "status": "ACTIVE", "acceptanceTime": "2024-06-26T21:36:03Z", "startTime": "2024-08-30T21:36:03Z", "endTime": "2025-05-30T21:36:03Z" }, "resaleAuthorization": { "id": "resaleauthz-yaxjqxiskysxa" }, "acceptor": { "accountId": "845735284135" }, "proposer": { "accountId": "123456512334" }, "offer": { "id": "offer-1234567890123" } } }

A continuación se muestra un ejemplo del cuerpo del evento Acuerdo de compra finalizado: proponente.

{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Ended - Proposer", "source": "aws.agreement-marketplace", "account": "<ISV's account id>", "time": "2024-08-30T21:36:03Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "agreement": { "id": "agmt-4mwg1nevbokzw95eca5797ixs", "status": "CANCELLED" }, "resaleAuthorization": { "id": "resaleauthz-yaxjqxiskysxa" }, "acceptor": { "accountId": "845735284135" }, "proposer": { "accountId": "123456512334" }, "offer": { "id": "offer-1234567890123" } } }

A continuación se muestra un ejemplo del cuerpo del evento de compra finalizado: fabricante.

{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Ended - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV's account id>", "time": "2024-08-30T21:36:03Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "agreement": { "id": "agmt-4mwg1nevbokzw95eca5797ixs", "status": "CANCELLED" }, "resaleAuthorization": { "id": "resaleauthz-yaxjqxiskysxa" }, "acceptor": { "accountId": "845735284135" }, "proposer": { "accountId": "123456512334" }, "offer": { "id": "offer-1234567890123" } } }

Eventos relacionados con las licencias

Cuando se producen eventos relacionados con la licencia, los vendedores pueden recibir notificaciones sobre los cambios en los derechos de los clientes.

Para obtener información sobre la creación de EventBridge reglas, consulta EventBridge las reglas de Amazon en la Guía del EventBridge usuario de Amazon.

A continuación se muestra un ejemplo del organismo del evento License Updated: Manufacturer.

{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "License Updated - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV/CP account id>", "time": "2024-08-30T21:36:03Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "agreement": { "id": "agmt-4mwg1nevbokzw95eca5797ixs" }, "product": { "code": "aw4fgf5tyo5w2ap6fEXAMPLE", "id": "prod-qtwveEXAMPLE" }, "license": { "arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x" }, "acceptor": { "accountId": "845735284135" }, "proposer": { "accountId": "123456512334" }, "offer": { "id": "8kkr91jo647j3qxlcjhlqce7y" } } }

A continuación se muestra un ejemplo del organismo del evento License Deprovisioned - Manufacturer.

{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "License Deprovisioned - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV/CP account id>", "time": "2024-08-30T21:36:03Z", "region": "us-east-1", "resources": [ "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs" ], "detail": { "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb", "catalog": "AWSMarketplace", "agreement": { "id": "agmt-4mwg1nevbokzw95eca5797ixs" }, "product": { "code": "aw4fgf5tyo5w2ap6fEXAMPLE", "id": "prod-qtwveEXAMPLE" }, "license": { "arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x" }, "acceptor": { "accountId": "845735284135" }, "proposer": { "accountId": "123456512334" }, "offer": { "id": "8kkr91jo647j3qxlcjhlqce7y" } } }