Descripción general de Tipos de eventos Campos de eventos comunes Configuración de EventBridge reglas

AWS EventBridge Eventos del Acuerdo de Marketplace

AWS Marketplace envía notificaciones a Amazon EventBridge cuando se producen determinados eventos en el ciclo de vida de tus acuerdos (por ejemplo, ofertas que has comprado). Puedes usar estos eventos para automatizar los flujos de trabajo y realizar un seguimiento de tus compras en el mercado.

nota

En la AWS Marketplace consola, esta fecha se denomina fecha límite de decisión de renovación: el último día que puedes desactivar (o volver a activar) la renovación automática antes de que se confirme la renovación. En estos casos, se representa mediante los campos de bloqueo: renewalSummary.lockoutStartTime es cuando finaliza ese período e renewalSummary.lockoutReached indica si el período ha comenzado.

En la siguiente tabla se muestran los eventos del comprador a los que se AWS Marketplace envía EventBridge:

Event	Description (Descripción)
Acuerdo de compra creado: aceptador	Se envía cuando se crea, renueva o reemplaza un nuevo acuerdo de compra en su cuenta
Acuerdo de compra modificado: aceptador	Se envía cuando se realizan modificaciones a un acuerdo de compra existente
Acuerdo de compra finalizado: aceptador	Se envía cuando un acuerdo de compra se cancela, vence, rescinde, renueva o reemplaza
Finalización del acuerdo de compra: aceptador	Se envía 180, 120, 90, 60 y 30 días antes de que venza el acuerdo de compra
Finalizados los términos de renovación del acuerdo de compra - Aceptador	Se envía una vez transcurrido el plazo de ajuste establecido por el vendedor, en el caso de las renovaciones por intervalos porcentuales, una vez finalizado el aumento del precio de la renovación (o se aplica el aumento predeterminado)
Próximamente se renovará el acuerdo de compra: aceptador	Se envía cuando se alcanza la fecha límite de la decisión de renovación y se confirma que la renovación continúa

Descripción general de

Los compradores reciben EventBridge notificaciones sobre los siguientes eventos relacionados con el ciclo de vida del acuerdo de compra:

Creación de acuerdos
Modificaciones del acuerdo
Finalización del acuerdo (cancelación, caducidad o rescisión)
Finalización del acuerdo

Todos los eventos se envían al bus de EventBridge eventos predeterminado de la us-east-1 región donde se encuentra el origen del eventoaws.agreement-marketplace.

Tipos de eventos

Acuerdo de compra creado: aceptador

AWS Marketplace envía este evento cuando se crea un nuevo acuerdo de compra en su cuenta.

Escenarios desencadenantes:

NEW- El acuerdo se crea por primera vez
REPLACE- Es necesario aceptar una nueva oferta privada como parte de una Agreement-Based oferta (ABO)
RENEW- Un acuerdo se renueva automáticamente al expirar (si está activado)

Esquema de eventos:


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

Para una renovación automática, AWS Marketplace envía este evento con intent set en. RENEW El evento incluyeagreement.previousAgreementId, un product bloqueproposer.name, yoffer.name.


{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Created - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2025-05-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-newrenewalagreementid"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-newrenewalagreementid",
      "intent": "RENEW",
      "status": "ACTIVE",
      "startTime": "2025-05-30T21:36:03Z",
      "endTime": "2026-05-30T21:36:03Z",
      "previousAgreementId": "agmt-9xyz8wmklp67rt32nb1qv45ds"
    },
    "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"
    }
  }
}

Acuerdo de compra modificado: Aceptador

AWS Marketplace envía este evento cuando se realizan modificaciones en un acuerdo de compra existente, como cambios en las condiciones, los precios u otros parámetros del acuerdo.

Esquema de eventos:


{
  "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",
      "autoRenewalEnabled": true
    },
    "renewalSummary": {
      "lockoutStartTime": "2025-05-20T21:36:03Z",
      "disabledBy": "ACCEPTOR"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-1234567890123",
      "name": "Example Offer Name"
    }
  }
}

La aceptación y exclusión del comprador y la exclusión voluntaria del vendedor se tramitan como modificaciones del acuerdo y salen a la luz durante este evento. renewalSummary.disabledByes ACCEPTOR o PROPOSER (PROPOSERsi ambos se han excluido), o null cuando autoRenewalEnabled lo hay true o no hay condiciones de renovación. renewalSummary.lockoutStartTimees null cuando el plazo de renovación no tiene un período de bloqueo.

Acuerdo de compra finalizado: aceptador

AWS Marketplace envía este evento cuando finaliza un acuerdo de compra.

Escenarios desencadenantes:

CANCELLED- Rescindió el acuerdo antes de la fecha de finalización definida
EXPIRED- El acuerdo alcanzó la fecha de finalización definida
TERMINATED- AWS rescindió el acuerdo (por ejemplo, debido a un impago)
RENEWED- El acuerdo se renovó en un nuevo acuerdo
REPLACED- El acuerdo se sustituyó por una oferta de sustitución del contrato

Esquema de eventos:


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

Finalización del acuerdo de compra: aceptador

AWS Marketplace envía este evento 180, 120, 90, 60 y 30 días antes de que venza el acuerdo de compra.

Este evento incluye campos adicionales que no están presentes en otros eventos de compradores:

agreement.daysBeforeEndTime- El número de días antes de la fecha de finalización del envío de la notificación: 180, 120, 90, 60 o 30
agreement.autoRenewalEnabled- Indica si la renovación automática está habilitada para el acuerdo
renewalSummary- Detalles del bloqueo de la renovación. renewalSummary.lockoutStartTimees null cuando el plazo de renovación no tiene un período de bloqueo; renewalSummary.disabledBy está ACCEPTOR o PROPOSER (PROPOSERsi ambos se han excluido), o null cuando la renovación automática está habilitada o no hay términos de renovación
product.idy product.title - Información sobre el producto del acuerdo
proposer.nameyoffer.name: Human-readable nombres del vendedor y de la oferta

Esquema del 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",
      "daysBeforeEndTime": 180,
      "autoRenewalEnabled": true,
      "status": "ACTIVE"
    },
    "renewalSummary": {
      "lockoutStartTime": "2025-05-20T21:36:03Z",
      "disabledBy": "ACCEPTOR"
    },
    "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"
    }
  }
}

Finalizados los términos de renovación del acuerdo de compra: aceptador

AWS Marketplace envía este evento una vez que finalice la fecha límite de ajuste establecida por el vendedor, solo para ofertas con rango porcentual, una vez que finalice el aumento del precio de renovación (o se aplique el aumento predeterminado).

Esquema de eventos:


{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Renewal Terms Finalized - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2025-05-15T21: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"
    },
    "renewalSummary": {
      "tcv": "105000.00",
      "currency": "USD",
      "termsFinalizedTime": "2025-05-15T21:36:03Z",
      "lockoutReached": false,
      "lockoutStartTime": "2025-05-20T21:36:03Z"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "name": "Example Seller Name",
      "accountId": "<Proposer Account ID>"
    }
  }
}

renewalSummary.lockoutReachedy lockoutStartTime son null cuando el plazo de renovación aceptado no tiene un período de bloqueo.

Próximamente se renueva el acuerdo de compra: ¿Aceptador

AWS Marketplace envía este evento al comienzo del período de bloqueo de la decisión de renovación, cuando se alcanza la fecha límite de la decisión de renovación y se confirma que la renovación continúa.

Esquema de eventos:


{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Renewal Upcoming - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2025-05-20T21: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"
    },
    "renewalSummary": {
      "lockoutReached": true,
      "tcv": "105000.00",
      "currency": "USD"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "name": "Example Seller Name",
      "accountId": "<Proposer Account ID>"
    }
  }
}

Campos de eventos comunes

Todos los eventos de compradores incluyen estos campos comunes:

Campo	Description (Descripción)
`requestId`	El UUID se utiliza para deduplicar eventos duplicados
`catalog`	El catálogo de AWS Marketplace (normalmente «AWSMarketplace»)
`agreementId`	Identificador único del acuerdo
`acceptor.accountId`	Tu ID AWS de cuenta
`proposer.accountId`	El identificador de AWS cuenta del vendedor
`offer.id`	El identificador de la oferta

Configuración de EventBridge reglas

Para recibir estas notificaciones, crea EventBridge reglas que coincidan con los patrones de eventos de los compradores. Para obtener más información sobre la creación de reglas, consulta Cómo crear EventBridge reglas de Amazon en la Guía del EventBridge usuario de Amazon.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Eventos de mercados privados

Eventos de cancelación y ajuste de facturación