

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.

# Uso de eventos de canalizaciones de contenido multimedia de Amazon Chime SDK
<a name="media-pipe-events"></a>

Cada tipo de canal multimedia envía eventos del ciclo de vida, que puede utilizar para activar notificaciones e iniciar flujos de trabajo posteriores. Algunos ejemplos del uso de eventos de Media Pipeline son los siguientes:
+ Procesar el contenido multimedia capturado después de que se haya completado una canalización de contenido multimedia.
+ Notificar a los participantes de la reunión si un canal de medios tiene un fallo temporal.
+ Interrumpir una reunión si un canal de medios falla permanentemente.

Puedes enviar eventos a Amazon EventBridge, Amazon Simple Notification Service (SNS) y Amazon Simple Queue Service (SQS). Para obtener más información, consulta la sección [Eventos de AWS los servicios](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) en la *Guía del EventBridge usuario de Amazon*.

## Creación de canalización de medios de Amazon Chime SDK
<a name="media-pipeline-create"></a>

Amazon Chime SDK envía este evento cuando se crea la canalización de medios.

**Ejemplo: datos del evento**  
 El siguiente es un ejemplo de los datos de este evento.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "version": "0", 
        "eventType": "chime:MediaPipelineInProgress", 
        "timestamp": 1627503649251, 
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706", 
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491", 
        "mediaRegion": "ap-southeast-1"
    }
}
```

## Canalización de medios de Amazon Chime SDK eliminada
<a name="media-pipeline-delete"></a>

Amazon Chime SDK envía este evento cuando la canalización de contenido multimedia se detiene correctamente. 

**Ejemplo: datos del evento**  
El siguiente es un ejemplo de los datos de este evento.

```
{
    "version": "0",
    "id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "365135496707",
    "time": "2021-07-28T20:21:50Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineDeleted",
        "timestamp": 1627503710485,
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
        "mediaRegion": "ap-southeast-1"
    }
}
```

## La canalización de medios de Amazon Chime SDK tiene un error temporal
<a name="pipeline-temp-failure"></a>

Amazon Chime SDK envía este evento cuando se produce un error temporal en la canalización de contenido multimedia.

**Ejemplo: datos del evento**  
El siguiente es un ejemplo de los datos de este evento.

```
{
    "version": "0",
    "id": "abc141e1-fc2e-65e8-5f18-ab5130f1035a",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "365135496707",
    "time": "2021-07-28T21:16:42Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineTemporaryFailure",
        "timestamp": 1627507002882,
        "meetingId": "7a5434e3-724a-4bbb-9eb6-2fb209dc0706",
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "ebd62f4e-04a9-426d-bcb0-974c0f266400",
        "mediaRegion": "eu-south-1"
    }
}
```

## Canalización multimedia de Amazon Chime SDK en progreso
<a name="pipeline-in-progress"></a>

Amazon Chime SDK envía este evento cuando la canalización de contenido multimedia comienza a capturar artefactos.

**Ejemplo: datos del evento**  
El siguiente es un ejemplo de los datos de este evento.

```
{
    "version": "0",
    "id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "365135496707",
    "time": "2021-07-28T20:21:50Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineInProgress",
        "timestamp": 1627503710485?,
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
        "mediaRegion": "ap-southeast-1"
    }
}
```

## Fallo permanente de la canalización de medios de Amazon Chime SDK
<a name="pipeline-perm-failure"></a>

Amazon Chime SDK envía este evento cuando una canalización de contenido multimedia falla permanentemente.

**Ejemplo: datos del evento**  
El siguiente es un ejemplo de los datos de este evento.

```
{
    "version": "0",
    "id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "365135496707",
    "time": "2021-07-28T20:21:50Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelinePermanentFailure",
        "timestamp": 1627503710485,
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
        "mediaRegion": "ap-southeast-1"
    }
}
```

# Configuración de permisos de bucket de Amazon S3 para las canalizaciones de contenido multimedia de Amazon Chime SDK
<a name="s3-permissions"></a>

Si no ha creado un bucket de Amazon S3, asegúrese de crear el suyo en la cuenta y la región en las que celebra las reuniones. Asimismo, asegúrese de otorgar los permisos adecuados al servicio. Para obtener más información sobre crear un bucket de Amazon S3, consulte [Creación de un bucket de Amazon S3 para canalizaciones de captura multimedia de Amazon Chime SDK](create-s3-bucket.md).

# Enviar los eventos de la canalización multimedia del SDK de Amazon Chime a CloudTrail
<a name="pipeline-cloudtrail"></a>

AWS se habilita CloudTrail para usted al crear su AWS cuenta. Cuando un usuario llama a una API compatible en el SDK de Media Pipeline, CloudTrail registra esa actividad de esa API en el **historial de eventos**, junto con otros AWS eventos. Puede ver, buscar y descargar los últimos eventos de la canalización de medios en su cuenta de AWS. Para obtener más información, consulta la sección [Visualización de CloudTrail eventos con el historial](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) de eventos en la *Guía del CloudTrail usuario*.

Para mantener un registro continuo de los eventos de canalización de medios, cree un *registro de seguimiento*. Un rastro permite CloudTrail entregar archivos de registro a su bucket de Amazon S3. En el siguiente ejemplo, se muestra un seguimiento de una canalización de medios. Los datos incluyen el usuario que llamó a la API, el rol de IAM utilizado para llamar a la API y las marcas de tiempo. Para obtener más información sobre el uso, CloudTrail consulte [Registro y supervisión](https://docs.aws.amazon.com/chime-sdk/latest/ag/monitoring-overview.html) en la Guía del *administrador del SDK de Amazon Chime*.

```
{
   "Records": [    
   {
      "eventVersion": "1.08",
      "userIdentity": {
          "type": "AssumedRole",
          "principalId": "ABCDEFGHIJKLMNOPQRSTUV:user-name",
          "arn": "arn:aws:sts::123456789101:assumed-role/role-name/user-name",
          "accountId": "109876543210",
          "accessKeyId": "ABCDEFGHIJKLMNOPQRSTUV",
          "sessionContext": {
              "sessionIssuer": {
                  "type": "Role",
                  "principalId": "ABCDEFGHIJKLMNOPQRSTUV",
                  "arn": "arn:aws:iam::109876543210:role/role-name",
                  "accountId": "012345678910",
                  "userName": "user-name"
                  },
          "webIdFederationData": {},
          "attributes": {
              "mfaAuthenticated": "false",
              "creationDate": "2022-03-08T19:34:55Z"
              }
          }
      },
      "eventTime": "2022-03-08T20:28:41Z",
     "eventSource": "chime-sdk-media-pipelines.amazonaws.com",
     "eventName": "CreateMediaCapturePipeline",
     "awsRegion": "us-east-1",
     "sourceIPAddress": "127.0.0.1",
     "userAgent": "[]/[]",
     "requestParameters": {
         "sourceType": "ChimeSdkMeeting",
         "sourceArn": "Hidden_For_Security_Reasons",
         "sinkType": "S3Bucket",
         "sinkArn": "Hidden_For_Security_Reasons",
         "chimeSdkMeetingConfiguration": {
             "artifactsConfiguration": {
                 "audio": {
                    "muxType": "AudioOnly"
                 },
            "video": {
                "state": "Enabled",
                "muxType": "VideoOnly"
                },
            "content": {
                "state": "Enabled",
                "muxType": "ContentOnly"
                }
            }
        }
      },
     "responseElements": {
        "mediaCapturePipeline": {
        "mediaPipelineId": "pipeline-uuid",
        "sourceType": "ChimeSdkMeeting",
        "sourceArn": "Hidden_For_Security_Reasons",
        "status": "Initializing",
        "sinkType": "S3Bucket",
        "sinkArn": "Hidden_For_Security_Reasons",
        "createdTimestamp": "2022-03-08T20:28:41.336Z",
        "updatedTimestamp": "2022-03-08T20:28:41.463Z",
        "chimeSdkMeetingConfiguration": {
            "artifactsConfiguration": {
                "audio": {
                    "muxType": "AudioOnly"
                },
            "video": {
                "state": "Enabled",
                 "muxType": "VideoOnly"
                 },
             "content": {
                 "state": "Enabled",
                 "muxType": "ContentOnly"
                 }
              }
            }
          }
      },
      "requestID": "request-id",
      "eventID": "event-id",
     "readOnly": false,
      "eventType": "AwsApiCall",
      "managementEvent": true,
      "eventCategory": "Management",
      "recipientAccountId": "112233445566",
      "tlsDetails": {
          "tlsVersion": "TLSv1.2",
          "clientProvidedHostHeader": "example.com"
       }
    },  
  ]
}
```