Complete el requisito previo para monitorear los eventos Configure Amazon EventBridge para supervisar los eventos Más información sobre los beneficios y los eventos de la API

Notificaciones para el AWS API de beneficios de Partner Central

El Servicio de Beneficios ofrece EventBridge eventos BenefitApplications tanto para BenefitAllocations Y. Estos eventos permiten a los clientes crear arquitecturas integrales basadas en eventos que respondan a los cambios a lo largo de todo el ciclo de vida de los recursos, desde la aplicación inicial hasta la asignación y el cumplimiento final.

Temas

Complete el requisito previo para monitorear los eventos
Configure Amazon EventBridge para supervisar los eventos
Más información sobre los beneficios y los eventos de la API

Complete el requisito previo para monitorear los eventos

Los usuarios necesitan los permisos de IAM adecuados para acceder y gestionar los eventos publicados por la API de beneficios. Para obtener más información sobre las acciones, los recursos y las claves de condición disponibles EventBridge, consulta la sección Uso de las condiciones de la política de IAM en Amazon EventBridge en la Guía del EventBridge usuario de Amazon. Una de las claves de condición es events:detail-type la que se puede usar para asignar permisos a tipos de eventos específicos.

El siguiente ejemplo de política demuestra cómo personalizar y establecer el alcance de los permisos para los eventos propuestos. La AllowPutRuleForPartnercentralBenefitsEvents sentencia permite la creación de reglas, pero solo para los eventos de la aws.partnercentral-benefits fuente.

Para ver ejemplos detallados de políticas de IAM, consulte la documentación de AWS sobre EventBridge los permisos.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowPutRuleForPartnerCentralBenefitsEvents",
      "Effect": "Allow",
      "Action": "events:PutRule",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "events:source": "aws.partnercentral-benefits"
        }
      }
    }
  ]
}

Configure Amazon EventBridge para supervisar los eventos

Para monitorizar los eventos de la API de beneficios, crea una EventBridge regla que coincida con los eventos que quieres capturar. Puede usar los SDK Consola de administración de AWS o los AWS SDK para crear y administrar reglas. En las siguientes secciones se explica cómo crear reglas con ambos métodos. Independientemente del método que utilice, debe crear la regla en la us-east-1 región EE.UU. Este (Norte de Virginia).

Consola de administración de AWS setup

Para configurar una EventBridge regla con el Consola de administración de AWS, sigue los pasos que se indican en la Guía del EventBridge usuario de Amazon para crear reglas que EventBridge reaccionen a los eventos de Amazon. Al crear la regla, debes configurar el bus de eventos como predeterminado y crear la regla en la us-east-1 región EE.UU. Este (Norte de Virginia).

A continuación se muestra un ejemplo de una regla de eventos:


{
    "source": ["aws.partnercentral-benefits"],
    "detail": {
        "catalog": ["AWS"]
    }
}

AWS Configuración del SDK

Puede usar los AWS SDK para crear y administrar EventBridge reglas mediante programación. Para obtener más información, consulte la referencia de PutRule la API de Amazon EventBridge .

El siguiente ejemplo usa el AWS SDK para Python (Boto3):


# Requires the AWS SDK for Python (Boto3)
import boto3

client = boto3.client('events', region_name='us-east-1')

response = client.put_rule(
    Name='MyBenefitApplicationCreatedRule',
    EventPattern='''{
        "source": ["aws.partnercentral-benefits"],
        "detail-type": ["Benefit Application Created"],
        "detail": {"catalog": ["AWS"]}
    }''',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

Más información sobre los beneficios y los eventos de la API

En las siguientes secciones se describen los tipos de eventos de la API de beneficios, los escenarios que los activan y los ejemplos de eventos.

Event types (Tipos de eventos)

A continuación se muestran los tipos de eventos y sus desencadenantes.

Solicitudes de beneficios

Solicitud de beneficios creada: cuando se crea una solicitud de beneficios
Solicitud de prestación en revisión: cuando se presenta una solicitud de prestación o cuando la solicitud pasa de la acción requerida a la de revisión, se desencadena este evento.
Es necesario solicitar la prestación: este evento se produce cuando un revisor interno actualiza el estado de la solicitud para indicar que el socio debe proporcionar información adicional, aclaraciones o modificaciones antes de que la revisión pueda continuar.
Solicitud de prestación rechazada: este evento se produce cuando un revisor interno actualiza el estado de la solicitud para indicar que la solicitud no cumple los criterios o requisitos de la prestación y ha sido rechazada
Solicitud de prestaciones aprobada: este evento se produce cuando un revisor interno actualiza el estado de la solicitud para indicar que se ha aprobado la asignación de prestaciones.
Cambio en la fase de solicitud de prestaciones: este evento se produce cuando un revisor interno actualiza el estado de la solicitud durante los procesos de revisión, como la AWS revisión empresarial, la revisión financiera, etc.

Asignaciones de beneficios

Asignación de beneficios activada: cuando un servicio interno crea o actualiza una asignación de beneficios para convertirla en Activada.
Asignación de beneficios inactivada: este evento se produce cuando un revisor interno actualiza el estado de la asignación o cuando una asignación de beneficios vence automáticamente.
Asignación de beneficios cumplida: este evento se produce cuando un revisor interno actualiza el estado de la asignación para indicar que la asignación se ha utilizado por completo.

Eventos de ejemplo

En las siguientes secciones se proporcionan ejemplos de los eventos enumerados anteriormente en la sección anterior.

Temas

Se creó la solicitud de beneficios
Solicitud de beneficios en revisión
Se requiere una acción para solicitar el beneficio
Solicitud de prestación rechazada
Solicitud de beneficios aprobada
Se modificó la etapa de solicitud de beneficios
Asignación de beneficios activada
Se ha desactivado la asignación de beneficios
Se completó la asignación de beneficios

Se creó la solicitud de beneficios

Contexto desencadenante

El evento de creación de la solicitud de beneficios se publica en Amazon EventBridge cuando se crea correctamente una nueva solicitud de beneficios a través del Servicio de beneficios. Este evento se produce cuando la llamada a la CreateBenefitApplication API se completa correctamente, lo que indica que un socio ha iniciado una solicitud de un beneficio específico.

Este evento representa el comienzo del ciclo de vida de las solicitudes de beneficios y proporciona a los clientes una notificación inmediata cuando se envían nuevas solicitudes a su cuenta.

Destinatarios

El titular de la cuenta recibirá el evento para la asignación de beneficios.

Ejemplo


{
  "id": "7gh88765-k0jh-d08g-i292-2ff1796m030n",
  "detail-type": "Benefit Application Created",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-10T15:45:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "PENDING_SUBMISSION",
      "revision": "hh7e8400-e29b-41d4-a716-446655440012"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Solicitud de beneficios en revisión

Contexto desencadenante

El evento sobre la solicitud de beneficios en revisión se publica en Amazon EventBridge cuando una solicitud de beneficio pasa al estado IN_REVIEW a través del Servicio de beneficios. Este evento se produce cuando:

Un socio envía su solicitud a través de la llamada a la SubmitBenefitApplication API
Una aplicación pasa de ACTION_REQUIRED a IN_REVIEW después de que el socio responda a los comentarios
Se recupera una solicitud y, a continuación, se vuelve a enviar

Este evento indica que la solicitud ha entrado en el proceso de revisión formal y está siendo evaluada por equipos AWS internos.

Destinatarios

El titular de la cuenta recibirá el evento para la asignación de beneficios.

Ejemplo


{
  "id": "8hi99876-l1ki-e19h-j303-3gg2807n141o",
  "detail-type": "Benefit Application In Review",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-10T16:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "IN_REVIEW",
      "stage": "BUSINESS_REVIEW",
      "revision": "ii8f9511-f30c-52e5-b827-557766551123"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Se requiere una acción para solicitar el beneficio

Contexto desencadenante

El evento Benefit Application Action Required se publica en Amazon EventBridge cuando una solicitud de beneficio pasa al estado ACTION_REQUIRED a través del Servicio de Beneficios. Este evento se produce cuando un revisor interno actualiza el estado de la solicitud a través de la UpdateBenefitApplicationInternal API para indicar que el socio debe proporcionar información adicional, aclaraciones o modificaciones antes de que la revisión pueda continuar.

Este evento representa un punto crítico del ciclo de vida de la aplicación en el que es necesaria la intervención del socio para hacer avanzar la aplicación en el proceso de revisión.

Destinatarios

La cuenta titular recibirá el evento para la asignación de beneficios

Ejemplo


{
  "id": "9ij00987-m2lj-f20i-k414-4hh3918o252p",
  "detail-type": "Benefit Application Action Required",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-12T10:30:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "ACTION_REQUIRED",
      "stage": "BUSINESS_REVIEW",
      "revision": "jj9g0622-g41d-63f6-c938-668877662234"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Solicitud de prestación rechazada

Contexto desencadenante

El evento de solicitud de beneficios rechazada se publica en Amazon EventBridge cuando una solicitud de beneficio pasa al estado RECHAZADA a través del Servicio de Beneficios. Este evento se produce cuando un revisor interno actualiza el estado de la solicitud a través de la UpdateBenefitApplicationInternal API para indicar que la solicitud no cumple los criterios o requisitos de la prestación y ha sido rechazada.

Este evento representa un estado terminal del ciclo de vida de la aplicación en el que la solicitud se ha rechazado formalmente y no se procederá a la asignación de beneficios.

Destinatarios

La cuenta titular recibirá el evento para la asignación de beneficios.

Ejemplo


{
  "id": "0kl11098-n3mk-g31j-l525-5ii4029p363q",
  "detail-type": "Benefit Application Rejected",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-15T14:20:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "REJECTED",
      "revision": "kk0h1733-h52e-74g7-d049-779988773345"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Solicitud de beneficios aprobada

Contexto desencadenante

El evento de aprobación de la solicitud de beneficios se publica en Amazon EventBridge cuando una solicitud de beneficio pasa al estado APROBADA a través del Servicio de beneficios. Este evento se produce cuando un revisor interno actualiza el estado de la solicitud a través de la UpdateBenefitApplicationInternal API para indicar que la solicitud cumple con todos los criterios y requisitos de beneficios y que se ha aprobado la asignación de beneficios.

Este evento representa la finalización satisfactoria del proceso de revisión de la solicitud y, por lo general, desencadena la creación de la asignación de beneficios correspondiente.

Destinatarios

La cuenta titular recibirá el evento para la asignación de beneficios.

Ejemplo


{
  "id": "1lm22109-o4nl-h42k-m636-6jj5130q474r",
  "detail-type": "Benefit Application Approved",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-14T16:45:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "APPROVED",
      "revision": "ll1i2844-i63f-85h8-e150-880099884456"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Se modificó la etapa de solicitud de beneficios

Contexto desencadenante

El evento de modificación de la fase de solicitud de prestaciones se publica en Amazon EventBridge cuando la fase de revisión de una solicitud de prestaciones se actualiza a través del Servicio de ventajas. Este evento se produce cuando un revisor interno actualiza el estado de la solicitud con uno de los posibles valores de enumeración (FINANCE_REVIEW, BUSINESS_REVIEW, TECH_REVIEW y _REVIEW). AWS

A diferencia de los cambios de estado, los cambios de fase son actualizaciones informativas de solo lectura que proporcionan visibilidad del progreso del flujo de trabajo de revisión interna sin necesidad de que el socio intervenga.

Destinatarios

El propietario de la cuenta recibirá el evento para la asignación de beneficios.

Ejemplo


{
  "id": "2mn33210-p5om-i53l-n747-7kk6241r585s",
  "detail-type": "Benefit Application Stage Changed",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-13T11:15:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "IN_REVIEW",
      "stage": "FINANCIAL_REVIEW",
      "revision": "mm2j3955-j74g-96i9-f261-991100995567"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Asignación de beneficios activada

Contexto desencadenante

El evento de asignación de beneficios activada se publica en Amazon EventBridge cuando una asignación de beneficios pasa al estado ACTIVO a través del Servicio de beneficios. Este evento se produce cuando un revisor interno actualiza el estado de la asignación a través de la UpdateBenefitAllocationInternal API para reactivar una asignación que antes estaba inactiva.

Este evento suele ocurrir cuando una asignación que estaba inactivada temporalmente (por caducidad, cambios en las políticas o por motivos administrativos) vuelve a su estado activo, lo que permite que los socios puedan volver a utilizar las ventajas.

Destinatarios

La AWS cuenta que pertenece al socio recibirá el mensaje. En otras palabras, la AWS cuenta propietaria del recurso.

Ejemplo de evento


{  
  "id": "3no44321-q6pn-j64m-o858-8ll7352s696t",
  "detail-type": "Benefit Allocation Activated",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-03-01T08:15:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitAllocation": {
      "id": "benalloc-abc123def456",
      "fulfillmentType": "CREDITS",
      "status": "ACTIVE"
    },
    "benefitApplication": {
      "id": "benappl-12345abcdef123"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Se ha desactivado la asignación de beneficios

Contexto desencadenante

El evento de asignación de beneficios inactivada se publica en Amazon EventBridge cuando una asignación de beneficios pasa al estado INACTIVA a través del Servicio de Beneficios. Este evento se produce cuando un revisor interno actualiza el estado de la asignación a través de la UpdateBenefitAllocationInternal API o cuando una asignación de beneficios caduca automáticamente.

Este evento suele ocurrir cuando una asignación se suspende temporalmente (por caducidad, cambios en las políticas, problemas de cumplimiento o motivos administrativos), lo que hace que los beneficios no estén disponibles para que los utilicen los socios hasta que se reactiven.

Destinatarios

La AWS cuenta que pertenece al socio recibirá el mensaje. En otras palabras, la AWS cuenta propietaria del recurso.

Ejemplo de evento


{  
  "id": "4op55432-r7qo-k75n-p969-9mm8463t707u",
  "detail-type": "Benefit Allocation Inactivated",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-06-30T23:59:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitAllocation": {
      "id": "benalloc-abc123def456",
      "fulfillmentType": "CREDITS",
      "status": "INACTIVE"
    },
    "benefitApplication": {
      "id": "benappl-12345abcdef123"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Se completó la asignación de beneficios

Contexto desencadenante

El evento de asignación de beneficios cumplida se publica en Amazon EventBridge cuando una asignación de beneficios pasa al estado CUMPLIDA a través del Servicio de beneficios. Este evento se produce cuando un revisor interno actualiza el estado de la asignación a través de la UpdateBenefitAllocationInternal API para indicar que la asignación se ha utilizado por completo o que se han cumplido las condiciones de la prestación.

Este evento representa la finalización del ciclo de vida de la prestación e indica que el socio ha utilizado satisfactoriamente la prestación asignada o que la asignación ha llegado a su fin natural.

Destinatarios

La AWS cuenta que pertenezca al socio recibirá el mensaje. En otras palabras, la AWS cuenta propietaria del recurso.

Ejemplo de evento


{  
  "id": "5pq66543-s8rp-l86o-q070-0nn9574u818v",
  "detail-type": "Benefit Allocation Fulfilled",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-12-15T17:30:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitAllocation": {
      "id": "benalloc-abc123def456",
      "fulfillmentType": "CREDITS",
      "status": "FULFILLED"
    },
    "benefitApplication": {
      "id": "benappl-12345abcdef123"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

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

Notificaciones para el AWS Partner Central Selling API

Notificaciones para AWS API de Partner Central Channel