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 AWS API de Partner Central Channel
Los eventos de la API del canal proporcionan notificaciones en tiempo real sobre los cambios en el estado o los detalles de las actividades relacionadas con el canal. Estos eventos ayudan a mantener sus sistemas sincronizados con AWS Partner Central y ayudan a garantizar respuestas y actualizaciones oportunas.
## Requisitos previos
Necesita los permisos de IAM adecuados para acceder a los eventos y gestionarlos desde la API de AWS Partner Central Channel. Para obtener 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` la que puedes usar para limitar los permisos a tipos de eventos específicos.
El siguiente ejemplo de política muestra cómo personalizar y establecer el alcance de los permisos para los eventos. La `AllowPutRuleForPartnercentralChannelEvents` declaración permite la creación de reglas, pero solo para los eventos de la `aws.partnercentral-channel` 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": "AllowPutRuleForPartnerCentralChannelEvents",
"Effect": "Allow",
"Action": "events:PutRule",
"Resource": "*",
"Condition": {
"StringEquals": {
"events:source": "aws.partnercentral-channel"
}
}
}
]
}
```
## Configurar Amazon EventBridge para monitorizar los eventos
Para monitorear los eventos de la API del canal, 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
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-channel"],
"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 [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='ChannelHandshakeCreatedRule',
EventPattern=
'{
"source": ["aws.partnercentral-channel"],
"detail-type": ["Channel Handshake Created"],
"detail": {"catalog": ["AWS"]}
}',
State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])
```
## Más información sobre los eventos de la API del canal
En las siguientes secciones se describen los tipos de eventos de la API del canal, 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.
+ Se [crea un apretón de manos para el canal](#channel-handshake-created): se activa cuando se crea un nuevo apretón de manos para el canal.
+ Se acepta el [apretón de manos de un canal: se activa cuando se acepta](#channel-handshake-accepted) un nuevo apretón de manos de un canal.
+ Se rechaza el [apretón de manos de un canal: se activa cuando se rechaza](#channel-handshake-rejected) un nuevo apretón de manos de un canal.
### Se ha creado el apretón de manos
En los siguientes ejemplos, se muestran los eventos típicos creados por Channel Handshake para distintos tipos de apretones de manos.
**Inicie el apretón de manos durante el período de servicio:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Created",
"source": "aws.partnercentral-channel",
"account": "789789789789",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-abc123def456g"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "START_SERVICE_PERIOD",
"id": "ch-abc123def456g",
"receiverAccountId": "789789789789",
"ownerAccountId": "123123123123",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"startServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**Revocar el apretón de manos durante el período de servicio:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Created",
"source": "aws.partnercentral-channel",
"account": "789789789789",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-def456ghi789j"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "REVOKE_SERVICE_PERIOD",
"id": "ch-def456ghi789j",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"revokeServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**Apretón de manos para la cuenta de administración del programa:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Created",
"source": "aws.partnercentral-channel",
"account": "456456456456",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-ghi789jkl012m"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "pma-abc123def456g",
"handshakeType": "PROGRAM_MANAGEMENT_ACCOUNT",
"id": "ch-ghi789jkl012m",
"ownerAccountId": "123123123123",
"receiverAccountId": "456456456456",
"senderAccountId": "123123123123",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"programManagementAccountHandshakeDetail": {
"program": "SOLUTION_PROVIDER"
}
}
}
}
```
### Se acepta el apretón de manos de
En los siguientes ejemplos, se muestran los eventos típicos de Channel Handshake Accepted para distintos tipos de apretones de manos.
**Inicie el apretón de manos durante el período de servicio:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Accepted",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-abc123def456g"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "START_SERVICE_PERIOD",
"id": "ch-abc123def456g",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"startServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**Revocar el apretón de manos durante el período de servicio:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Accepted",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-def456ghi789j"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "REVOKE_SERVICE_PERIOD",
"id": "ch-def456ghi789j",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"revokeServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**Apretón de manos para la cuenta de administración del programa:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Accepted",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-ghi789jkl012m"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "pma-abc123def456g",
"handshakeType": "PROGRAM_MANAGEMENT_ACCOUNT",
"id": "ch-ghi789jkl012m",
"ownerAccountId": "123123123123",
"receiverAccountId": "456456456456",
"senderAccountId": "123123123123",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"programManagementAccountHandshakeDetail": {
"program": "SOLUTION_PROVIDER"
}
}
}
}
```
### Se ha rechazado el apretón de manos
En los siguientes ejemplos, se muestran los eventos típicos de rechazo del apretón de manos de un canal para distintos tipos de apretón de manos.
**Inicie el apretón de manos durante el período de servicio:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Rejected",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-abc123def456g"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "START_SERVICE_PERIOD",
"id": "ch-abc123def456g",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"startServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**Revocar el apretón de manos durante el período de servicio:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Rejected",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-def456ghi789j"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "REVOKE_SERVICE_PERIOD",
"id": "ch-def456ghi789j",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"revokeServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**Apretón de manos para la cuenta de administración del programa:**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Rejected",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-ghi789jkl012m"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "pma-abc123def456g",
"handshakeType": "PROGRAM_MANAGEMENT_ACCOUNT",
"id": "ch-ghi789jkl012m",
"ownerAccountId": "123123123123",
"receiverAccountId": "456456456456",
"senderAccountId": "123123123123",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"programManagementAccountHandshakeDetail": {
"program": "SOLUTION_PROVIDER"
}
}
}
}
```