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. Las siguientes secciones proporcionan 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
ISVUn socio de canal utiliza el producto para crear una oferta	Offer Released	Eventos para nuevas ofertas
El socio de canal crea una oferta	Offer 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 detectaron vulnerabilidades de seguridad en ISV el producto	Products Security Report Created	Informe resumido de eventos para la seguridad

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 de un evento para una nueva oferta creada por unISV.

{
  "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 en ISV el que un socio de canal utiliza el producto de un canal 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"],
    }
  }
}

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. El AWS Marketplace catálogo API envía un evento cuando un conjunto de cambios finaliza 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 APIreferencia del AWS Marketplace catálogo.

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 o 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"
  }
}

Informe resumido de eventos para la seguridad

Cuando se detectan vulnerabilidades de seguridad en los productos de un vendedor, este puede recibir un informe resumido del evento y recordatorios periódicos en caso de problemas pendientes con los productos. La fuente de estos eventos es y aws.marketplacecatalog el tipo de detalle esProducts 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 gestión de los eventos de seguridad, consulta la entrada del AWS Marketplace blog Cómo mejorar la AWS seguridad de tu catálogo de productos.

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"
   }
}