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 cuentas de Partner Central

Las notificaciones de conexión de cuentas de socios permiten a los socios mantenerse informados sobre los eventos del ciclo de vida de las conexiones que afectan directamente a sus relaciones comerciales y flujos de trabajo operativos. Estos eventos son fundamentales para que los socios puedan:

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 conexiones de cuentas 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.

En el siguiente ejemplo de política se muestra cómo personalizar y establecer el alcance de los permisos para los eventos propuestos. La AllowPutRuleForPartnercentralAccountEvents declaración permite la creación de reglas, pero solo para los eventos de la aws.partnercentral-account 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": "AllowPutRuleForPartnerCentralAccountEvents",
      "Effect": "Allow",
      "Action": "events:PutRule",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "events:source": "aws.partnercentral-account.connection"
        }
      }
    }
  ]
}

Configurar Amazon EventBridge para monitorizar los eventos

Para monitorear los eventos de la API de conexiones de cuentas, 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-account"],
    "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='MyConnectionInvitationReceivedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-account"], 
        "detail-type": ["Partner Connection Invitation Received"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

Más información sobre los eventos de la API de conexiones de cuentas

En las siguientes secciones se describen los tipos de eventos de la API de conexiones de cuentas, 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.

Eventos de ejemplo

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

Se recibió la invitación de Partner Connection

Contexto desencadenante

Este evento se genera cuando una invitación de conexión se crea correctamente y se conserva en el almacén de datos de PAC a través de la CreateConnectionInvitation API. El evento se envía inmediatamente después de que la creación de la invitación se complete correctamente y permanece en el almacén de datos del PAC, no solo cuando se realiza la llamada a la API.

El evento se enviará automáticamente cuando se cree una nueva invitación de conexión. Se crea un evento por invitación sin eventos duplicados para la misma invitación.

Destinatarios

La AWS cuenta del destinatario de la invitación de conexión.

Manejo esperado

Acciones típicas de los clientes:

Patrones de integración comunes:

Ejemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Received",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderCompanyName": "<<Sender Partner Account Name>>",
        "senderProfileId": "pprofile-****",
        "expiresAt": "<ISO 8601 date time>"
    }
  }
}

Se acepta la invitación a Partner Connection

Contexto desencadenante

Este evento se genera cuando se acepta correctamente una invitación de conexión y se crea y conserva una conexión en el almacén de datos del PAC a través de la AcceptConnectionInvitation API. El evento se envía inmediatamente después de que la aceptación de la invitación se complete correctamente y se establezca la conexión.

El evento se enviará automáticamente cuando se acepte una invitación de conexión. Se acepta un evento por invitación, sin eventos duplicados para la misma aceptación.

Destinatarios

Ambas AWS cuentas implicadas en la invitación de conexión: la cuenta del remitente que envió originalmente la invitación y la cuenta del destinatario que la aceptó.

Manejo esperado

Acciones típicas de los clientes:

Patrones de integración comunes:

Ejemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type":  "Partner Connection Invitation Accepted",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" , "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration"
    },
    "connection": {
        "arn": "<<Connection ARN>>",
         "id": "pac-*****",
         "Participant1AccountId": "<<Sender AWS AccountId>>", 
         "Participant2AccountId": "<<Receiver AWS AccountId>>",
         "status": "ACTIVE"
     }
  }
}

Invitación a Partner Connection rechazada

Contexto desencadenante

Este evento se genera cuando una invitación de conexión se rechaza correctamente a través de la RejectConnectionInvitation API. El evento se envía inmediatamente después de que se procese el rechazo de la invitación y se conserva en el almacén de datos del PAC.

El evento se enviará automáticamente cuando se rechace una invitación de conexión. Se rechaza un evento por invitación, sin eventos duplicados para el mismo rechazo.

Destinatarios

La AWS cuenta que envió originalmente la invitación de conexión (la cuenta del remitente).

Manejo esperado

Acciones típicas de los clientes:

Patrones de integración comunes:

Ejemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Rejected",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "receiverProfileId": "pprofile-****"
    }
  }
}

Conexión con el socio cancelada

Contexto desencadenante

Este evento se genera cuando una conexión activa se cancela correctamente y el estado activo se actualiza a finalizado en el almacén de datos del PAC a través de la CancelConnection API. El evento se envía inmediatamente después de que se procese la cancelación de la conexión y se actualice el estado de la conexión.

El evento se enviará automáticamente cuando finalice la conexión. Se cancela un evento por conexión sin eventos duplicados para la misma cancelación.

Destinatarios

La AWS cuenta del otro participante de la conexión (no la cuenta que inició la cancelación).

Manejo esperado

Acciones típicas de los clientes:

Patrones de integración comunes:

Ejemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connection" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pac-****",
        "connectionType": "OpportunityCollaboration",
        "canceledBy": "<<AWS account ID>>"
    }
  }
}

Invitación a Partner Connection cancelada

Contexto desencadenante

Este evento se genera cuando una invitación de conexión pendiente se cancela correctamente a través de la CancelConnectionInvitation API. El evento se envía inmediatamente después de que se procese la cancelación de la invitación y el estado de la invitación se actualice a CANCELADA.

El evento se enviará automáticamente cuando se cancele una invitación de conexión. Se cancela un evento por invitación de conexión, sin eventos duplicados para la misma cancelación.

Destinatarios

La AWS cuenta que debía recibir la invitación de conexión (la cuenta receptora).

Manejo esperado

Acciones típicas de los clientes:

Patrones de integración comunes:

Ejemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****"
    }
  }
}

La invitación a Partner Connection expiró

Contexto desencadenante

Este evento se genera cuando una invitación de conexión pendiente caduca automáticamente tras alcanzar su ExpiresAt fecha y hora sin que el destinatario la acepte o rechace. El sistema activa automáticamente el evento cuando se alcanza la fecha de caducidad de la invitación.

El evento se enviará automáticamente cuando caduque la invitación de conexión. Ha caducado un evento por invitación, sin eventos duplicados durante el mismo periodo de caducidad.

Destinatarios

Ambas AWS cuentas implicadas en la invitación de conexión: la cuenta del remitente que envió originalmente la invitación y la cuenta del destinatario que la recibió.

Manejo esperado

Acciones típicas de los clientes:

Patrones de integración comunes:

Ejemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Expired",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation": {
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****",
        "receiverProfileId": "pprofile-****"
    }
  }
}