EventBridge Eventos da Amazon - AWS Marketplace
Eventos para novas ofertasEventos para conjuntos de alteraçõesEventos para relatório resumido de segurança

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á.

EventBridge Eventos da Amazon

Como vendedor, você pode usar EventBridge a Amazon para receber notificações de eventos em AWS Marketplace. Por exemplo, você pode receber um evento AWS Marketplace a partir da criação de uma oferta. O evento contém detalhes como ID, data de validade e detalhes do produto. EventBridge é um serviço de barramento de eventos que você pode usar para conectar seus aplicativos a dados de várias fontes. Para obter mais informações, consulte o Guia EventBridge do usuário da Amazon. As seções a seguir fornecem informações detalhadas sobre eventos no serviço Marketplace Catalog no EventBridge console.

Este tópico

Ação do vendedor Evento recebido Tópico relacionado
O fornecedor independente de software (ISV) cria uma oferta e a disponibiliza para compra Offer Released Eventos para novas ofertas
ISVO produto é usado por um parceiro de canal para criar uma oferta Offer Released Eventos para novas ofertas
O parceiro de canal cria uma oferta Offer Released Eventos para novas ofertas
O conjunto de alterações foi bem-sucedido Change Set Succeeded Eventos para conjuntos de alterações
O conjunto de alterações falha Change Set Failed Eventos para conjuntos de alterações
O conjunto de alterações foi cancelado Change Set Cancelled Eventos para conjuntos de alterações
Vulnerabilidades de segurança foram detectadas no produto ISV da Products Security Report Created Eventos para relatório resumido de segurança

Eventos para novas ofertas

Quando os vendedores criam uma oferta e a disponibilizam para compra, eles podem receber um evento com o seguinte tipo de detalhe: Offer Released.

nota

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

A seguir está um exemplo de corpo de evento para uma nova oferta criada por umISV.

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

Veja a seguir um exemplo de corpo de evento para quando um produto ISV é usado por um parceiro de canal para criar uma 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"],
    }
  }
}

Veja a seguir um exemplo de corpo de evento para quando um parceiro de canal cria uma 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 alterações

Quando um conjunto de alterações é concluído, vendedores, parceiros de canal e administradores de mercados privados podem receber um evento. O AWS Marketplace Catálogo API envia um evento quando um conjunto de alterações é concluído com o status de bem-sucedido, falhado ou cancelado. A fonte desses eventos é aws.marketplacecatalog, e os valores possíveis do tipo de detalhe são Change Set Succeeded, Change Set Failed e Change Set Cancelled.

nota

Para obter informações sobre conjuntos de alterações, consulte Como trabalhar com conjuntos de alterações na APIReferência do AWS Marketplace Catálogo.

Cada evento contém detalhes da solicitação de alteração, como ID do conjunto de alterações, nome do conjunto de alterações, tipo de detalhe do evento, código de falha (para solicitações com falha) e horários de início e término da solicitação. Isso permite que você monitore seus conjuntos de alterações sem consultar continuamente a DescribeChangeSet ação ou verificar o Portal de gerenciamento do AWS Marketplace status de suas solicitações de alteração.

nota

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

O seguinte é um exemplo do corpo de um evento para o tipo de detalhe 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"
  }
}

O seguinte é um exemplo do corpo de um evento para o tipo de detalhe 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"
  }
}

O seguinte é um exemplo do corpo de um evento para o tipo de detalhe 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 para relatório resumido de segurança

Quando vulnerabilidades de segurança são detectadas nos produtos de um vendedor, ele pode receber um relatório resumido do evento e lembretes periódicos sobre problemas pendentes do produto. A fonte desses eventos éaws.marketplacecatalog, e o tipo de detalhe éProducts Security Report Created.

Cada evento inclui um resumo da contagem de produtos e versões com problemas detectados, uma contagem de quantas versões mais recentes foram afetadas e a data em que a resolução é necessária para evitar uma restrição temporária desses produtos ou versões.

nota

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

Para obter detalhes sobre o gerenciamento de eventos de segurança, consulte Como melhorar a segurança do seu catálogo de produtos na AWS Marketplace postagem do AWS blog no blog.

O seguinte é um exemplo do corpo de um evento para o tipo de detalhe 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"
   }
}