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](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

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
<a name="account-api-events"></a>

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:
+ Reaccione rápidamente ante una nueva colaboración
+ Manténgase al tanto del estado de su cartera de conexiones
+ Tome las medidas adecuadas cuando se establezcan o finalicen las conexiones
+ Garantice la continuidad del negocio al saber cuándo cambian las relaciones

**Topics**
+ [Complete el requisito previo para monitorear los eventos](#events-prerequites)
+ [Configurar Amazon EventBridge para monitorizar los eventos](#eventbridge-setup)
+ [Más información sobre los eventos de la API de conexiones de cuentas](#learn-about-events)

## Complete el requisito previo para monitorear los eventos
<a name="events-prerequites"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-conditions.html#events-pattern-detail-type) la *Guía del EventBridge usuario de Amazon*. Una de las claves de condición es`events: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
<a name="eventbridge-setup"></a>

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

### Consola de administración de AWS setup
<a name="eventbridge-console-setup"></a>

Para configurar una EventBridge regla mediante el Consola de administración de AWS, sigue los pasos que se indican en [Crear reglas que reaccionen a los eventos en Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html), 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
<a name="eventbridge-sdk-setup"></a>

Puede usar los AWS SDK para crear y administrar EventBridge reglas mediante programación. Para obtener más información, consulta [PutRule](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html)la *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
<a name="learn-about-events"></a>

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 name="types-of-events"></a>

A continuación se muestran los tipos de eventos y sus desencadenantes.
+ [Invitación de conexión con el socio recibida](#connection-invitation-received): notifica al destinatario que otro socio desea establecer una conexión
+ [Invitación a Partner Connection aceptada](#connection-invitation-accepted): notifica al remitente que su invitación ha sido aceptada y que ahora hay una conexión activa
+ [Invitación de Partner Connection rechazada](#connection-invitation-rejected): notifica al remitente que su invitación ha sido rechazada
+ [Conexión de pareja cancelada](#connection-cancelled): notifica al otro participante conectado cuando se termina una conexión activa
+ [Invitación a Partner Connection cancelada](#connection-invitation-cancelled): notifica al destinatario que el remitente ha retirado la invitación antes de que se tome ninguna medida
+ [La invitación de Partner Connection ha caducado](#connection-invitation-expired): notifica al remitente y al destinatario que la invitación ha caducado

### Eventos de ejemplo
<a name="example-rules"></a>

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

**Topics**
+ [Se recibió la invitación de Partner Connection](#connection-invitation-received)
+ [Se acepta la invitación a Partner Connection](#connection-invitation-accepted)
+ [Invitación a Partner Connection rechazada](#connection-invitation-rejected)
+ [Conexión con el socio cancelada](#connection-cancelled)
+ [Invitación a Partner Connection cancelada](#connection-invitation-cancelled)
+ [La invitación a Partner Connection expiró](#connection-invitation-expired)

#### Se recibió la invitación de Partner Connection
<a name="connection-invitation-received"></a>

##### Contexto desencadenante
<a name="connection-invitation-received-context"></a>

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
<a name="connection-invitation-received-recipients"></a>

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

##### Manejo esperado
<a name="connection-invitation-received-handling"></a>

Acciones típicas de los clientes:
+ Notificación inmediata: active alertas a los equipos empresariales sobre nuevas oportunidades de asociación
+ Automatización del flujo de trabajo: actualice automáticamente los sistemas de gestión de socios con las invitaciones pendientes
+ Decision Support: envíe las invitaciones a los responsables de la toma de decisiones correspondientes según el tipo de conexión
+ Registro de auditorías: registre la recepción de las invitaciones para hacer un seguimiento del cumplimiento y de la asociación
+ Automatización de respuestas: en el caso de los socios de confianza, es posible que acepten automáticamente ciertos tipos de invitaciones

Patrones de integración comunes:
+ Función Lambda → Actualizar el panel del portal de socios
+ SQS queue → Procesar por lotes las invitaciones para su revisión
+ Tema SNS → Email/Slack notificaciones a los equipos empresariales
+ Destino de la API → Webhook a sistemas de gestión externos CRM/partner 

##### Ejemplo
<a name="connection-invitation-received-example"></a>

```
{
  "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
<a name="connection-invitation-accepted"></a>

##### Contexto desencadenante
<a name="connection-invitation-accepted-context"></a>

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
<a name="connection-invitation-accepted-recipients"></a>

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
<a name="connection-invitation-accepted-handling"></a>

Acciones típicas de los clientes:
+ Activación de la asociación: active flujos de trabajo para habilitar las actividades empresariales de nivel 2
+ Actualizaciones de estado: actualice los sistemas de administración de los socios con el estado de conexión activo
+ Notificación: avise a los equipos empresariales sobre el establecimiento exitoso de una asociación
+ Aprovisionamiento de acceso: conceda automáticamente los permisos adecuados para la colaboración
+ Análisis: realice un seguimiento de las tasas de conversión y las métricas de éxito de las asociaciones

Patrones de integración comunes:
+ Función Lambda → Habilite los permisos para compartir datos y actualice el portal de socios
+ SQS queue → Activaciones de conexión de procesos por lotes para la configuración empresarial
+ Tema SNS → Email/Slack notificaciones a los equipos técnicos y empresariales
+ Destino de la API → Webhook a los sistemas CRM para actualizar el estado de la asociación

##### Ejemplo
<a name="connection-invitation-accepted-example"></a>

```
{
  "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
<a name="connection-invitation-rejected"></a>

##### Contexto desencadenante
<a name="connection-invitation-rejected-context"></a>

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
<a name="connection-invitation-rejected-recipients"></a>

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

##### Manejo esperado
<a name="connection-invitation-rejected-handling"></a>

Acciones típicas de los clientes:
+ Actualizaciones de estado: actualice los sistemas de gestión de socios con el estado de rechazo
+ Follow-up Acciones: active flujos de trabajo para enfoques de asociación alternativos
+ Notificación: avise a los equipos empresariales sobre la decisión de asociarse
+ Limpieza: elimine las referencias a las invitaciones pendientes de los sistemas internos

Patrones de integración comunes:
+ Función Lambda → Actualizar el portal de socios y activar flujos de trabajo de seguimiento
+ SQS queue → Rechazos de procesos por lotes para el análisis empresarial
+ Tema SNS → Email/Slack notificaciones a los equipos de desarrollo empresarial
+ Destino de la API → Webhook a los sistemas CRM para actualizar el estado de las oportunidades

##### Ejemplo
<a name="connection-invitation-rejected-example"></a>

```
{
  "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
<a name="connection-cancelled"></a>

##### Contexto desencadenante
<a name="connection-cancelled-context"></a>

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
<a name="connection-cancelled-recipients"></a>

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

##### Manejo esperado
<a name="connection-cancelled-handling"></a>

Acciones típicas de los clientes:
+ Revocación de acceso: revoque inmediatamente los permisos y desactive el intercambio de datos
+ Actualizaciones de estado: actualice los sistemas de administración de los socios con el estado de conexión finalizado
+ Notificación: avise a los equipos comerciales y técnicos sobre la finalización de la asociación
+ Limpieza: elimine las referencias de conexión y limpie los recursos compartidos
+ Análisis: realice un seguimiento de la duración de la conexión y los patrones de terminación

Patrones de integración comunes:
+ Función Lambda → Revocar permisos y actualizar el estado del portal de socios
+ SQS queue → Terminaciones de conexión de procesos por lotes para flujos de trabajo de limpieza
+ Tema SNS → Email/Slack notificaciones a los equipos técnicos y empresariales
+ Destino de la API → Webhook a los sistemas CRM para actualizar el estado de la asociación

##### Ejemplo
<a name="connection-cancelled-example"></a>

```
{
  "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
<a name="connection-invitation-cancelled"></a>

##### Contexto desencadenante
<a name="connection-invitation-cancelled-context"></a>

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
<a name="connection-invitation-cancelled-recipients"></a>

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

##### Manejo esperado
<a name="connection-invitation-cancelled-handling"></a>

Acciones típicas de los clientes:
+ Actualizaciones de estado: actualice los sistemas de administración de socios para eliminar las referencias de invitaciones pendientes
+ Notificación: avise a los equipos empresariales de que se ha retirado una posible oportunidad de asociación
+ Limpieza: elimine las referencias a las invitaciones de los sistemas de seguimiento internos
+ Análisis: haz un seguimiento de los patrones de cancelación de invitaciones para obtener información sobre las asociaciones

Patrones de integración comunes:
+ Función Lambda → Actualizar el portal de socios y eliminar las notificaciones de invitaciones pendientes
+ SQS queue → Cancelaciones de procesos por lotes para análisis empresarial
+ Tema SNS → Email/Slack notificaciones a los equipos de desarrollo empresarial
+ Destino de la API → Webhook a los sistemas CRM para actualizar el estado de las oportunidades

##### Ejemplo
<a name="connection-invitation-cancelled-example"></a>

```
{
  "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ó
<a name="connection-invitation-expired"></a>

##### Contexto desencadenante
<a name="connection-invitation-expired-context"></a>

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
<a name="connection-invitation-expired-recipients"></a>

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
<a name="connection-invitation-expired-handling"></a>

Acciones típicas de los clientes:
+ Actualizaciones de estado: actualice los sistemas de administración de socios para marcar la invitación como vencida
+ Follow-up Acciones: active los flujos de trabajo para recuperar el compromiso o adoptar enfoques de asociación alternativos
+ Notificación: avise a los equipos empresariales sobre las oportunidades de asociación perdidas
+ Limpieza: elimina las referencias de invitaciones caducadas de los sistemas de seguimiento internos

Patrones de integración comunes:
+ Función Lambda → Actualizar el portal de socios y activar flujos de trabajo de seguimiento
+ SQS queue → Vencimientos del proceso por lotes para el análisis empresarial
+ Tema SNS → Email/Slack notificaciones a los equipos de desarrollo empresarial
+ Destino de la API → Webhook a los sistemas CRM para actualizar el estado de las oportunidades

##### Ejemplo
<a name="connection-invitation-expired-example"></a>

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