

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

# AWS EventBridge Eventos do Marketplace Agreement
<a name="agreement-eventbridge"></a>

AWS Marketplace envia notificações para a Amazon EventBridge quando certos eventos ocorrem no ciclo de vida de seus contratos (ou seja, ofertas que você comprou). Você pode usar esses eventos para automatizar fluxos de trabalho e acompanhar suas compras no mercado.

A tabela a seguir lista os eventos do comprador que são AWS Marketplace enviados para EventBridge:


| Event | Description | 
| --- | --- | 
| Contrato de compra criado - Aceitante | Enviado quando um novo contrato de compra é criado, renovado ou substituído em sua conta | 
| Contrato de compra alterado - Aceitante | Enviado quando são feitas modificações em um contrato de compra existente | 
| Contrato de compra encerrado - Aceitante | Enviado quando um contrato de compra é cancelado, expirado, rescindido, renovado ou substituído | 
| Fim do contrato de compra - Aceitante | Enviado 30, 60 e 90 dias antes da expiração do contrato de compra | 

## Visão geral do
<a name="agreement-events-overview"></a>

Os compradores recebem EventBridge notificações sobre os seguintes eventos do ciclo de vida do contrato de compra:
+ Criação de contrato
+ Emendas ao contrato
+ Fim do contrato (cancelamento, expiração ou rescisão)
+ Fim do contrato

Todos os eventos são enviados para seu barramento de EventBridge eventos padrão na `us-east-1` região com a origem do evento`aws.agreement-marketplace`.

## Tipos de eventos
<a name="agreement-event-types"></a>

### Contrato de compra criado - Aceitante
<a name="agreement-created-event"></a>

AWS Marketplace envia esse evento quando um novo contrato de compra é criado em sua conta.

**Cenários de acionamento:**
+ `NEW`- O contrato é criado pela primeira vez
+ `REPLACE`- Uma nova oferta privada precisa ser aceita como parte de uma Oferta Baseada em Contrato (ABO)
+ `RENEW`- Um contrato é renovado automaticamente ao expirar (se ativado)

**Esquema do evento:**

```
{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Created - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
      "intent": "NEW|RENEW|REPLACE",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-abcdef123456"
    }
  }
}
```

### Contrato de compra alterado - Aceitante
<a name="agreement-amended-event"></a>

AWS Marketplace envia esse evento quando são feitas modificações em um contrato de compra existente, como alterações nos termos, preços ou outros parâmetros do contrato.

**Esquema do evento:**

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Amended Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer 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"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}
```

### Contrato de compra encerrado - Aceitante
<a name="agreement-ended-event"></a>

AWS Marketplace envia esse evento quando um contrato de compra termina.

**Cenários de acionamento:**
+ `CANCELLED`- Você encerrou o contrato antes da data de término definida
+ `EXPIRED`- O acordo atingiu sua data de término definida
+ `TERMINATED`- AWS rescindiu o contrato (por exemplo, devido a uma falha no pagamento)
+ `RENEWED`- O acordo foi renovado em um novo acordo
+ `REPLACED`- O contrato foi substituído por uma oferta de substituição do contrato

**Esquema do evento:**

```
{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Ended - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "987654321098",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:aws:agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
      "status": "CANCELLED|EXPIRED|RENEWED|REPLACED|TERMINATED"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-abcdef123456"
    }
  }
}
```

### Fim do contrato de compra - Aceitante
<a name="agreement-ending-event"></a>

AWS Marketplace envia esse evento 30, 60 e 90 dias antes da expiração do contrato de compra.

Esse evento inclui campos adicionais que não estão presentes em outros eventos para compradores:
+ `agreement.autoRenewalEnabled`- Indica se a renovação automática está habilitada para o contrato
+ `product.id`e `product.title` - Informações sobre o produto para o contrato
+ `proposer.name`e `offer.name` - Nomes legíveis para o vendedor e a oferta

**Esquema do evento:**

```
{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Ending - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2025-03-31T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z",
      "autoRenewalEnabled": true,
      "status": "ACTIVE"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "name": "Example Seller Name",
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-abcdef123456",
      "name": "Example Offer Name"
    }
  }
}
```

## Campos de eventos comuns
<a name="agreement-common-fields"></a>

Todos os eventos para compradores incluem esses campos comuns:


| Campo | Description | 
| --- | --- | 
| requestId | UUID usado para desduplicar eventos duplicados | 
| catalog | O catálogo do AWS Marketplace (normalmente "AWSMarketplace“) | 
| agreementId | Identificador exclusivo para o contrato | 
| acceptor.accountId | ID AWS da sua conta | 
| proposer.accountId | O ID da AWS conta do vendedor | 
| offer.id | O identificador da oferta | 

## Configurando EventBridge regras
<a name="agreement-eventbridge-setup"></a>

Para receber essas notificações, crie EventBridge regras que correspondam aos padrões de eventos para compradores. Para obter mais informações sobre a criação de regras, consulte [Criação de EventBridge regras](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) da *Amazon no Guia EventBridge do usuário* da Amazon.