As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Usando EventBridge com AWS Elemental MediaConvert
Você pode usar EventBridge a Amazon para monitorar seus AWS Elemental MediaConvert trabalhos. Aqui estão alguns exemplos do que você pode fazer com EventBridge:
**Obtenha detalhes sobre suas saídas de tarefa**
AWS Elemental MediaConvert fornece detalhes sobre seus resultados de trabalho na notificação do `COMPLETE` evento. Essas informações incluem o local e nomes de arquivos de mídia do trabalho e manifestos. Para obter detalhes, consulte [Eventos com status COMPLETO](ev_status_complete.md).
Para obter informações sobre métricas de trabalho enviadas para a Amazon CloudWatch, consulte[Usando CloudWatch com MediaConvert](cloudwatch_metrics.md).
**Configure notificações por e-mail para alterações de status do seu trabalho**
Para configurar uma regra de EventBridge evento, consulte[Tutorial: configurar notificações de e-mail para trabalhos com falha](setting-up-cloudwatch-event-rules.md#mediaconvert_sns_tutorial).
Para obter uma lista de todas as notificações de alteração de status de tarefa para as quais você pode configurar regras de evento, consulte [Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).
**Monitore o andamento da tarefa**
Eventos `STATUS_UPDATE` fornecem informações sobre a fase de seu trabalho (`PROBING`, `TRANSCODING`, e `UPLOADING`). Para alguns trabalhos, MediaConvert fornece uma estimativa de quanto seu trabalho progrediu. Essa estimativa é mostrada como uma porcentagem do tempo total desde o momento em que o trabalho sai da fila até o momento em que os arquivos de saída aparecem no bucket de saída do Amazon S3.
Para obter mais informações sobre eventos `STATUS_UPDATE`, consulte a tabela de tipos de evento em [Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).
Para obter informações sobre como ajustar a frequência de atualizações de status, consulte [Ajustar o intervalo de atualização de status](adjusting-the-status-update-interval.md).
**Inicie automaticamente o pós-processamento com uma função AWS Lambda **
Você pode configurar EventBridge para que uma AWS Lambda função inicie seu código de pós-processamento após a conclusão do trabalho. Para obter mais informações sobre como usar AWS Lambda com AWS Elemental MediaConvert, consulte um destes recursos:
+ Para arquitetos de nuvem experientes, consulte a publicação [Vídeo sob demanda na AWS](https://aws.amazon.com/solutions/video-on-demand-on-aws/) no blog *AWS Answers*.
+ Para desenvolvedores iniciantes no Lambda, consulte o tutorial [Automatizando trabalhos MediaConvert com o Lambda](https://github.com/aws-samples/aws-media-services-simple-vod-workflow/blob/master/7-MediaConvertJobLambda/README.md) sobre. MediaConvert GitHub
**Obtenha detalhes sobre trabalhos que você cria ou outras MediaConvert operações**
Por padrão, MediaConvert não emite um EventBridge evento para novos trabalhos que você cria ou qualquer outra MediaConvert operação que você executa. Para receber EventBridge eventos nesses casos, primeiro você deve criar uma AWS CloudTrail trilha.
Para obter mais informações, consulte Como [trabalhar com CloudTrail trilhas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html).
**nota**
EventBridge entrega cada evento do stream de MediaConvert eventos pelo menos uma vez.
MediaConvert não exige nenhuma permissão adicional para realizar eventos EventBridge.
**Topics**
+ [Configurando EventBridge regras](setting-up-cloudwatch-event-rules.md)
+ [Monitorando MediaConvert o progresso do trabalho](how-mediaconvert-jobs-progress.md)
+ [Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md)
# Configurando EventBridge regras
Para configurar EventBridge as regras da Amazon: Crie uma regra que vincule o evento AWS Elemental MediaConvert e o serviço de destino que responde à mudança de status do seu trabalho, como Amazon Simple Notification Service (Amazon SNS) ou. AWS Lambda
Para obter um tutorial sobre como configurar uma EventBridge regra com AWS Elemental MediaConvert, consulte[Tutorial: configurar notificações de e-mail para trabalhos com falha](#mediaconvert_sns_tutorial).
Para obter uma lista dos eventos MediaConvert enviados no fluxo de EventBridge eventos, consulte[Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).
Para obter mais informações gerais sobre o uso EventBridge, consulte o [Guia EventBridge do usuário da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/).
Para obter informações sobre solução de problemas, consulte [Solução de problemas da Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) *no Guia EventBridge do usuário da Amazon*.
**Topics**
+ [Tutorial: configurar notificações de e-mail para trabalhos com falha](#mediaconvert_sns_tutorial)
+ [Etapa 1: criar um tópico no Amazon SNS](#mediaconvert_sns_create_topic)
+ [Etapa 2: especificar um padrão de evento em uma EventBridge regra](#mediaconvert_sns_rule_event_source)
+ [Etapa 3: adicionar o tópico do Amazon SNS e finalizar sua regra](#add-target-and-finish-rule)
+ [Etapa 4: testar a regra](#mediaconvert_sns_test_rule)
## Tutorial: configurar notificações de e-mail para trabalhos com falha
Neste tutorial, você configura uma regra de EventBridge evento que captura eventos quando o status de um trabalho muda para `ERROR` e, em seguida, notifica você sobre o evento. Para fazer isso, você primeiro cria um tópico no Amazon SNS que enviará uma notificação por e-mail sobre o trabalho com falha. Em seguida, você cria uma regra EventBridge definindo uma fonte de eventos e referenciando o tópico do Amazon SNS (o “destino”).
## Etapa 1: criar um tópico no Amazon SNS
A primeira parte da configuração de uma EventBridge regra é preparar a meta da regra. Nesse caso, isso significa criar e assinar um tópico do Amazon SNS.
**Para criar um tópico do Amazon SNS**
1. [Abra o console do Amazon SNS em https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home)
1. No painel de navegação, selecione **Topics (Tópicos)** e **Create topic (Criar tópico)**.
1. Em **Tipo**, escolha **Padrão**.
1. Em **Nome**, insira **MediaConvertJobErrorAlert** e, em seguida, escolha **Criar tópico**.
1. Escolha o tópico **Nome** para o tópico que você acabou de criar para visualizar os **Detalhes do tópico**.
1. Na página de **detalhes do **MediaConvertJobErrorAlert**tópico**, na seção **Assinaturas**, escolha **Criar** assinatura.
1. Em **Protocolo**, escolha **E-mail**. Para **Endpoint**, insira o endereço de e-mail para o qual você deseja que o Amazon SNS envie a notificação.
1. Selecione **Criar assinatura**.
1. Você receberá uma notificação por e-mail do Amazon SNS. Quando você o receber, escolha o link **Confirm subscription** no e-mail.
## Etapa 2: especificar um padrão de evento em uma EventBridge regra
Esta etapa mostra como especificar seu padrão de evento em uma EventBridge regra. Essa regra capturará eventos enviados MediaConvert quando o status de um trabalho for alterado para`ERROR`.
**Para configurar um padrão de evento em uma EventBridge regra**
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha **Regras**. Mantenha o **Barramento de eventos** **padrão** e escolha **Criar regra**.
1. Em **Nome**, digite **MediaConvertJobStateError** e escolha **Próximo**.
1. Na seção **Padrão de evento**, começando com **Origem do evento**, escolha as seguintes configurações:
+ **Origem do evento**: **AWS services**
+ **AWS serviço**: **MediaConvert**
+ **Tipo de evento**: **MediaConvert Job State Change**
+ **Tipo de evento, estados específicos**: **ERROR**
1. A caixa de **Padrão de evento** será como o exemplo a seguir.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["ERROR"]
}
}
```
Esse código define uma regra de EventBridge evento que corresponde a qualquer evento em que o status do trabalho seja alterado`ERROR`. Para obter mais informações sobre padrões de eventos, consulte [Eventos e padrões de eventos](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatchEventsandEventPatterns.html) no *Guia CloudWatch do usuário da Amazon*.
1. Escolha **Próximo**.
## Etapa 3: adicionar o tópico do Amazon SNS e finalizar sua regra
Adicione o tópico do Amazon SNS que você criou na etapa 1 à EventBridge regra que você iniciou na etapa 2.
**Para adicionar o tópico do Amazon SNS e concluir a regra EventBridge**
1. Na seção **Selecionar destinos**, em **Selecionar um destino**, escolha o **Tópico do SNS**.
1. Em **Tópico**, escolha **MediaConvertJobErrorAlert**.
1. Escolha **Próximo**.
1. Opcionalmente, adicione tags. Escolha **Próximo**.
1. Examine suas configurações. Em seguida, escolha **Create rule** (Criar regra).
## Etapa 4: testar a regra
Para testar sua regra, envie um trabalho que você sabe que causará um erro. Por exemplo, especifique um local de entrada que não existe. Se você tiver configurado sua regra de evento corretamente, deverá receber um e-mail com a mensagem de texto do evento dentro de alguns minutos.
**Para testar a regra**
1. Abra o AWS Elemental MediaConvert console em [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).
1. Envie um novo MediaConvert emprego. Para obter mais informações, consulte [Tutorial: Definindo as configurações do trabalho](setting-up-a-job.md).
1. Verifique a conta de e-mail que você especificou quando configurou seu tópico do Amazon SNS. Confirme se recebeu uma notificação por e-mail para o erro de trabalho.
# Monitorando MediaConvert o progresso do trabalho
MediaConvert fornece informações de status para cada trabalho que você cria. Você pode monitorar o status de um trabalho para saber o que está acontecendo com o trabalho, acompanhar seu progresso ou solucionar problemas.
**Topics**
+ [Status de trabalhos](#job-statuses)
+ [Como encontrar o status de um emprego](#finding-job-status)
+ [Fases do trabalho](#job-phase)
## Status de trabalhos
Cada trabalho que você enviar progredirá em vários status possíveis. Trabalhos bem-sucedidos terminam com um status `COMPLETE` e trabalhos sem êxito terminam com um status `ERROR` ou `CANCELED`.
**Bem-sucedida de trabalhos**
Um trabalho bem-sucedido faz com que todas as saídas sejam gravadas em seu bucket do Amazon S3. A lista a seguir contém detalhes sobre os diferentes status pelos quais os trabalhos bem-sucedidos passam:
1. `SUBMITTED`: trabalhos que você criou no MediaConvert console ou por meio de uma [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)operação que MediaConvert ainda não iniciou o processamento.
1. `INPUT_INFORMATION`: MediaConvert leia detalhes sobre sua entrada ou entradas.
1. `PROGRESSING`: MediaConvert começou a processar seu trabalho.
1. `STATUS_UPDATE`: MediaConvert está processando seu trabalho há pelo menos um minuto ou mais. Os trabalhos com esse status passam por três *fases de trabalho* diferentes. Para obter mais informações, consulte [Fases do trabalho](#job-phase).
1. `COMPLETE`: MediaConvert concluiu seu trabalho e todas as suas saídas foram salvas em seu bucket do Amazon S3.
Trabalhos bem-sucedidos também podem incluir status [`NEW_WARNING`](ev_status_new_warning.md) ou [`QUEUE_HOP`](ev_status_new_warning.md).
**Trabalhos sem êxito**
Um trabalho sem êxito faz com que nenhuma saída seja gravada no bucket do Amazon S3, embora inicialmente possa progredir de forma semelhante a um trabalho bem-sucedido. Os trabalhos sem êxito têm um dos seguintes status:
+ `ERROR`: MediaConvert teve um problema ao processar seu trabalho. Para obter mais informações, consulte [Códigos de erro](mediaconvert_error_codes.md).
+ `CANCELED`: você cancelou um trabalho no MediaConvert console ou por meio de uma `CancelJob` operação.
## Como encontrar o status de um emprego
Para ver uma lista de todos os status de trabalhos na região atual, abra a página [Trabalhos](https://console.aws.amazon.com/mediaconvert/home#/jobs/list) no MediaConvert console. Ou envie uma operação `GetJob` ou `ListJobs`.
AWS CloudTrail registra detalhes sobre cada solicitação de trabalho de criação que você faz. CloudTrail só emite um EventBridge evento para `SUBMITTED` trabalhos se você também criar uma CloudTrail trilha. Para obter mais informações, consulte [Trabalhando com CloudTrail trilhas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html) e [Acessando eventos AWS de serviço via AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html).
MediaConvert emite um EventBridge evento quando uma tarefa começa a ser processada e, em seguida, sempre que seu status muda, por exemplo, se ela muda de `PROGRESSING` para `COMPLETE` ou`ERROR`. Para obter uma lista de EventBridge eventos, consulte[Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).
## Fases do trabalho
Se o status de um trabalho `PROGRESSING` for superior a um minuto, MediaConvert emite um `STATUS_UPDATE` evento com a *fase* atual do trabalho. Uma fase do trabalho contém informações sobre o que está acontecendo com um trabalho. As fases do trabalho progridem na seguinte ordem:
1. `PROBING`: quando seu trabalho está em `PROBING` fase, MediaConvert lê as informações dos arquivos de entrada que o serviço precisa para transcodificação.
1. `TRANSCODING`: quando a tarefa está na fase `TRANSCODING`, o serviço separa, decodifica, codifica e reagrupa seu conteúdo. Em algumas tarefas, o serviço inicia o upload de saídas para o seu bucket do Amazon S3 de saída durante essa fase. A fase termina quando todas as transcodificações estiverem concluídas.
1. `UPLOADING`: quando a tarefa está na fase `UPLOADING`, o serviço faz upload das saídas transcodificadas para o bucket de saída do Amazon S3. No caso de saídas que o serviço começa a carregar durante a fase `TRANSCODING`, a fase `UPLOADING` começa quando a transcodificação é feita. Isso continua até que todos os uploads sejam concluídos.
Para visualizar a fase de um trabalho, abra a página [Trabalhos](https://console.aws.amazon.com/mediaconvert/home#/jobs/list) no MediaConvert console, verifique o [`STATUS_UPDATE` EventBridgeevento](ev_status_status_update.md) ou envie uma `ListJobs` operação `GetJob` ou.
# Lista de MediaConvert EventBridge eventos
AWS Elemental MediaConvert emite um evento para a Amazon EventBridge quando o status de um trabalho muda. Você pode criar [EventBridgeregras](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) para qualquer um desses eventos.
A maioria dos trabalhos emitirá apenas alguns desses eventos, sendo os mais comuns: `INPUT_INFORMATION`, `PROGRESSING`, e `COMPLETE`.
Para obter mais informações sobre cada tipo de evento, escolha o link na coluna **Evento**.
**MediaConvert eventos**
| Event | Enviado quando | Contém |
| --- | --- | --- |
| [INPUT\$1INFORMATION](ev_status_input_information.md) | Logo depois MediaConvert começa a processar o trabalho. | Informações de mídia, como a altura e a largura do quadro, a taxa de quadros e o codec. Informações MediaConvert sobre todas as entradas em um único evento. |
| [PROGREDINDO](ev_status_progressing.md) | Um trabalho muda do estado `SUBMITTED` para o estado `PROGRESSING`. | Detalhes básicos do trabalho. |
| [STATUS\$1UPDATE](ev_status_status_update.md) | Aproximadamente um minuto após o MediaConvert início do processamento do trabalho. Enviados aproximadamente a cada minuto depois do início do processamento, até que o trabalho seja completo ou encontre um erro. | Progresso do trabalho, expresso no número de quadros transcodificados desde o início do trabalho. |
| [COMPLETO](ev_status_complete.md) | Um trabalho é concluído e MediaConvert grava todas as saídas com êxito, sem erros. | Advertências e informações de saída sobre o trabalho concluído. |
| [CANCELED](ev_status_canceled.md) | Um trabalho foi cancelado. | Detalhes básicos do trabalho. |
| [ERRO](ev_status_error.md) | Um trabalho tem um erro. Pelo menos uma saída tem um erro. | O código ou códigos de erro e quaisquer mensagens. Inclui quaisquer outras informações de trabalho efêmeras sobre o status do erro do trabalho. |
| [NEW\$1WARNING](ev_status_new_warning.md) | Surge uma condição de aviso. | O código ou códigos de aviso e quaisquer mensagens de aviso. |
| [QUEUE\$1HOP](ev_status_queue_hop.md) | Quando um trabalho salta filas. | O ARNs para ambas as filas e para a prioridade do trabalho dentro da fila. |
**nota**
MediaConvert não emite um `SUBMITTED` evento. Para receber um EventBridge evento sempre que você fizer uma chamada de API, incluindo chamadas do MediaConvert console, você deve criar uma AWS CloudTrail trilha. Para obter mais informações, consulte [Acessando eventos AWS de serviço por meio](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) de trilhas AWS CloudTrail e [Trabalhando com CloudTrail trilhas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html).
Quando MediaConvert envia um evento para EventBridge, os seguintes campos estão presentes no JSON resultante.
+ **version** (versão): atualmente 0 (zero) para todos os eventos.
+ **id**: um UUID versão 4 gerado para cada evento.
+ **detail-type** (detalhe-tipo): o tipo de evento que está sendo enviado.
+ **source** (origem): identifica o serviço que originou o evento.
+ **conta**: o ID de 12 dígitos da Conta da AWS que executou o trabalho.
+ **time** (hora): a hora em que o evento ocorreu.
+ **região**: identifica a Região da AWS do trabalho.
+ **recursos**: uma matriz JSON que contém o nome do recurso da Amazon (ARN) do trabalho.
+ **detalhe**: contém um objeto JSON com as informações sobre o trabalho.
As seções a seguir contêm detalhes da mensagem do evento, respostas JSON e padrões de eventos para cada EventBridge evento MediaConvert emitido.
**Topics**
+ [Eventos com status INPUT\$1INFORMATION](ev_status_input_information.md)
+ [Eventos com status PROGREDINDO](ev_status_progressing.md)
+ [Eventos com status STATUS\$1UPDATE](ev_status_status_update.md)
+ [Eventos com status COMPLETO](ev_status_complete.md)
+ [Eventos com status CANCELED](ev_status_canceled.md)
+ [Eventos com status ERROR](ev_status_error.md)
+ [Eventos com status NEW\$1WARNING](ev_status_new_warning.md)
+ [Eventos com status QUEUE\$1HOP](ev_status_queue_hop.md)
# Eventos com status INPUT\$1INFORMATION
MediaConvert envia o evento para `INPUT_INFORMATION` depois que um trabalho começa a ser processado e depois MediaConvert lê as informações sobre sua entrada. O evento contém principalmente informações de mídia sobre sua entrada, como altura e largura do quadro, taxa de quadros e codec.
MediaConvert inclui informações sobre todas as suas entradas em um único evento.
O JSON a seguir é um exemplo de evento contendo o status `INPUT_INFORMATION` de um trabalho com uma única 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
}
]
}
]
}
}
```
Você pode usar o exemplo de JSON a seguir para criar um padrão de EventBridge evento para trabalhos com um status de`INPUT_INFORMATION`.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["INPUT_INFORMATION"]
}
}
```
# Eventos com status PROGREDINDO
MediaConvert envia o evento para `PROGRESSING` quando um trabalho é transferido do `SUBMITTED` estado para o `PROGRESSING` estado.
**nota**
Depois que um trabalho fica no status `PROGRESSING` por 48 horas, o serviço coloca-o em um estado `ERROR` e para de trabalhar nele. Você não será cobrado pelos trabalhos que finalizarem com um estado `ERROR`.
O JSON a seguir é um exemplo de evento contendo o status `PROGRESSING` de um trabalho.
```
{
"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": {}
}
}
```
Você pode usar o exemplo de JSON a seguir para criar um padrão de EventBridge evento para trabalhos com um status de`PROGRESSING`.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["PROGRESSING"]
}
}
```
# Eventos com status STATUS\$1UPDATE
MediaConvert envia o evento por `STATUS_UPDATE` aproximadamente um minuto após o início do processamento de um trabalho. Por padrão, as atualizações são enviadas aproximadamente a cada minuto após isso, até que o serviço conclua a transcodificação ou encontre um erro.
Opcionalmente, você pode especificar uma frequência de atualização diferente em seu trabalho, com a configuração **Status update interval (Intervalo de atualização de status)**. Para atualizações mais frequentes, você pode escolher 10, 12, 15, 20 ou 30 segundos. Para atualizações menos frequentes, você pode escolher qualquer intervalo de 2 a 10 minutos, em incrementos de um minuto. Para obter mais informações, consulte [Ajustar o intervalo de atualização de status](adjusting-the-status-update-interval.md).
Um evento `STATUS_UPDATE` contém informações sobre a fase atual do seu trabalho. Quando disponível, ele contém a porcentagem do trabalho e de sua conclusão.
As fases da tarefa são as seguintes:
+ Durante `PROBING`, o serviço lê informações sobre a entrada enquanto se prepara para transcodificar.
+ Durante `TRANSCODING`, o serviço realiza demux, decodifica, codifica e realiza remux de seu conteúdo. Em alguns trabalhos, o serviço também inicia o upload de saídas para o seu bucket do Amazon S3 de saída durante essa fase. A fase termina quando todas as transcodificações estiverem concluídas.
+ Durante `UPLOADING`, o serviço carrega as demais saídas transcodificados para o seu bucket do Amazon S3.
O JSON a seguir é um exemplo de evento contendo o status `STATUS_UPDATE` de um trabalho.
```
{
"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
}
}
}
```
Você pode usar o exemplo de JSON a seguir para criar um padrão de EventBridge evento para trabalhos com um status de`STATUS_UPDATE`.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["STATUS_UPDATE"]
}
}
```
# Ajustar o intervalo de atualização de status
Por padrão, AWS Elemental MediaConvert envia `STATUS_UPDATE` eventos para a Amazon EventBridge aproximadamente uma vez por minuto. Essas atualizações de status fornecem informações sobre como seu trabalho está progredindo. Você pode ajustar o intervalo de atualização de status especificando uma frequência de atualização diferente no seu trabalho.
**Para especificar a frequência de STATUS\$1UPDATE**
1. Na página **Criar trabalho**, no painel **Trabalho** à esquerda, na seção **Configurações de trabalho**, escolha **Integração com a AWS **.
1. Na seção **Integração com a AWS ** à direita, para **Intervalo de atualização do status (s)**, escolha **Intervalo, em segundos, entre atualizações**.
Se você usar a API ou um SDK, poderá encontrar essa configuração no arquivo JSON do seu trabalho. O nome da configuração é [statusUpdateInterval](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-createjobrequest-statusupdateinterval).
# Eventos com status COMPLETO
MediaConvert envia o evento para `COMPLETE` quando todas as saídas forem gravadas no Amazon S3 sem erros. Ele contém avisos e informações de saída do trabalho concluído. Para obter mais informações sobre nomes e caminhos de arquivos de saída, consulte [Nomes de arquivo de saída e caminhos](output-file-names-and-paths.md).
O JSON a seguir é um exemplo de evento contendo o status `COMPLETE` de um trabalho.
```
{
"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
}
]
}
}
```
Os eventos `COMPLETE` contêm informações adicionais sobre seu trabalho e resultados. A tabela a seguir lista e descreve as diferentes propriedades disponíveis nos detalhes da mensagem de evento de trabalho.
**Detalhes completos da mensagem do evento**
| Propriedade | Tipo de dados | Detalhes |
| --- | --- | --- |
| `paddingInserted` | integer | A duração total dos quadros em branco MediaConvert inseridos em todas as saídas do seu trabalho, em milissegundos. O preenchimento de vídeo insere quadros em branco para ajudar a manter as durações de áudio e vídeo alinhadas. Valores grandes de `paddingInserted` mostram que mais quadros em branco foram inseridos. Esses valores também mostram até que ponto suas trilhas de áudio de entrada começam atrasadas, terminam adiantadas ou ambos. |
| `qvbrAvgQuality` | flutuação | A qualidade média do vídeo da saída de Quality-Defined Variable Bitrate (QVBR – taxa de bits variável definida por qualidade). Incluído apenas para saídas QVBR. |
| `qvbrMinQuality` | flutuação | A qualidade mínima de vídeo detectada na saída QVBR. Incluído apenas para saídas QVBR. |
| `qvbrMaxQuality` | flutuação | A qualidade máxima de vídeo detectada na saída QVBR. Incluído apenas para saídas QVBR. |
| `qvbrMinQualityLocation` | integer | O local em sua saída em que `qvbrMinQuality` foi detectado, em milissegundos. Você pode usar `qvbrMinQualityLocation` enquanto analisa a qualidade do vídeo de saída e o uso da largura de banda. Incluído apenas para saídas QVBR. |
| `qvbrMaxQualityLocation` | integer | O local em sua saída em que `qvbrMaxQuality` foi detectado, em milissegundos. Você pode usar `qvbrMaxQualityLocation` enquanto analisa a qualidade do vídeo de saída e o uso da largura de banda. Incluído apenas para saídas QVBR. |
| `warnings` código contagem | array integer integer | Todos os códigos de aviso vistos no trabalho e o número de vezes em que ocorreram. Para obter mais informações, consulte [Códigos de aviso](warning_codes.md). |
| `blackVideoDetected` | integer | A duração total dos quadros de vídeo em preto nas suas saídas que também estão presentes nas suas entradas, em milissegundos. `blackVideoDetected`não inclui nenhuma moldura preta inserida por MediaConvert. |
| `blackVideoSegments` `start` `end` | array integer integer | O local ou locais na sua saída onde os quadros de vídeo em preto foram detectados. Cada segmento de vídeo em preto na sua saída é mostrado com seu próprio início e fim. `blackVideoSegments`não inclui nenhuma moldura preta inserida por MediaConvert. |
| `averageBitrate` | integer | A taxa de bits média da sua saída de vídeo, calculada dividindo a duração pelo total de bits. |
Você pode usar o exemplo de JSON a seguir para criar um padrão de EventBridge evento para trabalhos com um status de`COMPLETE`.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["COMPLETE"]
}
}
```
# Nomes de arquivo de saída e caminhos
A `COMPLETE` notificação do EventBridge trabalho inclui detalhes sobre sua saída em JSON. Essas informações incluem os nomes de arquivos e caminhos para as saídas do trabalho, incluindo manifestos e ativos de mídia.
Os arquivos AWS Elemental MediaConvert criados dependem dos grupos de saída que você configurou no trabalho. Por exemplo, pacotes DASH ISO contém um manifesto .mpd e arquivos de fragmentos de mídia mp4.
Você pode encontrar informações de nome e caminho do arquivo de saída nas seguintes propriedades:
`playlistFilePaths`
Uma lista dos caminhos de arquivo do Amazon S3 para as playlists multivariantes.
`outputFilePaths`
O caminho do arquivo é a mídia ou o manifesto, dependendo do tipo de grupo de saída.
`type`
O tipo de grupo de saída, que determina quais arquivos estão listados em `playlistFilePaths` e `outputFilePaths`.
A tabela a seguir resume os valores para estas propriedades, dependendo do tipo de grupo de saída.
| Tipo | playlistFilePaths | outputFilePaths |
| --- | --- | --- |
| FILE\$1GROUP (saída padrão) | não retornado | Nome do arquivo e caminho do arquivo de mídia. Exemplo: `s3://amzn-s3-demo-bucket/file/file.mp4` |
| FILE\$1GROUP (com saída adicional de captura de quadros) | não retornado | Nome do arquivo e caminho da imagem final capturada. Exemplo: `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg` |
| HLS\$1GROUP | Nome do arquivo e caminho da playlist multivariante. Exemplo: `s3://amzn-s3-demo-bucket/hls/main.m3u8` | Nome do arquivo e caminhos dos manifestos para as saídas individuais. Exemplos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/mediaconvert/latest/ug/output-file-names-and-paths.html) |
| DASH\$1ISO\$1GROUP | Nomes do arquivo e caminho do manifesto. Exemplo: `s3://amzn-s3-demo-bucket/dash/1.mpd` | não retornado |
| CMAF\$1GROUP | Nome do arquivo e caminho para cada manifesto de alto nível. Exemplos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/mediaconvert/latest/ug/output-file-names-and-paths.html) | não retornado |
| MS\$1SMOOTH\$1GROUP | Nome do arquivo e caminho do manifesto no lado do servidor. Exemplo: `s3://amzn-s3-demo-bucket/smooth/1.ism` | Nome do arquivo e caminho dos manifestos de vídeo para cada uma das saídas individuais. Exemplos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/mediaconvert/latest/ug/output-file-names-and-paths.html) |
Para amostras de respostas do em JSON para cada tipo de grupo de saída, consulte os seguintes tópicos:
**Topics**
+ [Grupo de arquivos](file-group.md)
+ [Grupo de arquivos com uma saída de captura de quadros](file-group-with-frame-capture-output.md)
+ [Grupo Apple HLS](apple-hls-group.md)
+ [Grupo DASH ISO](dash-iso-group.md)
+ [Grupo CMAF](cmaf-group.md)
+ [Grupo do Microsoft Smooth Streaming](microsoft-smooth-streaming-group.md)
# Grupo de arquivos
O seguinte é um EventBridge exemplo de evento da Amazon para um trabalho com `COMPLETE` status. O exemplo inclui informações sobre o caminho do arquivo de saída para um grupo de arquivos.
```
{
"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**
As estatísticas QVBR só estão disponíveis quando a saída de vídeo usa o controle de taxa de bits variável definida pela qualidade (QVBR).
# Grupo de arquivos com uma saída de captura de quadros
Este guia fornece um EventBridge exemplo de evento da Amazon para um trabalho com `COMPLETE` status. Ele também mostra informações do caminho do arquivo de saída para um grupo de arquivos com uma saída de captura de quadros.
Uma *saída de captura de quadros* é uma saída que você configura para criar imagens estáticas no seu vídeo. Você configura-o de forma semelhante a um grupo de saída de **Grupo de arquivos** normal. No entanto, remova o componente de áudio, escolha **Nenhum contêiner** para o contêiner e, em seguida, escolha **Captura de quadros para JPEG** para o codec de vídeo.
**nota**
Você pode criar saídas de captura de quadros somente em trabalhos que também tenham uma saída normal de áudio e vídeo. MediaConvert não oferece suporte a trabalhos que consistem apenas em uma saída de captura de quadros.
Quando você cria uma saída de captura de quadros, o status `COMPLETE` inclui a propriedade `outputFilePaths`. Isso informa o nome do arquivo e o caminho da imagem final capturada.
**dica**
Como o serviço inclui numeração automática nos nomes de arquivos de captura de quadros, você pode inferir todas os nomes das imagens do final. Por exemplo, se o seu `outputFilePaths` valor é `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`, você pode pressupor que existem 35 outras imagens no mesmo local, chamado `file.0000001` `file.0000002`, e assim por diante.
Veja a seguir um EventBridge exemplo de evento para um trabalho com `COMPLETE` status. Ele inclui informações do caminho do arquivo de saída para um grupo de arquivos com uma saída de captura de quadros.
```
{
"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**
As estatísticas de taxa de bits variável definida pela qualidade (QVBR) só estão disponíveis quando a saída de vídeo usa controle de taxa QVBR.
# Grupo Apple HLS
O seguinte é um EventBridge exemplo de evento da Amazon para um trabalho com `COMPLETE` status. Ele inclui informações de caminho do arquivo de saída para um grupo 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**
As estatísticas de taxa de bits variável definida pela qualidade (QVBR) só estão disponíveis quando a saída de vídeo usa controle de taxa QVBR.
# Grupo DASH ISO
O seguinte é um EventBridge exemplo de evento da Amazon para um trabalho com `COMPLETE` status. Ele inclui informações sobre o caminho do arquivo de saída para um grupo 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**
As estatísticas de taxa de bits variável definida pela qualidade (QVBR) só estão disponíveis quando a saída de vídeo usa controle de taxa QVBR.
# Grupo CMAF
Veja a seguir um EventBridge exemplo de evento para um trabalho com `COMPLETE` status. Ele inclui informações sobre o caminho do arquivo de saída para um 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**
As estatísticas de taxa de bits variável definida pela qualidade (QVBR) só estão disponíveis quando a saída de vídeo usa controle de taxa QVBR.
# Grupo do Microsoft Smooth Streaming
Veja a seguir um EventBridge exemplo de evento para um trabalho com `COMPLETE` status. Ele inclui informações sobre o caminho do arquivo de saída para um grupo do 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**
As estatísticas de taxa de bits variável definida pela qualidade (QVBR) só estão disponíveis quando a saída de vídeo usa controle de taxa QVBR.
# Eventos com status CANCELED
MediaConvert envia o evento para `CANCELED` quando o trabalho for cancelado. Ele contém detalhes básicos do trabalho incluindo `timestamp`, `accountID`, `queue`, `jobId`, e `userMetadata`.
O JSON a seguir é um exemplo de evento contendo o status `CANCELED` de um trabalho.
```
{
"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": {}
}
}
```
Você pode usar o exemplo de JSON a seguir para criar um padrão de EventBridge evento para trabalhos com um status de`CANCELED`.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["CANCELED"]
}
}
```
# Eventos com status ERROR
MediaConvert envia o evento para `ERROR` quando pelo menos uma saída tiver um erro. Ele contém o código ou códigos de erro, mensagens e avisos ou outras informações efêmeras do trabalho sobre o status de erro do trabalho. Para obter mais informações sobre códigos de erro, consulte [Códigos de erro](mediaconvert_error_codes.md).
O JSON a seguir é um exemplo de evento contendo o status `ERROR` de um trabalho.
```
{
"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": {}
}
}
```
Você pode usar o exemplo de JSON a seguir para criar um padrão de EventBridge evento para trabalhos com um status de`ERROR`.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["ERROR"]
}
}
```
# Eventos com status NEW\$1WARNING
MediaConvert envia um evento para `NEW_WARNING` quando surge uma condição de aviso. Uma condição de aviso não impede a execução do trabalho. Ela contém o ARN da fila de envio, o ID do trabalho e uma mensagem de aviso. As mensagens de aviso o informam sobre condições que não interrompem o trabalho, mas podem indicar que ele não está progredindo conforme planejado.
Por exemplo, um trabalho configurado para saltar filas atinge o tempo de espera especificado, mas não é possível saltar.
`NEW_WARNING` contém somente a mensagem de aviso mais recente. Ele não reporta avisos anteriores, mesmo que essas condições de aviso ainda estejam em vigor.
Para obter mais informações sobre mensagens de aviso, consulte [Códigos de aviso](warning_codes.md).
O JSON a seguir é um exemplo de evento contendo o status `NEW_WARNING` de um trabalho.
```
{
"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": {}
}
}
```
Você pode usar o exemplo de JSON a seguir para criar um padrão de EventBridge evento para trabalhos com um status de`NEW_WARNING`.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["NEW_WARNING"]
}
}
```
# Eventos com status QUEUE\$1HOP
MediaConvert envia o `QUEUE_HOP` evento quando um trabalho salta na fila. Ele contém ARNs as duas filas e a prioridade do trabalho dentro das filas.
Ambos `priority` e `previousPriority` serão iguais, a menos que a configuração de salto na fila especifique uma nova prioridade a ser dada ao trabalho à medida que ele salta filas.
O JSON a seguir é um exemplo de evento contendo o status `QUEUE_HOP` de um trabalho.
```
{
"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": {}
}
}
```
Você pode usar o exemplo de JSON a seguir para criar um padrão de EventBridge evento para trabalhos com um status de`QUEUE_HOP`.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["QUEUE_HOP"]
}
}
```