

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.

# AWS Elemental MediaPackage eventos
<a name="cloudwatch-events-example"></a>

AWS Elemental MediaPackage se integra con Amazon CloudWatch Events para notificarle determinados eventos que afectan a sus canales y puntos de conexión. Cada evento se representa en [JSON (notación de JavaScript objetos)](http://json.org) y contiene el nombre del evento, la fecha y la hora en que ocurrió el evento, el canal o punto final afectado, y más. MediaPackage emite los eventos en función del mejor esfuerzo posible. Puede usar CloudWatch Events para recopilar estos eventos y configurar reglas que los dirijan a uno o más *destinos*, como AWS Lambda funciones, temas de Amazon SNS, colas de Amazon SQS, transmisiones en Amazon Kinesis Data Streams o destinos integrados.

Para obtener más información sobre el uso de CloudWatch Events con otros tipos de eventos, consulta la [Guía del usuario de Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/).

En los temas siguientes se describen los CloudWatch eventos que se MediaPackage crean.

**Topics**
+ [Eventos de notificación de entrada](#input-state-events)
+ [Eventos de notificación del proveedor de claves](#key-provider-state-events)
+ [Eventos de notificación de trabajos de recopilación](#hj-status-events)

## Eventos de notificación de entrada
<a name="input-state-events"></a>

Recibirá eventos de notificación de entrada para contenido de vídeo bajo demanda (VOD) y en directo. Estos eventos le notifican cuando ocurre algo con MediaPackage la ingesta. Estos son los eventos de notificación de entrada que puede recibir:
+ Superación del número máximo de transmisiones de entrada 
+ Cambio de entrada
+ Cambio de estado de incorporación de VOD
+ Preparación para la reproducción de VOD

Las siguientes secciones describen cada uno de estos eventos.

** Evento de superación del número máximo de transmisiones de entrada **  
En el caso del contenido en directo, el número de entradas de un canal MediaPackage supera la cuota de entradas. Para obtener información sobre cuotas, consulte [Cuotas en AWS Elemental MediaPackage](quotas.md).  

**Example**  

```
{
   "id": "7bf73129-1428-4cd3-a780-95db273d1602",
   "detail-type": "MediaPackage Input Notification",
   "source": "aws.mediapackage",
   "account": "aws_account_id",
   "time": "2015-11-11T21:29:54Z",
   "region": "us-west-2",
   "resources":[
      "arn:aws:mediapackage:us-west-2:aws_account_id:channels/262ff182d46d4b399fcabea1364df682"
   ],
   "detail":{
      "event": "MaxIngestStreamsError",
      "message": "Parent Manifest [%s] has [23] streams, more than [20] allowed: (index_1.m3u8,index_2.m3u8,index_3.m3u8,index_4.m3u8,index_5.m3u8,index_6.m3u8,index_7.m3u8,index_8.m3u8,index_9.m3u8,index_10.m3u8,index_11.m3u8,index_12.m3u8,index_13.m3u8,index_14.m3u8,index_15.m3u8,index_16.m3u8,index_17.m3u8,index_18.m3u8,index_19.m3u8,index_20.m3u8,index_21.m3u8,index_22.m3u8,index_23.m3u8)"
   }
}
```

**Evento de cambio de entrada**  
En el caso del contenido en directo, MediaPackage cambia las entradas de uno de tus puntos finales.   
En un periodo de cinco minutos solo se envía un evento. Si la entrada cambia varias veces en cinco minutos (por ejemplo, si MediaPackage cambia a una entrada y luego vuelve a la otra), solo recibirás un evento.  
Para obtener más información acerca de la redundancia de entrada y qué es que lo hace que las entradas cambien, consulte [Flujo de AWS Elemental MediaPackage procesamiento de redundancia de entradas en vivo](what-is-flow-ir.md).  

**Example**  

```
{
   "id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
   "detail-type": "MediaPackage Input Notification",
   "source": "aws.mediapackage",
   "account": "aws_account_id",
   "time": "2018-07-16T17:29:36Z",
   "region": "us-east-1",
   "resources":[
      "arn:aws:mediapackage:us-east-1:aws_account_id:origin_endpoints/82d6b9bc04cb4612b487963d6c8d0f1a"
   ],
   "detail":{
      "event": "InputSwitchEvent",
      "message": "Origin endpoint experienced an Input Switch Event",
      "EventDetails": {
        "Channel": "channel name",
        "PreviousIngestEndpoint": "endpoint uuid before input switch",
        "CurrentIngestEndpoint": "endpoint uuid after input switch",
      }
   }
}
```

**Evento de estado de incorporación de VOD**  
En el caso del contenido de vídeo bajo demanda (VOD), un activo MediaPackage cambia su estado de ingesta. Recibirá notificaciones sobre los siguientes eventos:  
+ `IngestStart`
+ `IngestError`
+ `IngestComplete`

**Example**  

```
{
   "id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
   "detail-type": "MediaPackage Input Notification",
   "source": "aws.mediapackage",
   "account": "aws_account_id",
   "time": "2019-05-03T17:29:36Z",
   "region": "us-west-2",
   "resources":[

      "arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_name"

   ],
   "detail":{
      "event": "IngestComplete",
      "message": "message text"
   }
}
```

**Evento de reproducción de VOD**  
En el caso del contenido VOD, hay un activo MediaPackage disponible para su reproducción. Hay un período de tiempo entre el momento en el que se completa la incorporación del activo y el momento en que este puede reproducirse. El evento `VodAssetPlayable` significa que ahora MediaPackage puede cumplir con las solicitudes de reproducción del recurso.  
 Obtiene eventos `VodAssetPlayable` individuales para cada configuración de empaquetado de su grupo de empaquetado. Por ejemplo, si su grupo de empaquetado contiene una configuración de empaquetado de DASH y otra de HLS, recibirá dos eventos `VodAssetPlayable`: uno para su configuración de empaquetado de DASH y otro para su configuración de empaquetado de HLS.   

**Example**  

```
{
   "id": "81e896e4-d9e5-ec79-f82a-b4cf3246c567",
   "detail-type": "MediaPackage Input Notification",
   "source": "aws.mediapackage",
   "account": "aws_account_id",
   "time": "2019-11-03T21:46:00Z",
   "region": "us-west-2",
   "resources":[
      "arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_id",
      "arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configuration/packaging_configuration_id"
   ],
   "detail":{
      "event": "VodAssetPlayable",
      "message": "Asset 'asset_id' is now playable for PackagingConfiguration 'packaging_configuration_id'",
      "packaging_configuration_id": "packaging_configuration_id",
      "manifest_urls":[
         "https://555555555555.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/b9cc115bf7f1a/b848dfb116920772aa69ba/a3c74b1cae6a451c/index.m3u8"
      ]
   }
}

{
    "id": "91e896e4-d9e5-ab80-f82a-b4cf3246c568",
    "detail-type": "MediaPackage Input Notification",
    "source": "aws.mediapackage",
    "account": "aws_account_id",
    "time": "2019-11-03T21:47:00Z",
    "region": "us-west-2",
    "resources":[
      "arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_id",
      "arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configuration/packaging_configuration_id"
    ],
    "detail":{
      "event": "VodAssetPlayable",
      "message": "Asset 'asset_id' is now playable for PackagingConfiguration 'packaging_configuration_id'",
      "packaging_configuration_id": "packaging_configuration_id",
      "manifest_urls":[
          "https://111122223333.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/1234567890abc/021345abcdef6789012345/abcdef0123456789/index.mpd"
      ]
    }
}
```

## Eventos de notificación del proveedor de claves
<a name="key-provider-state-events"></a>

Recibes eventos de notificación del proveedor de claves cuando utilizas el cifrado de contenido en un terminal y no MediaPackage puedes comunicarte con el proveedor de claves. Para obtener más información acerca de DRM y el cifrado, consulte [https://docs.aws.amazon.com/speke/latest/documentation/](https://docs.aws.amazon.com/speke/latest/documentation/).

**Example Evento de notificación del proveedor de claves en directo**  

```
{
   "id": "7bf73129-1428-4cd3-a780-98ds273d1602",
   "detail-type": "MediaPackage Key Provider Notification",
   "source": "aws.mediapackage",
   "account": "aws_account_id",
   "time": "2015-11-11T21:29:54Z",
   "region": "us-west-2",
   "resources":[
      "arn:aws:mediapackage:us-west-2:aws_account_id:origin_endpoints/endpoint_id"
   ],
   "detail":{
      "event": "KeyProviderError",
      "message": "message-text"
   }
}
```

**Example Evento de notificación del proveedor de claves de VOD**  

```
{
   "id": "7bf73129-1428-4cd3-a780-98ds273d1602",
   "detail-type": "MediaPackage Key Provider Notification",
   "source": "aws.mediapackage",
   "account": "aws_account_id",
   "time": "2015-11-11T21:29:54Z",
   "region": "us-west-2",
   "resources":[
      "arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configurations/packaging_group_name"
   ],
   "detail":{
      "event": "KeyProviderError",
      "message": "message-text"
   }
}
```

## Eventos de notificación de trabajos de recopilación
<a name="hj-status-events"></a>

Los eventos de estado de los trabajos de recolección se obtienen cuando se exporta un clip de una transmisión en directo para crear un live-to-VOD activo. MediaPackage crea notificaciones cuando el trabajo de recolección se realiza correctamente o no. Para obtener información sobre los live-to-VOD activos y los trabajos de recolección, consulte[Creación de live-to-VOD activos con AWS Elemental MediaPackage](ltov.md).

**Example Evento de trabajo de recopilación realizado con éxito**  

```
{
   "id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
   "detail-type": "MediaPackage HarvestJob Notification",
   "source": "aws.mediapackage",
   "account": "aws_account_id",
   "time": "2019-07-16T17:29:36Z",
   "region": "us-east-1",
   "resources":[
      "arn:aws:mediapackage:us-east-1:aws_account_id:harvest_jobs/harvest_job_id"
   ],
   "detail":{
      "harvest_job": {
          "id": "harvest_job_id",
          "arn": "arn:aws:mediapackage-vod:us-east-1:aws_account_id:harvest_jobs/harvest_job_id",
          "status": "SUCCEEDED",
          "origin_endpoint_id": "endpoint_id",
          "start_time": "2019-06-26T20:30:00-08:00",
          "end_time": "2019-06-26T21:00:00-08:00",
          "s3_destination": {
              "bucket_name": "s3_bucket_name",
              "manifest_key": "path/and/manifest_name/index.m3u8",
              "role_arn": "arn:aws:iam::aws_account_id:role/S3Access_role",
          },
          "created_at": "2019-06-26T21:03:12-08:00"
      }
   }
}
```

**Example Evento de trabajo de recopilación fallido**  

```
{
   "id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
   "detail-type": "MediaPackage HarvestJob Notification",
   "source": "aws.mediapackage",
   "account": "aws_account_id",
   "time": "2019-07-16T17:29:36Z",
   "region": "us-east-1",
   "resources":[
      "arn:aws:mediapackage:us-east-1:aws_account_id:harvest_jobs/harvest_job_id"
   ],
   "detail":{
      "harvest_job": {
          "id": "harvest_job_id",
          "arn": "arn:aws:mediapackage-vod:us-east-1:aws_account_id:harvest_jobs/harvest_job_id",
          "status": "FAILED",
          "origin_endpoint_id": "endpoint_id",
          "start_time": "2019-06-26T20:30:00-08:00",
          "end_time": "2019-06-26T21:00:00-08:00",
          "s3_destination": {
              "bucket_name": "s3_bucket_name",
              "manifest_key": "path/and/manifest_name/index.m3u8",
              "role_arn": "arn:aws:iam::aws_account_id:role/S3Access_role",
          },
          "created_at": "2019-06-26T21:03:12-08:00"
      },
      "message": "Message text"
   }
}
```