View a markdown version of this page

Notificaciones para el AWS API de beneficios de Partner Central - AWS Centro de socios
Complete el requisito previo para monitorear los eventosConfigurar Amazon EventBridge para monitorizar los eventosMás información sobre los beneficios y los eventos de la API

Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulta la referencia de la Centro de socios de AWS API.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Notificaciones para el AWS API de beneficios de Partner Central

El servicio de beneficios ofrece EventBridge eventos para ambos BenefitApplications BenefitAllocations. 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 suministro final.

Complete el requisito previo para monitorear los eventos

Los usuarios necesitan los permisos de IAM adecuados para acceder a los eventos publicados por la API de beneficios y gestionarlos. Para obtener más información sobre las acciones, los recursos y las claves de condición disponibles EventBridge, consulte 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 esevents:detail-type, que se puede utilizar para limitar los permisos a tipos de eventos específicos.

El siguiente ejemplo de política demuestra cómo personalizar y limitar los permisos para los eventos propuestos. La AllowPutRuleForPartnercentralBenefitsEvents declaración 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 permisos.

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

Configurar Amazon EventBridge para monitorizar los eventos

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

AWS Management Console setup

Para configurar una EventBridge regla mediante el AWS Management Console, sigue los pasos que se indican en Crear reglas que reaccionen a los eventos en Amazon, EventBridge en la Guía del EventBridge usuario 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, consulta PutRulela referencia de la EventBridge API de Amazon.

El siguiente ejemplo usa el AWS SDK para 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 las ventajas, los tipos de eventos de la API, los escenarios que los desencadenan y algunos ejemplos de eventos.

Event types (Tipos de eventos)

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

Solicitudes de prestaciones

Asignación de prestaciones

  • Asignación de beneficios activada: cuando un servicio interno crea o actualiza una asignación de beneficios a 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 finalizada: este evento se produce cuando un revisor interno actualiza el estado de la asignación para indicar que la asignación se ha utilizado en su totalidad.

Eventos de ejemplo

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

Solicitud de beneficios creada

Contexto desencadenante

El evento Solicitud de beneficios creada 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 para obtener un beneficio específico.

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

Destinatarios

El propietario de la cuenta recibirá el evento correspondiente a 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"]
    }
  }
}

Se está revisando la solicitud de prestaciones

Contexto desencadenante

El evento Solicitud de prestaciones en revisión se publica en Amazon EventBridge cuando una solicitud de prestaciones pasa al estado IN_REVIEW a través del Servicio de prestaciones. 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 sus comentarios

  • Se retira 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

La cuenta propietaria recibirá el evento correspondiente a 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 de solicitud de beneficios

Contexto desencadenante

El evento Acción requerida para solicitar una prestación se publica en Amazon EventBridge cuando una solicitud de prestaciones pasa al estado ACTION_REQUIRED a través del Servicio de prestaciones. 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, aclaraciones o modificaciones adicionales antes de poder continuar con la revisión.

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 que la aplicación avance en el proceso de revisión.

Destinatarios

La cuenta propietaria recibirá el evento correspondiente a 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 Solicitud de prestación rechazada se publica en Amazon EventBridge cuando una solicitud de prestación pasa al estado RECHAZADA a través del Servicio de prestaciones. 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 con los criterios o requisitos de las prestaciones y que ha sido rechazada.

Este evento representa un estado terminal en el ciclo de vida de la aplicación, en el que la solicitud ha sido rechazada formalmente y no se procederá a la asignación de las prestaciones.

Destinatarios

La cuenta propietaria recibirá el importe correspondiente a 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 prestación aprobada

Contexto desencadenante

El evento Solicitud de prestación aprobada se publica en Amazon EventBridge cuando una solicitud de prestación pasa al estado APROBADA a través del Servicio de prestaciones. 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 prestación y que se ha aprobado su asignación.

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 propietaria recibirá el evento correspondiente a 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 prestaciones

Contexto desencadenante

El evento de modificación de la fase de solicitud de prestaciones se publica en Amazon EventBridge cuando se actualiza la fase de revisión de una solicitud de prestaciones a través del Servicio de prestaciones. Este evento se produce cuando un revisor interno actualiza la fase de la solicitud a uno de los valores de enumeración posibles (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 que sea necesaria la intervención de un socio.

Destinatarios

La cuenta propietaria recibirá el importe correspondiente a 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 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 previamente inactiva.

Este evento suele ocurrir cuando una asignación que estaba inactiva temporalmente (por caducidad, cambios en las políticas o motivos administrativos) vuelve a estar activa, lo que hace que los socios puedan volver a utilizar los beneficios.

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

Asignación de beneficios inactivada

Contexto desencadenante

El evento 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 vence 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 socios los utilicen 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"]
    }
  }
}

Asignación de beneficios completada

Contexto desencadenante

El evento Asignación de beneficios finalizada se publica en Amazon EventBridge cuando una asignación de beneficios pasa al estado Completada 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 en su totalidad o que se han cumplido las condiciones de la prestación.

Este evento representa la finalización del ciclo de vida de las prestaciones 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 pertenece 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"]
    }
  }
}