Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia [ de la ](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)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.
# Trabajar con conexiones de cuentas de socios
Los socios pueden gestionar las conexiones entre sus propias cuentas o las conexiones con las AWS cuentas de otros socios mediante la API AWS Partner Connection. El proceso consta de dos fases:
1. **Fase de invitación a la conexión: ** iniciar y responder a las solicitudes de conexión
1. **Fase de conexión activa: ** administrar las conexiones establecidas y sus actividades comerciales asociadas
## Creación y envío de una invitación de conexión
### Paso 1: Crear una invitación de conexión
El primer paso para establecer una conexión de pareja es crear y enviar una invitación de conexión mediante la `CreateConnectionInvitation` acción. Al crear una invitación, debe especificar:
+ **Catálogo: ** el AWS catálogo (AWS o Sandbox) donde se administrará la conexión
+ **ConnectionType: ** El tipo de relación que desea establecer. Seleccione una de las siguientes opciones:
+ **`OPPORTUNITY_COLLABORATION`: ** Utilice este tipo cuando desee enviar una solicitud de conexión a la cuenta de otro socio para poder enviarle invitaciones para participar en oportunidades de colaboración
+ **`SUBSIDIARY`: ** Usa este tipo cuando quieras conectar varias cuentas de vendedor de AWS Marketplace a tu cuenta «principal» que has vinculado a APN o en la que estás registrado como socio
+ **ReceiverIdentifier: ** El identificador del perfil de socio público del destinatario (para el tipo de conexión de Opportunity Collaboration) o el identificador de la AWS cuenta (para el tipo de conexión de la filial)
+ **Correo electrónico: ** su dirección de correo electrónico de contacto para la comunicación
+ **Nombre: ** su nombre como remitente
+ **Mensaje: ** una descripción que explica el propósito de la solicitud de conexión
Cuando se crea, la invitación pasa al estado pendiente, a la espera de que el destinatario tome medidas.
**importante**
Al enviar una invitación de conexión, aceptas que se revele el identificador de tu AWS cuenta al destinatario si este acepta la invitación. Esta divulgación es necesaria para establecer la conexión a nivel de cuenta.
### Paso 2: Supervise las invitaciones enviadas
Puedes realizar un seguimiento del estado de las invitaciones que has enviado mediante la `ListConnectionInvitations` acción con el `ParticipantType` parámetro establecido en`SENDER`. Esto le permite:
+ Ver todas las invitaciones salientes
+ Filtrar por estado (`PENDING`,`ACCEPTED`,`REJECTED`,`EXPIRED`)
+ Filtrar por tipo de conexión
+ Comprueba las invitaciones específicas a otros socios
### Paso 3: Cancelar una invitación (opcional)
Si necesitas retirar una invitación pendiente antes de que se acepte, puedes usar esta `CancelConnectionInvitation` acción. Tenga en cuenta que:
+ Solo puedes cancelar las invitaciones en estado Pendiente
+ Una vez que se acepta una invitación y se establece una conexión, no se puede cancelar
+ Para finalizar una conexión establecida, debes usar la `CancelConnection` acción en su lugar
## Recibir y responder a las invitaciones de conexión
### Paso 1: Listar las invitaciones entrantes
Para ver las invitaciones de conexión que has recibido, usa la `ListConnectionInvitations` acción con el ParticipantType parámetro establecido en`RECEIVER`. Puedes filtrar por:
+ Tipo de conexión
+ Estado (`PENDING`,`ACCEPTED`,`REJECTED`)
+ Identificador del remitente
### Paso 2: Revisa los detalles de la invitación
Usa esta `GetConnectionInvitation` acción para ver los detalles completos de una invitación específica, incluidos:
+ Nombre del remitente y correo electrónico de contacto
+ Mensaje de invitación explicando el propósito
+ El tipo de conexión que se solicita
+ Fecha de vencimiento
+ Información del perfil público del remitente
### Paso 3: Aceptar o rechazar la invitación
Tras revisar los detalles de la invitación, tienes dos opciones:
#### Opción A: Aceptar la invitación
Usa la `AcceptConnectionInvitation` acción para establecer la conexión. Cuando aceptas:
+ Se crea una nueva conexión en estado Activo
+ El estado de la invitación cambia a Aceptada
+ El remitente revela el identificador de tu AWS cuenta
+ Puede comenzar a realizar las actividades comerciales que permite el tipo de conexión
**importante**
**Consentimiento importante: ** Al aceptar una invitación de conexión, consientes que se revele el identificador de tu AWS cuenta al remitente. Esta divulgación es necesaria para establecer la conexión a nivel de cuenta.
#### Opción B: Rechazar la invitación
Usa la `RejectConnectionInvitation` acción si no deseas establecer la conexión. Si lo desea, puede indicar el motivo del rechazo. Una vez rechazado:
+ El estado de la invitación cambia a Rechazada
+ No se ha establecido ninguna conexión
+ La invitación ya no aparecerá en tu lista de invitaciones pendientes
### Caducidad automática
Si no se realiza ninguna acción dentro del período de caducidad, el sistema pasa automáticamente la invitación al estado Expirada. Las invitaciones caducadas no se pueden aceptar ni rechazar.
## Administrar las conexiones activas
### Visualización de sus conexiones
Una vez que se establece una conexión, ambas partes pueden verla y administrarla mediante las siguientes acciones:
**`ListConnections`: ** Recupera una lista de tus conexiones con opciones de filtrado:
+ Filtre por tipo de conexión y estado (p. ej.,`OPPORTUNITY_COLLABORATION:ACTIVE`)
+ Filtrar por el identificador de la otra parte
+ Ver la información resumida de cada conexión
**`GetConnection`: ** recupere los detalles completos de una conexión específica, incluidos:
+ Todos los tipos de conexión asociados a esta relación de pareja
+ Estado de cada tipo de conexión (activa o finalizada)
+ Información de contacto de la invitación original
+ AWS ID de cuenta e ID de perfil público de ambas partes
+ Marcas de tiempo de creación y finalización para cada tipo de conexión
### Agregar tipos de conexión a una conexión existente
Si ya tiene una conexión activa con un socio y desea establecer un nuevo tipo de relación, puede enviar una nueva invitación de conexión con un tipo de conexión diferente. Tras la aceptación:
+ El nuevo tipo de conexión se añade a la conexión existente
+ Ambos tipos de conexión se pueden administrar de forma independiente
+ Se mantiene el mismo ID de conexión para la relación
**nota**
Solo puede haber una conexión activa de un tipo determinado entre dos cuentas de un catálogo determinado en cualquier momento.
### Finalización de los tipos de conexión
Cualquiera de las partes puede terminar un tipo de conexión específico mediante la `CancelConnection` acción. Al finalizar:
+ Especifique el identificador de la conexión y el tipo de conexión que se va a terminar
+ Indique el motivo de la terminación
+ El estado del tipo de conexión cambia a `CANCELED`
+ Los demás tipos de conexión dentro de la misma conexión no se ven afectados
### Terminación completa de la conexión
Cuando finalizan todos los tipos de conexión de una conexión, la propia conexión pasa al estado Terminado. Una conexión finalizada por completo:
+ No se puede reactivar, pero puedes enviar una nueva solicitud de conexión para continuar trabajando con esa cuenta
+ Permanece en el sistema para mantener un registro histórico
+ Se puede ver mediante la `GetConnection` API
+ Requiere una nueva invitación para restablecer la relación
## Supervisión de los eventos de conexión
Los socios deben supervisar los eventos relacionados con la conexión a través de Amazon EventBridge para mantenerse informados de:
+ Nuevas invitaciones de conexión entrantes
+ Cambios de estado en las invitaciones enviadas (`ACCEPTED`,`REJECTED`,`EXPIRED`)
+ Terminaciones de conexión iniciadas por la otra parte
Al recibir un evento, usa la acción de obtención de la API correspondiente para obtener la información más reciente:
+ `GetConnectionInvitation`para obtener actualizaciones sobre las invitaciones
+ `GetConnection`para actualizaciones de conexión
### Posibles eventos
+ **Invitación de conexión creada: ** notifica a la cuenta del destinatario las invitaciones de conexión entrantes.
+ **Invitación de conexión cancelada: ** notifica a la cuenta del destinatario cuando un remitente cancela una invitación de conexión entrante.
+ **La invitación de conexión ha caducado: ** notifica a las cuentas del remitente y del destinatario cuando una invitación de conexión caduca sin ninguna acción.
+ **Invitación de conexión rechazada: ** notifica a la cuenta del remitente cuando el destinatario rechaza su invitación de conexión.
+ **Invitación de conexión aceptada: ** notifica a la cuenta del remitente cuando se acepta su invitación de conexión y se establece una conexión.
+ **Conexión cancelada: ** notifica a ambas partes conectadas cuando la conexión ha terminado por completo.
## Descripción de los estados de conexión
### Estados de invitación de conexión
| Estado | Description (Descripción) | Puede hacer la transición a |
| --- | --- | --- |
| PENDING | Estado inicial cuando se creó; esperando la acción del receptor | ACCEPTED, REJECTED, EXPIRED, CANCELED |
| ACCEPTED | El receptor ha sido aceptado; se ha creado la conexión | Ninguna (estado terminal) |
| REJECTED | El destinatario ha rechazado; contiene un motivo de rechazo opcional | Ninguno (estado terminal) |
| EXPIRED | System-expired debido a que no se ha realizado ninguna acción dentro del período de caducidad | Ninguna (estado terminal) |
| CANCELED | El remitente retiró la invitación antes de aceptarla | Ninguna (estado terminal) |
### Estados del tipo de conexión
| Estado | Description (Descripción) |
| --- | --- |
| ACCEPTED | El tipo de conexión está operativo; las actividades empresariales asociadas están habilitadas |
| CANCELED | El tipo de conexión finalizó por cualquiera de las partes |
## Prácticas recomendadas
1. **Comunicación clara: incluye ** mensajes claros y detallados en tus invitaciones de conexión explicando el propósito y la colaboración prevista.
1. **Respuestas oportunas: ** supervise y responda a las invitaciones de conexión con prontitud para evitar que caduquen automáticamente.
1. **Revisión periódica: ** revise periódicamente sus conexiones activas para asegurarse de que siguen siendo relevantes para sus necesidades empresariales actuales.
1. **Terminación adecuada: ** Al terminar una relación comercial, utiliza la CancelConnection acción con un motivo claro para mantener una comunicación profesional.
1. **Supervisión de eventos: ** configure EventBridge reglas para recibir automáticamente notificaciones sobre los cambios en el estado de la conexión, a fin de mantenerse informado de las actualizaciones importantes.
1. **Administración del tipo de conexión: ** considere qué tipos de conexión son necesarios antes de establecer las conexiones, ya que cada tipo permite diferentes capacidades empresariales.
1. **Conciencia de seguridad: ** recuerde que al establecer una conexión se revelan los ID de las AWS cuentas entre las partes. Conéctese únicamente con socios de confianza.
## Tipos de conexión y sus propósitos
| Tipo de conexión | Finalidad | Caso de uso |
| --- | --- | --- |
| OPPORTUNITY\_COLLABORATION | Permite la colaboración en oportunidades de venta conjunta con otros socios | Si desea que otro socio tenga acceso a su oportunidad o viceversa, utilice este tipo de conexión. Esta conexión le permite enviar invitaciones para participar en oportunidades a los socios conectados. |
| SUBSIDIARY | Establece conexiones entre tus múltiples cuentas de vendedor de AWS Marketplace y tu cuenta de socio principal | Utilízala cuando tengas varias cuentas de vendedor de AWS Marketplace y quieras conectarlas a tu cuenta principal en la que estás registrado como socio y vendedor. |