View a markdown version of this page

Trabajar con conexiones de cuentas de socios - AWS Centro de socios
Creación y envío de una invitación de conexiónRecibir y responder a las invitaciones de conexiónAdministrar las conexiones activasSupervisión de los eventos de conexiónDescripción de los estados de conexiónPrácticas recomendadasTipos de conexión y sus propósitos

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

  2. 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 enSENDER. 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 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 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:

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

  2. Respuestas oportunas: supervise y responda 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. Terminación adecuada: Al terminar una relación comercial, utiliza la CancelConnection acción con un motivo claro para mantener una comunicación profesional.

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

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

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