View a markdown version of this page

Trabajar con conexiones de cuentas de socios - AWS Centro de socios
Crear y enviar una invitación de conexiónRecibir y responder a las invitaciones de conexiónAdministración de conexiones activasSupervisión de eventos de conexiónComprensión de los estados de conexiónPrácticas recomendadasTipos de conexión y sus propósitos

Se reestructuró la referencia de la AWS Partner Central API. Para obtener más información sobre las operaciones de API compatibles, consulta la referencia de la AWS Partner Central 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

  2. Fase de conexión activa: gestión de las conexiones establecidas y sus actividades comerciales asociadas

Crear y enviar 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) en el que se gestionará 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, de modo que pueda enviarle invitaciones de oportunidad de colaboración

    • SUBSIDIARY: Usa este tipo cuando quieras conectar varias cuentas de vendedor de AWS Marketplace que poseas a tu cuenta «principal» que hayas vinculado a APN o en la que estés registrado como socio

  • ReceiverIdentifier: el ID de perfil de socio público del destinatario (para el tipo de conexión de Opportunity Collaboration) o el ID de AWS cuenta (para el tipo de conexión de subsidiaria)

  • 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 la acción del destinatario.

importante

Al enviar una invitación de conexión, aceptas revelar tu ID de 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 enSENDER. Esto le permite:

  • Ver todas las invitaciones salientes

  • Filtrar por estado (PENDINGACCEPTED,,REJECTED,EXPIRED)

  • Filtrar por tipo de conexión

  • Consulta 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 utilizar esta CancelConnectionInvitation acción. Tenga en cuenta que:

  • Solo puedes cancelar las invitaciones que estén 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 enRECEIVER. Puedes filtrar por:

  • Tipo de conexión

  • Estado (PENDING,ACCEPTED,REJECTED)

  • Identificador del remitente

Paso 2: Revisa los detalles de la invitación

Usa la GetConnectionInvitation acción para ver los detalles completos de una invitación específica, que incluyen:

  • Nombre y correo electrónico de contacto del remitente

  • Mensaje de invitación en el que se explica el propósito

  • 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

Utilice 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 identificador de tu AWS cuenta se revela al remitente

  • Puede comenzar a realizar actividades comerciales según el tipo de conexión

importante

Consentimiento importante: Al aceptar una invitación de conexión, aceptas revelar tu ID de 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

Utilice la RejectConnectionInvitation acción si no desea establecer la conexión. Si lo desea, puede indicar un motivo de 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

Expiración 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 Expirado. Las invitaciones caducadas no se pueden aceptar ni rechazar.

Administración de conexiones activas

Visualización de sus conexiones

Una vez establecida una conexión, ambas partes pueden verla y administrarla mediante las siguientes acciones:

ListConnections: Recupera una lista de tus conexiones con opciones de filtrado:

  • Filtra por tipo y estado de conexión (por ejemplo,OPPORTUNITY_COLLABORATION:ACTIVE)

  • Filtrar por identificador de otra parte

  • Vea 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

Añadir tipos de conexión a una conexión existente

Si ya tiene una conexión activa con un compañero 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 gestionar de forma independiente

  • Se mantiene el mismo ID de conexión para la relación

nota

Solo puede haber una conexión activa de cualquier tipo entre dos cuentas de un catálogo determinado en cualquier momento.

Finalización de los tipos de conexión

Cualquiera de las partes puede finalizar un tipo de conexión específico mediante esta CancelConnection acción. Al finalizar:

  • Especifique el identificador de conexión y el tipo de conexión que desea finalizar

  • 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 se terminan todos los tipos de conexión de una conexión, la propia conexión pasa al estado Terminada. Una conexión completamente finalizada:

  • No se puede reactivar, pero puedes enviar una nueva solicitud de conexión para seguir trabajando con esa cuenta

  • Permanece en el sistema de registro histórico

  • Se puede ver mediante la API GetConnection

  • Requiere una nueva invitación para restablecer la relación

Supervisión de eventos de conexión

Los socios deben monitorear 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 Get API adecuada para obtener los detalles más recientes:

  • GetConnectionInvitationpara obtener actualizaciones sobre las invitaciones

  • GetConnectionpara 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 que se tome ninguna medida.

  • 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 se termina por completo una conexión.

Comprensió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 al crearse; esperando la acción del receptor ACCEPTED, REJECTED, EXPIRED, CANCELED
ACCEPTED Receptor aceptado; conexión creada Ninguno (estado terminal)
REJECTED El destinatario ha sido rechazado; contiene un motivo de rechazo opcional Ninguno (estado terminal)
EXPIRED System-expired debido a que no se realizó ninguna acción dentro del período de caducidad Ninguno (estado terminal)
CANCELED El remitente retiró la invitación antes de aceptarla Ninguno (estado terminal)

Estados del tipo de conexión

Estado Description (Descripción)
ACCEPTED El tipo de conexión es operativo; las actividades empresariales asociadas están habilitadas
CANCELED Tipo de conexión finalizada por alguna de las partes

Prácticas recomendadas

  1. Comunicación clara: incluya mensajes claros y detallados en sus invitaciones de conexión que expliquen el propósito y la colaboración prevista.

  2. Respuestas oportunas: supervisa y responde a las invitaciones de conexión con prontitud para evitar que caduquen automáticamente.

  3. Revisión periódica: revise periódicamente sus conexiones activas para asegurarse de que siguen siendo relevantes para sus necesidades empresariales actuales.

  4. Rescisión adecuada: al finalizar una relación comercial, utilice la CancelConnection acción con un motivo claro para mantener una comunicación profesional.

  5. Supervisión de eventos: configura EventBridge reglas para recibir automáticamente las notificaciones de los cambios en el estado de la conexión, a fin de mantenerte informado de las actualizaciones importantes.

  6. Administración del tipo de conexión: considere qué tipos de conexión son necesarios antes de establecer conexiones, ya que cada tipo permite diferentes capacidades empresariales.

  7. Atención a la seguridad: recuerde que al establecer una conexión se revelan los identificadores 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 Cuando desee que otro socio tenga acceso a su oportunidad o viceversa, utilice este tipo de conexión. Esta conexión le permite enviar invitaciones de oportunidad de participación a los socios conectados.
SUBSIDIARY Establece conexiones entre tus múltiples cuentas de vendedor de AWS Marketplace y tu cuenta de socio principal Úsala 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.