

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 EventBridge con AWS Elemental MediaConvert
<a name="eventbridge_events"></a>

Puedes usar Amazon EventBridge para monitorear tus AWS Elemental MediaConvert trabajos. Estos son algunos ejemplos de lo que puedes hacer con EventBridge:

**Obtener información sobre las salidas del tarea**  
AWS Elemental MediaConvert proporciona detalles sobre los resultados de su trabajo en la notificación del `COMPLETE` evento. Esta información incluye la ubicación y los nombres de los archivos, como los archivos multimedia y manifiestos del tarea. Para obtener más información, consulte [Eventos con el estado COMPLETO](ev_status_complete.md).  
Para obtener información sobre las estadísticas de empleo enviadas a Amazon CloudWatch, consulte[Uso CloudWatch con MediaConvert](cloudwatch_metrics.md).

**Configura notificaciones por correo electrónico para los cambios de estado de tus tareas**  
Para configurar una regla de EventBridge eventos, consulte[Tutorial: configurar notificaciones por correo electrónico para tareas fallidos](setting-up-cloudwatch-event-rules.md#mediaconvert_sns_tutorial).  
Para ver una lista de todas las notificaciones de los cambios en el estado del tarea para las que puedes configurar reglas de eventos, consulta [Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).

**Monitorizar el progreso de tu tarea**  
Los eventos `STATUS_UPDATE` proporcionan información acerca de la fase en la que se encuentra el tarea (`PROBING`, `TRANSCODING` y `UPLOADING`). En el caso de algunos trabajos, MediaConvert proporciona una estimación del progreso del trabajo. Este cálculo se muestra como un porcentaje del tiempo total desde el momento en el que el tarea deja la cola hasta que los archivos de salida aparecen en el bucket de Amazon S3 de salida.  
Para obtener más información acerca de los eventos de `STATUS_UPDATE`, consulta la tabla de tipos de eventos en [Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).  
Para obtener más información acerca de cómo ajustar la frecuencia de actualizaciones de estado, consulta [Ajuste el intervalo de actualización de estado](adjusting-the-status-update-interval.md).

**Inicie automáticamente el posprocesamiento con una función AWS Lambda **  
Puede configurarlo EventBridge para que una AWS Lambda función inicie el código de posprocesamiento una vez finalizado el trabajo. Para obtener más información sobre el uso de AWS Lambda with AWS Elemental MediaConvert, consulta uno de estos recursos:  
+ En el caso de arquitectos de la nube experimentados, consulta la publicación de [vídeo bajo demanda AWS](https://aws.amazon.com/solutions/video-on-demand-on-aws/) en el blog de *AWS Answers*.
+ Para los desarrolladores nuevos en Lambda, consulte el tutorial sobre cómo [automatizar trabajos MediaConvert con Lambda](https://github.com/aws-samples/aws-media-services-simple-vod-workflow/blob/master/7-MediaConvertJobLambda/README.md) en. MediaConvert GitHub

**Obtenga detalles sobre los trabajos que cree u otras operaciones MediaConvert **  
De forma predeterminada, MediaConvert no emite ningún EventBridge evento para los nuevos trabajos que cree ni para ninguna otra MediaConvert operación que realice. Para recibir EventBridge eventos en estos casos, primero debe crear una AWS CloudTrail ruta.   
Para obtener más información, consulte [Trabajar con CloudTrail senderos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html). 

**nota**  
EventBridge entrega cada evento de la transmisión de MediaConvert eventos al menos una vez.  
MediaConvert no requiere ningún permiso adicional para enviar eventos a EventBridge.

**Topics**
+ [Configuración de EventBridge reglas](setting-up-cloudwatch-event-rules.md)
+ [Supervisar MediaConvert el progreso del trabajo](how-mediaconvert-jobs-progress.md)
+ [Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md)

# Configuración de EventBridge reglas
<a name="setting-up-cloudwatch-event-rules"></a>

Para configurar EventBridge las reglas de Amazon: crea una regla que vincule el evento desde AWS Elemental MediaConvert y el servicio de destino que responde al cambio de estado de tu trabajo, como Amazon Simple Notification Service (Amazon SNS) o. AWS Lambda

Para ver un tutorial sobre cómo configurar una EventBridge regla con AWS Elemental MediaConvert, consulte[Tutorial: configurar notificaciones por correo electrónico para tareas fallidos](#mediaconvert_sns_tutorial).

Para obtener una lista de los eventos que se MediaConvert envían a la secuencia de EventBridge eventos, consulte[Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).

Para obtener más información general sobre el uso EventBridge, consulta la [Guía del EventBridge usuario de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/).

Para obtener información sobre la solución de problemas, consulta [Solución de problemas de Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) en la *Guía EventBridge del usuario de Amazon*. 

**Topics**
+ [Tutorial: configurar notificaciones por correo electrónico para tareas fallidos](#mediaconvert_sns_tutorial)
+ [Paso 1: crear un tema en Amazon SNS](#mediaconvert_sns_create_topic)
+ [Paso 2: especifique un patrón de eventos en una EventBridge regla](#mediaconvert_sns_rule_event_source)
+ [Paso 3: añadir el tema de Amazon SNS; y finalizar su regla](#add-target-and-finish-rule)
+ [Paso 4: Probar la regla](#mediaconvert_sns_test_rule)

## Tutorial: configurar notificaciones por correo electrónico para tareas fallidos
<a name="mediaconvert_sns_tutorial"></a>

En este tutorial, configuras una regla de EventBridge eventos que captura los eventos que ocurren cuando el estado de un trabajo cambia `ERROR` y, a continuación, te notifica sobre el evento. Para ello, primero debes crear un tema en Amazon SNS que enviará una notificación por correo electrónico acerca del tarea fallido. A continuación, debe crear una regla EventBridge definiendo una fuente de eventos y haciendo referencia al tema de Amazon SNS (el «destino»).

## Paso 1: crear un tema en Amazon SNS
<a name="mediaconvert_sns_create_topic"></a>

La primera parte de la configuración de una EventBridge regla consiste en preparar el objetivo de la regla. En este caso, significa crear y suscribirse a un tema de Amazon SNS.

**Para crear un tema de Amazon SNS**

1. [Abra la consola Amazon SNS en https://console.aws.amazon.com/sns/ la versión 3/home.](https://console.aws.amazon.com/sns/v3/home)

1. En el panel de navegación, elige **Temas** y, a continuación, seleccione **Crear tema**.

1. En **Tipo**, seleccione **Estándar**.

1. Para **Nombre**, escriba **MediaConvertJobErrorAlert** y, a continuación, elige **Crear tema**.

1. Elige el **Nombre** del tema que acaba de crear para ver los **Detalles del tema**.

1. **En la página de **detalles del **MediaConvertJobErrorAlert**tema**, en la sección **Suscripciones**, selecciona Crear suscripción.** 

1. En **Protocolo**, elige **Correo electrónico**. Para **Punto de conexión**, introduzca la dirección de correo electrónico a la que desea que Amazon SNS envía la notificación.

1. Elige **Crear una suscripción**.

1. Recibirás un correo electrónico de notificación de Amazon SNS. Cuando lo recibas, elige el enlace **Confirmar suscripción** en el correo electrónico. 

## Paso 2: especifique un patrón de eventos en una EventBridge regla
<a name="mediaconvert_sns_rule_event_source"></a>

En este paso se muestra cómo especificar el patrón de eventos en una EventBridge regla. Esta regla capturará los eventos enviados MediaConvert cuando el estado de un trabajo cambie a`ERROR`. 

**Para configurar un patrón de eventos en una EventBridge regla**

1. Abre la EventBridge consola de Amazon en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. En el panel de navegación, seleccione **Reglas**. Mantenga el **Bus de eventos** **predeterminado** y, a continuación, elige **Crear regla**.

1. En **Nombre**, escriba **MediaConvertJobStateError** y, a continuación, seleccione **Siguiente**.

1. En la sección **Patrón de eventos**, empezando por el **Origen del evento**, elige los siguientes ajustes:
   + **Origen del evento**: **AWS services**
   + **AWS servicio**: **MediaConvert**
   + **Tipo de evento**: **MediaConvert Job State Change**
   + **Estado(s) específico(s) del tipo de evento**: **ERROR**

1. Un cuadro de **Patrón de evento** tendrá un aspecto semejante al siguiente ejemplo. 

   ```
   {
     "source": ["aws.mediaconvert"],
     "detail-type": ["MediaConvert Job State Change"],
     "detail": {
       "status": ["ERROR"]
     }
   }
   ```

   Este código define una regla de EventBridge eventos que coincide con cualquier evento en el que el estado del trabajo cambie a`ERROR`. Para obtener más información sobre los patrones de eventos, consulta [Eventos y patrones de eventos](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatchEventsandEventPatterns.html) en la *Guía del CloudWatch usuario de Amazon*.

1. Elija **Siguiente**.

## Paso 3: añadir el tema de Amazon SNS; y finalizar su regla
<a name="add-target-and-finish-rule"></a>

Añada el tema de Amazon SNS que creó en el paso 1 a la EventBridge regla que inició en el paso 2.

**Para añadir el tema Amazon SNS y finalizar la regla EventBridge**

1. En la sección **Seleccionar objetivos**, en **Seleccionar un objetivo**, elige el **Tema de SNS**.

1. En **Tema**, elija **MediaConvertJobErrorAlert**.

1. Elija **Siguiente**.

1. Como opción, añada una etiqueta. A continuación, elige **Siguiente**.

1. Revise la configuración. A continuación, elige **Crear regla**. 

## Paso 4: Probar la regla
<a name="mediaconvert_sns_test_rule"></a>

Para probar la regla, envía una tarea que sepas que provocará un error. Por ejemplo, especifica una ubicación de entrada que no existe. Si has configurado la regla de evento correctamente, debería recibir un correo electrónico con el siguiente mensaje de texto de evento en unos minutos. 

**Para probar la regla**

1. Abre la AWS Elemental MediaConvert consola en [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).

1. Envíe un nuevo MediaConvert trabajo. Para obtener más información, consulte [Tutorial: configuración de los ajustes de la tarea](setting-up-a-job.md).

1. Comprueba la cuenta de correo electrónico que ha especificado al configurar el tema de Amazon SNS. Confirma que ha recibido una notificación de correo electrónico para el error del tarea.

# Supervisar MediaConvert el progreso del trabajo
<a name="how-mediaconvert-jobs-progress"></a>

MediaConvert proporciona información sobre el estado de cada trabajo que cree. Puede supervisar el estado de una tarea para determinar qué está sucediendo con él, realizar un seguimiento de su progreso o solucionar problemas.

**Topics**
+ [Estados de las tareas](#job-statuses)
+ [Cómo encontrar el estado de una tarea](#finding-job-status)
+ [Fases de la tarea](#job-phase)

## Estados de las tareas
<a name="job-statuses"></a>

Cada tarea que envía pasará por varios estados posibles diferentes. Las tareas realizadas correctamente terminan con un estado `COMPLETE` y las tareas no realizadas correctamente terminan con un estado `ERROR` o `CANCELED`.

**Ejecución de tarea correcta**  
Una tarea realiza correctamente hace que todos sus resultados se escriban en su bucket de Amazon S3. La siguiente lista contiene detalles sobre los diferentes estados por los que pasan las tareas realizadas correctamente:  

1. `SUBMITTED`: trabajos que creó en la MediaConvert consola o mediante una [https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-http-methods](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-http-methods)operación que no MediaConvert ha empezado a procesarse.

1. `INPUT_INFORMATION`: MediaConvert lee los detalles sobre tu entrada o entradas.

1. `PROGRESSING`: MediaConvert comenzó a procesar su trabajo.

1. `STATUS_UPDATE`: MediaConvert ha estado procesando su trabajo durante al menos un minuto o más. Las tareas con este estado pasan por tres *fases de tarea* diferentes. Para obtener más información, consulte [Fases de la tarea](#job-phase).

1. `COMPLETE`: MediaConvert completó su trabajo y todos los resultados se guardaron en su bucket de Amazon S3.
Las tareas realizadas correctamente también pueden incluir los estados [`NEW_WARNING`](ev_status_new_warning.md) o [`QUEUE_HOP`](ev_status_new_warning.md).

**Tareas no realizadas correctamente**  
Si una tarea no se realiza correctamente, no se escribirán resultados en el bucket de Amazon S3, aunque al principio podría progresar de forma similar a la de una tarea realizada correctamente. Las tareas no realizadas correctamente tienen uno de los siguientes dos estados:  
+ `ERROR`: MediaConvert tuve un problema al procesar tu trabajo. Para obtener más información, consulte [Códigos de error](mediaconvert_error_codes.md).
+ `CANCELED`: Has cancelado un trabajo en la MediaConvert consola o mediante una `CancelJob` operación.

## Cómo encontrar el estado de una tarea
<a name="finding-job-status"></a>

Para ver una lista de todos los estados de los trabajos de la región actual, abra la página [Trabajos](https://console.aws.amazon.com/mediaconvert/home#/jobs/list) de la MediaConvert consola. O envíe una operación `GetJob` o `ListJobs`.

AWS CloudTrail registra los detalles de cada solicitud de creación de empleo que realice. CloudTrail solo emite un EventBridge evento para `SUBMITTED` trabajos si también creas una CloudTrail ruta. Para obtener más información, consulte [Trabajar con CloudTrail senderos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html) y [Acceder a los eventos de AWS servicio a través AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) de.

MediaConvert emite un EventBridge evento cuando un trabajo comienza a procesarse y, después, cada vez que su estado cambia, por ejemplo, si cambia de `PROGRESSING` a `COMPLETE` o`ERROR`. Para ver una lista de EventBridge eventos, consulte[Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).

## Fases de la tarea
<a name="job-phase"></a>

Si el estado de un trabajo es `PROGRESSING` de más de un minuto, MediaConvert emite un `STATUS_UPDATE` evento con la *fase* del trabajo actual. Una fase de tarea proporciona detalles sobre lo que está sucediendo con una tarea. Las fases de la tarea avanzan en el siguiente orden:

1. `PROBING`: Cuando su trabajo esté en `PROBING` fase, MediaConvert lee la información de los archivos de entrada que el servicio necesita para la transcodificación.

1. `TRANSCODING`: cuando el tarea se encuentra en la fase de `TRANSCODING`, el servicio realiza la demultiplexación, descodifica, codifica y vuelve a multiplexar el contenido. En algunos tareas, el servicio también comienza a cargar las salidas que van al bucket de Amazon S3 de salida durante esta fase. La fase finaliza cuando se ha completado toda la transcodificación.

1. `UPLOADING`: cuando el tarea se encuentra en la fase de `UPLOADING`, el servicio carga las salidas transcodificados en el bucket de Amazon S3 de salida. En el caso de salidas que el servicio comienza a cargar durante la fase de `TRANSCODING` la fase de `UPLOADING` comienza cuando se ha realizado la transcodificación. Continúa hasta que finalicen todas las cargas.

Para ver la fase de un trabajo, abra la página [Trabajos](https://console.aws.amazon.com/mediaconvert/home#/jobs/list) de la MediaConvert consola, compruebe el [`STATUS_UPDATE` EventBridgeevento](ev_status_status_update.md) o envíe una `GetJob` `ListJobs` operación.

# Lista de MediaConvert EventBridge eventos
<a name="mediaconvert_event_list"></a>

AWS Elemental MediaConvert emite un evento a Amazon EventBridge cuando cambia el estado de un trabajo. Puede crear [EventBridgereglas](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) para cualquiera de estos eventos. 

La mayoría de las tareas solo emitirán algunos de estos eventos, siendo los más comunes: `INPUT_INFORMATION`, `PROGRESSING` y `COMPLETE`.

Para obtener más información sobre cada tipo de evento, elija el enlace de la columna **Evento**.


**MediaConvert eventos**  

| Event | Enviado cuando | Contiene | 
| --- | --- | --- | 
|  [INPUT\$1INFORMATION](ev_status_input_information.md)  |  Poco después MediaConvert comienza a procesar el trabajo.  |  Información multimedia, como el alto y el ancho del fotograma, la velocidad de fotogramas y el códec. Información de MediaConvert casi todas las entradas de un solo evento.  | 
|  [EN CURSO](ev_status_progressing.md)  |  Un tarea pasa del estado `SUBMITTED` al estado `PROGRESSING`.   |  Detalles básicos del tarea.  | 
| [STATUS\$1UPDATE](ev_status_status_update.md) | Aproximadamente un minuto después MediaConvert comienza a procesar el trabajo. Enviado aproximadamente cada minuto después de eso, hasta que se completa la tarea o se encuentra un error. | Progreso del tarea expresado en el número de fotogramas transcodificados desde el inicio del tarea. | 
|  [COMPLETO](ev_status_complete.md)  |  Se completa un trabajo y se MediaConvert escriben todos los resultados correctamente sin errores.  |  Información de salida y advertencias acerca del tarea completado.  | 
| [CANCELADO](ev_status_canceled.md) | Se cancela una tarea. | Detalles básicos del tarea. | 
|  [ERROR](ev_status_error.md)  |  Un tarea tiene un error. Al menos una salida tiene un error.  |  El código o los códigos de error y cualquier mensaje. Incluye cualquier otra información de tarea efímera sobre el estado de error del tarea.   | 
|  [NEW\$1WARNING](ev_status_new_warning.md)  |  Surge una condición de advertencia.  |  El código o los códigos de advertencia y cualquier mensaje de advertencia.  | 
|  [QUEUE\$1HOP](ev_status_queue_hop.md)  |  Cuando una tarea salta colas.  |  Tanto ARNs para las colas como para la prioridad del trabajo dentro de la cola.   | 

**nota**  
MediaConvert no emite ningún evento. `SUBMITTED` Para recibir un EventBridge evento cada vez que realices una llamada a la API, incluidas las llamadas desde la MediaConvert consola, debes crear una AWS CloudTrail ruta. Para obtener más información, consulte [Acceder a los eventos del AWS servicio mediante CloudTrail ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) [rutas AWS CloudTrail y Trabajar con ellas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html).

Cuando se MediaConvert envía un evento a EventBridge, los siguientes campos están presentes en el JSON resultante.
+ **versión**: actualmente 0 (cero) para todos los eventos.
+ **id**: un UUID de versión 4 generado para cada evento.
+ **tipo de detalle**: el tipo de evento que se envía.
+ **origen**: identifica el servicio que generó el evento.
+ **cuenta**: el identificador Cuenta de AWS de 12 dígitos que ejecutó el tarea.
+ **hora**: la hora en que ocurrió el evento.
+ **región**: identifica la Región de AWS del tarea.
+ **recursos**: una matriz JSON que contiene el nombre de recurso de Amazon (ARN) del tarea.
+ **detalle**: un objeto JSON que contiene información sobre el tarea.

Las siguientes secciones contienen los detalles del mensaje del evento, las respuestas de JSON y los patrones de eventos de cada EventBridge evento que se MediaConvert emite.

**Topics**
+ [Eventos con el estado INPUT\$1INFORMATION](ev_status_input_information.md)
+ [Eventos con un estado EN CURSO](ev_status_progressing.md)
+ [Eventos con el estado STATUS\$1UPDATE](ev_status_status_update.md)
+ [Eventos con el estado COMPLETO](ev_status_complete.md)
+ [Eventos con estado CANCELADO](ev_status_canceled.md)
+ [Eventos con el estado ERROR](ev_status_error.md)
+ [Eventos con el estado NEW\$1WARNING](ev_status_new_warning.md)
+ [Eventos con el estado QUEUE\$1HOP](ev_status_queue_hop.md)

# Eventos con el estado INPUT\$1INFORMATION
<a name="ev_status_input_information"></a>

MediaConvert envía el evento para `INPUT_INFORMATION` después de que un trabajo comience a procesarse y después MediaConvert lee la información sobre su entrada. El evento contiene principalmente información multimedia sobre la entrada, como la altura y el ancho del fotograma, la velocidad de fotogramas y el códec.

 MediaConvert incluye información sobre todas tus entradas en un solo evento.

El siguiente JSON es un ejemplo de evento que contiene el estado `INPUT_INFORMATION` de una tarea con una sola entrada.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2022-12-19T19:07:12Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671476818694-phptj0"
    ],
    "detail": {
        "timestamp": 1671476832075,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1671476818694-phptj0",
        "status": "INPUT_INFORMATION",
        "userMetadata": {},
        "inputDetails": [
            {
                "id": 1,
                "uri": "s3://amzn-s3-demo-bucket/file/file.mp4",
                "audio": [
                    {
                        "channels": 2,
                        "codec": "AAC",
                        "language": "UND",
                        "sampleRate": 44100,
                        "streamId": 2
                    }
                ],
                "video": [
                    {
                        "bitDepth": 8,
                        "codec": "H_264",
                        "colorFormat": "YUV_420",
                        "fourCC": "avc1",
                        "frameRate": 24,
                        "height": 1080,
                        "interlaceMode": "PROGRESSIVE",
                        "sar": "1:1",
                        "standard": "UNSPECIFIED",
                        "streamId": 1,
                        "width": 1920
                    }
                ]
            }
        ]
    }
}
```

Puede usar el siguiente ejemplo de JSON para crear un patrón de EventBridge eventos para trabajos con un estado de`INPUT_INFORMATION`.

```
{
  "source": ["aws.mediaconvert"],
  "detail-type": ["MediaConvert Job State Change"],
  "detail": {
    "status": ["INPUT_INFORMATION"]
  }
}
```

# Eventos con un estado EN CURSO
<a name="ev_status_progressing"></a>

MediaConvert envía el evento para `PROGRESSING` cuando un trabajo se traslada de un `SUBMITTED` estado a otro`PROGRESSING`.

**nota**  
Después de que una tarea se haya encontrado en el estado `PROGRESSING` durante 48 horas, el servicio lo cambia a un estado `ERROR` y deja de trabajar en él. No se te cobrarán las tareas que terminan en un estado `ERROR`.

El siguiente JSON es un ejemplo de evento que contiene el estado `PROGRESSING` de una tarea.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2022-12-19T19:20:21Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671477617078-2886ye"
    ],
    "detail": {
        "timestamp": 1671477621654,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1671477617078-2886ye",
        "status": "PROGRESSING",
        "userMetadata": {}
    }
}
```

Puede usar el siguiente ejemplo de JSON para crear un patrón de EventBridge eventos para trabajos con un estado de`PROGRESSING`.

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["PROGRESSING"]
    }
}
```

# Eventos con el estado STATUS\$1UPDATE
<a name="ev_status_status_update"></a>

MediaConvert envía el evento durante `STATUS_UPDATE` aproximadamente un minuto después de que comience a procesar un trabajo. De forma predeterminada, las actualizaciones se envían aproximadamente cada minuto después de eso, hasta que el servicio completa la transcodificación o encuentra un error.

Si quieres, puedes especificar una frecuencia de actualización diferente en tu tarea, con la configuración **Intervalo de actualización de estado**. Para obtener actualizaciones más frecuentes, puedes elegir 10, 12, 15, 20 o 30 segundos. Para obtener menos actualizaciones, puedes elegir de 2 a 10 minutos, en incrementos de un minuto. Para obtener más información, consulta [Ajuste el intervalo de actualización de estado](adjusting-the-status-update-interval.md).

Un evento `STATUS_UPDATE` contiene información sobre la fase actual de tu tarea. Cuando está disponible, contiene el porcentaje de finalización del tarea y de la fase.

Las fases del tarea son las siguientes:
+ Durante `PROBING`, el servicio lee información acerca de la entrada mientras se prepara para la transcodificación. 
+ Durante `TRANSCODING`, el servicio realiza la demultiplexación, descodifica, codifica y vuelve a multiplexar el contenido. Durante esta fase, en algunos tareas, el servicio también comienza a cargar las salidas que van al bucket de Amazon S3 de salida. La fase finaliza cuando se ha completado toda la transcodificación.
+ Durante `UPLOADING`, el servicio carga el resto de salidas transcodificados a su bucket de Amazon S3.

El siguiente JSON es un ejemplo de evento que contiene el estado `STATUS_UPDATE` de una tarea.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2022-12-19T19:21:21Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671477617078-2886ye"
    ],
    "detail": {
        "timestamp": 1671477681737,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1671477617078-2886ye",
        "status": "STATUS_UPDATE",
        "userMetadata": {},
        "framesDecoded": 353,
        "jobProgress": {
            "phaseProgress": {
                "PROBING": {
                    "status": "COMPLETE",
                    "percentComplete": 100
                },
                "TRANSCODING": {
                    "status": "PROGRESSING",
                    "percentComplete": 2
                },
                "UPLOADING": {
                    "status": "PENDING",
                    "percentComplete": 0
                }
            },
            "jobPercentComplete": 7,
            "currentPhase": "TRANSCODING",
            "retryCount": 0
        }
    }
}
```

Puede usar el siguiente ejemplo de JSON para crear un patrón de EventBridge eventos para trabajos con un estado de`STATUS_UPDATE`.

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["STATUS_UPDATE"]
    }
}
```

# Ajuste el intervalo de actualización de estado
<a name="adjusting-the-status-update-interval"></a>

De forma predeterminada, AWS Elemental MediaConvert envía `STATUS_UPDATE` los eventos a Amazon EventBridge aproximadamente una vez por minuto. Estas actualizaciones de estado proporcionan información sobre el progreso de su tarea. Esto le permite conocer el progreso de su tarea. Puede ajustar el intervalo de actualización de estado especificando una frecuencia de actualización diferente en su tarea.

**Para especificar la frecuencia STATUS\$1UPDATE**

1. En la página **Crear tarea**, en el panel **Tarea** de la izquierda, en la sección **Configuración de tarea**, elige **integración AWS **.

1. En la sección **integración AWS ** de la derecha, en **Intervalo de actualización de estado(s)**, elige el **intervalo, en segundos, entre actualizaciones.**.

Si utiliza la API o un SDK, encontrarás esta configuración en el archivo JSON de tu tarea. El nombre de la configuración es [statusUpdateInterval](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-createjobrequest-statusupdateinterval).

# Eventos con el estado COMPLETO
<a name="ev_status_complete"></a>

MediaConvert envía el evento para `COMPLETE` cuando todos los resultados se escriban en Amazon S3 sin errores. Contiene las advertencias y la información de salida del tarea completado. Para obtener más información acerca de los nombres y las rutas de los archivos de salida, consulta [Rutas y nombres de archivo de salida](output-file-names-and-paths.md).

El siguiente JSON es un ejemplo de evento que contiene el estado `COMPLETE` de una tarea.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2022-12-19T19:07:12Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2::jobs/1671476818694-phptj0"
    ],
    "detail": {
        "timestamp": 1671476832124,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1671476818694-phptj0",
        "status": "COMPLETE",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/file/file.mp4"
                        ],
                        "durationInMs": 30041,
                        "videoDetails": {
                            "widthInPx": 1920,
                            "heightInPx": 1080,
                            "qvbrAvgQuality": 7.38,
                            "qvbrMinQuality": 7,
                            "qvbrMaxQuality": 8,
                            "qvbrMinQualityLocation": 2168,
                            "qvbrMaxQualityLocation": 25025
                        }
                    }
                ],
                "type": "FILE_GROUP"
            }
        ],
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ]
    }
}
```

Los eventos `COMPLETE` contienen información adicional sobre tu tarea y sus resultados. En la siguiente tabla se enumeran y describen las diferentes propiedades disponibles en los detalles del mensaje de evento de tarea.


**Detalles del mensaje de evento COMPLETO**  

| Propiedad | Tipo de datos: | Details | 
| --- | --- | --- | 
|  `paddingInserted`  |  entero  | La duración total de los fotogramas en blanco MediaConvert insertados en todos los resultados de su trabajo, en milisegundos. El relleno de vídeo inserta fotogramas en blanco para ayudar a mantener alineadas las duraciones de audio y vídeo. Los valores altos de `paddingInserted` indican que se han insertado más fotogramas en blanco. Estos valores también muestran hasta qué punto las pistas de audio de entrada comienzan tarde o terminan antes, o ambas cosas. | 
|  `qvbrAvgQuality`  |  float  |  La calidad de video promedio de la salida de velocidad de bits variable definida en función de la calidad (Quality-Defined Variable Bitrate, QVCR). Se incluye solo para las salidas QVBR.  | 
|  `qvbrMinQuality`  |  float  |  La calidad de vídeo mínima detectada en la salida QVBR.  Se incluye solo para las salidas QVBR.  | 
|  `qvbrMaxQuality`  |  float  |  La calidad de vídeo máxima detectada en la salida QVBR. Se incluye solo para las salidas QVBR.  | 
|  `qvbrMinQualityLocation`  |  entero  |  La ubicación de la salida en la que `qvbrMinQuality` se detectó, en milisegundos. Puedes utilizar `qvbrMinQualityLocation` mientras revisa la calidad del vídeo de salida y el uso del ancho de banda. Se incluye solo para las salidas QVBR.  | 
|  `qvbrMaxQualityLocation`  |  entero  |  La ubicación de la salida en la que `qvbrMaxQuality` se detectó, en milisegundos. Puedes utilizar `qvbrMaxQualityLocation` mientras revisa la calidad del vídeo de salida y el uso del ancho de banda. Se incluye solo para las salidas QVBR.  | 
|  `warnings`  code  count  |  array entero entero  |  Todos los códigos de advertencia detectados en el tarea y el número de veces que se han producido. Para obtener más información, consulta [Códigos de advertencia](warning_codes.md).  | 
|  `blackVideoDetected`  |  entero  |  La duración total de los fotogramas de vídeo negro en las salidas que también están presentes en las entradas, en milisegundos. `blackVideoDetected`no incluye ningún marco negro insertado por MediaConvert.  | 
|  `blackVideoSegments`  `start`  `end`  |  array entero entero  |  La ubicación o ubicaciones de la salida en las que se detectaron fotogramas de vídeo negro. Cada segmento de vídeo negro de la salida se muestra con su propio inicio y final. `blackVideoSegments`no incluye ningún marco negro insertado por MediaConvert.  | 
|  `averageBitrate`  |  entero  |  La velocidad de bits media de la salida de vídeo, calculada dividiendo la duración por el total de bits.  | 

Puede usar el siguiente ejemplo de JSON para crear un patrón de EventBridge eventos para los trabajos con un estado de`COMPLETE`.

```
{
  "source": ["aws.mediaconvert"],
  "detail-type": ["MediaConvert Job State Change"],
  "detail": {
    "status": ["COMPLETE"]
  }
}
```

# Rutas y nombres de archivo de salida
<a name="output-file-names-and-paths"></a>

La `COMPLETE` notificación de EventBridge trabajo incluye detalles sobre tu salida en JSON. Esta información incluye los nombres de los archivos y las rutas de las salidas de la tarea, incluidos los manifiestos y los recursos multimedia.

Los archivos que se AWS Elemental MediaConvert crean dependen de los grupos de salida que configure en el trabajo. Por ejemplo, los paquetes DASH ISO contienen un manifiesto .mpd y archivos de fragmento de contenido multimedia .mp4.

Puedes encontrar información sobre la ruta y el nombre de los archivos de salida en las propiedades siguientes:

`playlistFilePaths`  
Una lista de las rutas de los archivos de Amazon S3 a las listas de reproducción multivariantes.

`outputFilePaths`  
La ruta al archivo multimedia o el manifiesto, en función del tipo de grupo de salida.

`type`  
El tipo de grupo de salidas, que determina qué archivos se muestran en `playlistFilePaths` y `outputFilePaths`.

En la tabla siguiente se indican los valores de estas propiedades, en función del tipo de grupo de salida.


| Tipo | playlistFilePaths | outputFilePaths | 
| --- | --- | --- | 
| FILE\$1GROUP (salida estándar) | no se devuelve |  Ruta y nombre del archivo multimedia. Ejemplo: `s3://amzn-s3-demo-bucket/file/file.mp4`  | 
| FILE\$1GROUP (con salida de captura de fotogramas adicional) | no se devuelve |  Nombre de archivo y ruta de la imagen final capturada. Ejemplo: `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`  | 
| HLS\$1GROUP |  Nombre del archivo y ruta de la lista de reproducción multivariante. Ejemplo: `s3://amzn-s3-demo-bucket/hls/main.m3u8`  |  Nombre de archivo y ruta de los manifiestos para las salidas individuales. Ejemplos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/mediaconvert/latest/ug/output-file-names-and-paths.html)  | 
| DASH\$1ISO\$1GROUP |  Nombre de archivo y ruta del manifiesto. Ejemplo: `s3://amzn-s3-demo-bucket/dash/1.mpd`  | no se devuelve | 
| CMAF\$1GROUP |  Nombre de archivo y ruta de cada uno de los manifiestos de nivel superior. Ejemplos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/mediaconvert/latest/ug/output-file-names-and-paths.html)  | no se devuelve | 
| MS\$1SMOOTH\$1GROUP |  Nombre de archivo y ruta del manifiesto del lado servidor. Ejemplo: `s3://amzn-s3-demo-bucket/smooth/1.ism`  |  Nombre de archivo y ruta de los manifiestos de vídeo para cada una de las salidas individuales. Ejemplos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/mediaconvert/latest/ug/output-file-names-and-paths.html)  | 

Para obtener respuestas en JSON para cada tipo de grupo de salida, consulta los temas siguientes:

**Topics**
+ [Grupo de archivos](file-group.md)
+ [Grupo de archivos con una salida de captura de fotogramas](file-group-with-frame-capture-output.md)
+ [Grupo de Apple HLS](apple-hls-group.md)
+ [Grupo DASH ISO](dash-iso-group.md)
+ [Grupo de CMAF](cmaf-group.md)
+ [Grupo de Microsoft Smooth Streaming](microsoft-smooth-streaming-group.md)

# Grupo de archivos
<a name="file-group"></a>

El siguiente es un EventBridge ejemplo de evento de Amazon para un trabajo con un `COMPLETE` estado. El ejemplo incluye información sobre la ruta del archivo de salida de un grupo de archivos.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            "start": 0,
            "end": 10
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/file/file.mp4"
                        ],
                        "durationInMs": 180041,
                        "videoDetails": {
                            "averageBitrate": 200000,
                            "widthInPx": 1280,
                            "heightInPx": 720,
                            "qvbrAvgQuality": 7.38,
                            "qvbrMinQuality": 7,
                            "qvbrMaxQuality": 8,
                            "qvbrMinQualityLocation": 2168,
                            "qvbrMaxQualityLocation": 25025
                        },
                    }
                ],
                "type": "FILE_GROUP"
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ],
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**nota**  
Las estadísticas de QVCR solo están disponibles cuando la salida de video utiliza el control de velocidad de bits variable definida en función de la calidad (QVCR).

# Grupo de archivos con una salida de captura de fotogramas
<a name="file-group-with-frame-capture-output"></a>

Esta guía proporciona un EventBridge ejemplo de evento de Amazon para un trabajo con un `COMPLETE` estado. Además, muestra información de la ruta del archivo de salida para un grupo de archivos con salida de captura de fotogramas. 

Una *salida de captura de fotogramas* es una salida que se configura para crear imágenes fijas de vídeo. Se configura de forma similar a un grupo de salidas de un **grupo de archivos** normal. Sin embargo, se elimina el componente de audio, se selecciona **Sin contenedor** como contenedor y, a continuación, se selecciona **Captura de fotogramas a JPEG** como códec de vídeo.

**nota**  
Puede crear salidas de captura de fotogramas solo en trabajos que también tengan una salida de audio y vídeo normal. MediaConvert no admite trabajos que consistan únicamente en una salida de captura de fotogramas.

Al crear una salida de captura de fotogramas, el estado `COMPLETE` incluye la propiedad `outputFilePaths`. Esto le dice el nombre de archivo y ruta de la imagen final capturada. 

**sugerencia**  
Dado que el servicio incluye numeración automática en los nombres de archivo de captura de fotogramas, puedes inferir todos los nombres de imagen a partir de la imagen final. Por ejemplo, si su valor `outputFilePaths` es `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`, puedes inferir que hay 35 imágenes más en la misma ubicación, denominadas `file.0000001`, `file.0000002` y así sucesivamente.

El siguiente es un EventBridge ejemplo de un evento para un trabajo con un `COMPLETE` estado. Incluye información de la ruta del archivo de salida para un grupo de archivos con salida de captura de fotogramas. 

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
                {
                    "start": 0,
                    "end": 10
                }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg"
                        ],
                        "durationInMs": 185000,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720
                        }
                    }
                ],
                "type": "FILE_GROUP"
            },
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/file/file.mp4"
                        ],
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    }
                ],
                "type": "FILE_GROUP"
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**nota**  
Las estadísticas de velocidad de bit variable definida en función de la calidad (QVCR) solo están disponibles cuando la salida de video utiliza el control de velocidad QVBR.

# Grupo de Apple HLS
<a name="apple-hls-group"></a>

El siguiente es un EventBridge ejemplo de evento de Amazon para un trabajo con un `COMPLETE` estado. Incluye información sobre la ruta del archivo de salida de un grupo de Apple HLS.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/hls/mainv2.m3u8"
                        ],
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 426,
                            "heightInPx": 240,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    },
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/hls/mainv1.m3u8"
                        ],
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    }
                ],
                "type": "HLS_GROUP",
                "playlistFilePaths": [
                    "s3://amzn-s3-demo-bucket/hls/main.m3u8"
                ]
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**nota**  
Las estadísticas de velocidad de bit variable definida en función de la calidad (QVCR) solo están disponibles cuando la salida de video utiliza el control de velocidad QVBR.

# Grupo DASH ISO
<a name="dash-iso-group"></a>

El siguiente es un EventBridge ejemplo de evento de Amazon para un trabajo con un `COMPLETE` estado. Incluye información sobre la ruta del archivo de salida de un grupo de DASH ISO.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    }
                ],
                "type": "DASH_ISO_GROUP",
                "playlistFilePaths": [
                    "s3://amzn-s3-demo-bucket/dash/1.mpd"
                ]
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**nota**  
Las estadísticas de velocidad de bit variable definida en función de la calidad (QVCR) solo están disponibles cuando la salida de video utiliza el control de velocidad QVBR.

# Grupo de CMAF
<a name="cmaf-group"></a>

El siguiente es un EventBridge ejemplo de un evento para un trabajo con un `COMPLETE` estado. Incluye información sobre la ruta del archivo de salida de un grupo CMAF.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                            "durationInMs": 180041,
                            "blackVideoDurationInMs": 0,
                            "videoDetails": {
                                "widthInPx": 1280,
                                "heightInPx": 720,
                                "averageQVBRScore": 7.38,
                                "minimumQVBRScore": 7,
                                "maximumQVBRScore": 8,
                                "minimumQVBRScoreLocationInMs": 2168,
                                "maximumQVBRScoreLocationInMs": 25025
                            }
                    }
                ],
                "type": "CMAF_GROUP",
                "playlistFilePaths": [
                    "s3://amzn-s3-demo-bucket/cmaf/1.mpd",
                    "s3://amzn-s3-demo-bucket/cmaf/1.m3u8"
                ]
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**nota**  
Las estadísticas de velocidad de bit variable definida en función de la calidad (QVCR) solo están disponibles cuando la salida de video utiliza el control de velocidad QVBR.

# Grupo de Microsoft Smooth Streaming
<a name="microsoft-smooth-streaming-group"></a>

El siguiente es un EventBridge ejemplo de un evento para un trabajo con un `COMPLETE` estado. Incluye información sobre la ruta del archivo de salida para un grupo de Microsoft Smooth Streaming.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/smooth/1_va.ismv"
                        ],
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 534,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    }
                ],
                "type": "MS_SMOOTH_GROUP",
                "playlistFilePaths": [
                    "s3://amzn-s3-demo-bucket/smooth/1.ism"
                ]
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**nota**  
Las estadísticas de velocidad de bit variable definida en función de la calidad (QVCR) solo están disponibles cuando la salida de video utiliza el control de velocidad QVBR.

# Eventos con estado CANCELADO
<a name="ev_status_canceled"></a>

MediaConvert envía el evento para `CANCELED` cuando se cancele el trabajo. Contiene detalles básicos del tarea incluyendo `timestamp`, `accountID`, `queue`, `jobId` y `userMetadata`.

El siguiente JSON es un ejemplo de evento que contiene el estado `CANCELED` de una tarea.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-01-07T23:35:20Z",
    "region": "us-west-2",
    "resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
    "detail": {
        "timestamp": 1515368120764,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1515368087458-qnoxtd",
        "status": "CANCELED",
        "userMetadata": {}
    }
}
```

Puede usar el siguiente ejemplo de JSON para crear un patrón de EventBridge eventos para los trabajos con un estado de`CANCELED`.

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["CANCELED"]
    }
}
```

# Eventos con el estado ERROR
<a name="ev_status_error"></a>

MediaConvert envía el evento `ERROR` cuando al menos una salida tiene un error. Contiene el código o los códigos de error, mensajes y advertencias u otra información de tarea efímero sobre el estado de error del tarea. Para obtener más información sobre los códigos de error, consulta [Códigos de error](mediaconvert_error_codes.md).

El siguiente JSON es un ejemplo de evento que contiene el estado `ERROR` de una tarea.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-01-07T23:35:20Z",
    "region": "us-west-2",
    "resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
    "detail": {
        "timestamp": 1515368120764,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1515368087458-qnoxtd",
        "status": "ERROR",
        "errorCode": 1040,
        "errorMessage": "Example error message",
        "userMetadata": {}
    }
}
```

Puede usar el siguiente ejemplo de JSON para crear un patrón de EventBridge eventos para trabajos con un estado de`ERROR`.

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["ERROR"]
    }
}
```

# Eventos con el estado NEW\$1WARNING
<a name="ev_status_new_warning"></a>

MediaConvert envía un evento para `NEW_WARNING` cuando se produce una condición de advertencia. Una condición de advertencia no detiene la ejecución del tarea. Contiene el ARN de la cola de envío, el ID del tarea y un mensaje de advertencia. Los mensajes de advertencia le informan sobre condiciones que no detienen la tarea, pero que pueden indicar que la tarea no está progresando según lo planeado.

Por ejemplo, una tarea configurado para saltar colas ha alcanzado el tiempo de espera que especificó, pero no puedes saltar.

`NEW_WARNING` solo contiene el mensaje de advertencia más reciente. No informa de las advertencias anteriores, incluso si esas condiciones de advertencia siguen vigentes.

Para obtener más información acerca de los mensajes de advertencia, consulta [Códigos de advertencia](warning_codes.md).

El siguiente JSON es un ejemplo de evento que contiene el estado `NEW_WARNING` de una tarea.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-01-07T23:35:20Z",
    "region": "us-west-2",
    "resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
    "detail": {
        "timestamp": 1515368120764,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1515368087458-qnoxtd",
        "status": "NEW_WARNING",
        "warningCode": "000000",
        "warningMessage": "Example warning message",
        "userMetadata": {}
    }
}
```

Puede usar el siguiente ejemplo de JSON para crear un patrón de EventBridge eventos para los trabajos con un estado de`NEW_WARNING`.

```
{
  "source": ["aws.mediaconvert"],
  "detail-type": ["MediaConvert Job State Change"],
  "detail": {
    "status": ["NEW_WARNING"]
  }
}
```

# Eventos con el estado QUEUE\$1HOP
<a name="ev_status_queue_hop"></a>

MediaConvert envía el `QUEUE_HOP` evento cuando un trabajo pasa de una cola a otra. Contiene las ARNs dos colas y la prioridad del trabajo dentro de las colas.

Tanto `priority` como `previousPriority` serán iguales, a menos que la configuración de saltos de cola especifica una nueva prioridad para el tarea cuando salte de una cola a otra.

El siguiente JSON es un ejemplo de evento que contiene el estado `QUEUE_HOP` de una tarea.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-01-07T23:35:20Z",
    "region": "us-west-2",
    "resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
    "detail": {
        "timestamp": 1515368120764,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "previousQueue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Alternate",
        "priority": 0,
        "previousPriority": 0,
        "jobId": "1515368087458-qnoxtd",
        "status": "QUEUE_HOP",
        "userMetadata": {}
    }
}
```

Puede usar el siguiente ejemplo de JSON para crear un patrón de EventBridge eventos para los trabajos con un estado de. `QUEUE_HOP`

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["QUEUE_HOP"]
    }
}
```

