# Exemplos do MediaConvert usando o AWS CLI
<a name="cli_mediaconvert_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o MediaConvert.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `cancel-job`
<a name="mediaconvert_CancelJob_cli_topic"></a>

O código de exemplo a seguir mostra como usar `cancel-job`.

**AWS CLI**  
**Para cancelar um trabalho que está em uma fila**  
O exemplo `cancel-job` a seguir cancela um trabalho que tenha o ID `1234567891234-abc123`. Não é possível cancelar um trabalho depois que o serviço começar a processá-lo.  

```
aws mediaconvert cancel-job \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1 \
    --id 1234567891234-abc123
```
Use `describe-endpoints` para obter o endpoint específico da sua conta ou envie o comando sem o endpoint. O serviço retorna um erro e o endpoint.  
Para obter mais informações, consulte [Working with AWS Elemental MediaConvert Jobs](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/cancel-job.html) na *Referência de comandos da AWS CLI*. 

### `create-job-template`
<a name="mediaconvert_CreateJobTemplate_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-job-template`.

**AWS CLI**  
**Criar um modelo de trabalho**  
O exemplo `create-job-template` a seguir cria um trabalho com as configurações de transcodificação especificadas em um arquivo `job-template.json` presente no sistema.  

```
aws mediaconvert create-job-template \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1 \
    --name JobTemplate1 \
    --cli-input-json file://~/job-template.json
```
Se o arquivo de modelo de trabalho JSON criado usando `get-job-template` for posteriormente modificando, é necessário remover o objeto `JobTemplate`, mas manter o objeto-filho de Configurações dentro dele. Além disso, deve-se remover os seguintes pares de valores-chave: `LastUpdated`, `Arn`, `Type` e `CreatedAt`. É possível especificar a categoria, a descrição, o nome e a fila no arquivo JSON ou na linha de comando.  
Use `describe-endpoints` para obter o endpoint específico da sua conta ou envie o comando sem o endpoint. O serviço retorna um erro e o endpoint.  
Se a solicitação for bem-sucedida, o serviço retornará a especificação JSON do modelo de trabalho criado.  
Para obter mais informações, consulte [Trabalhar com modelos de trabalho do AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [CreateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job-template.html) na *Referência de comandos da AWS CLI*. 

### `create-job`
<a name="mediaconvert_CreateJob_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-job`.

**AWS CLI**  
**Como criar um trabalho**  
O exemplo de `create-job` a seguir cria um trabalho de transcodificação com as configurações especificadas em um arquivo `job.json` presente no sistema que você usou para enviar o comando. Essa especificação de trabalho JSON pode especificar cada configuração individualmente, fazer referência a um modelo de trabalho ou a predefinições de saída.  

```
aws mediaconvert create-job \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1 \
    --cli-input-json file://~/job.json
```
Você pode usar o console do AWS Elemental MediaConvert para gerar a especificação do trabalho JSON escolhendo as configurações do trabalho e depois selecionando **Mostrar JSON de trabalho** na parte inferior da seção **Trabalho**.  
Use `describe-endpoints` para obter o endpoint específico da sua conta ou envie o comando sem o endpoint. O serviço retorna um erro e o endpoint.  
Se a solicitação for bem-sucedida, o serviço retornará a especificação do trabalho JSON enviado com a solicitação.  
Para obter mais informações, consulte [Working with AWS Elemental MediaConvert Jobs](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Consulte detalhes da API em [CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job.html) na *Referência de comandos da AWS CLI*. 

### `create-preset`
<a name="mediaconvert_CreatePreset_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-preset`.

**AWS CLI**  
**Para criar uma predefinição de saída personalizada**  
O exemplo `create-preset` a seguir cria uma predefinição de saída personalizada com base nas configurações de saída especificadas no arquivo `preset.json`. É possível especificar a categoria, a descrição e o nome no arquivo JSON ou na linha de comando.  

```
aws mediaconvert create-preset \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com
    --region region-name-1 \
    --cli-input-json file://~/preset.json
```
Se o arquivo de pré-definições JSON for criado usando `get-preset` e o arquivo de saída for posteriormente modificando, é necessário remover os seguintes pares de valores-chave: `LastUpdated`, `Arn`, `Type` e `CreatedAt`.  
Use `describe-endpoints` para obter o endpoint específico da sua conta ou envie o comando sem o endpoint. O serviço retorna um erro e o endpoint.  
Para obter mais informações, consulte [Trabalhar com pré-definições de saída com o AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [CreatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-preset.html) na *Referência de comandos da AWS CLI*. 

### `create-queue`
<a name="mediaconvert_CreateQueue_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-queue`.

**AWS CLI**  
**Para criar uma fila personalizada**  
O exemplo `create-queue` a seguir cria uma fila de transcodificação personalizada.  

```
aws mediaconvert create-queue \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1 \
    --name Queue1 \
    --description "Keep this queue empty unless job is urgent."
```
Use `describe-endpoints` para obter o endpoint específico da sua conta ou envie o comando sem o endpoint. O serviço retorna um erro e o endpoint.  
Resultado:  

```
{
    "Queue": {
        "Status": "ACTIVE",
        "Name": "Queue1",
        "LastUpdated": 1518034928,
        "Arn": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1",
        "Type": "CUSTOM",
        "CreatedAt": 1518034928,
        "Description": "Keep this queue empty unless job is urgent."
    }
}
```
Para obter mais informações, consulte [Trabalhar com filas no AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Consulte detalhes da API em [CreateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-queue.html) na *Referência de comandos da AWS CLI*. 

### `delete-job-template`
<a name="mediaconvert_DeleteJobTemplate_cli_topic"></a>

O código de exemplo a seguir mostra como usar `delete-job-template`.

**AWS CLI**  
**Para excluir um modelo de trabalho**  
O exemplo `delete-job-template` a seguir exclui o modelo de trabalho personalizado especificado.  

```
aws mediaconvert delete-job-template \
    --name "DASH Streaming" \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Este comando não produz saída. Execute `aws mediaconvert list-job-templates` para confirmar que seu modelo foi excluído.  
Para obter mais informações, consulte [Trabalhar com modelos de trabalho do AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [DeleteJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-job-template.html) na *Referência de comandos da AWS CLI*. 

### `delete-preset`
<a name="mediaconvert_DeletePreset_cli_topic"></a>

O código de exemplo a seguir mostra como usar `delete-preset`.

**AWS CLI**  
**Para excluir uma fila sob demanda**  
O exemplo `delete-preset` a seguir exclui a pré-definição personalizada especificada.  

```
aws mediaconvert delete-preset \
    --name SimpleMP4 \
    --endpoint-url  https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Este comando não produz saída. Execute `aws mediaconvert list-presets` para confirmar que a pré-definição foi excluída.  
Para obter mais informações, consulte [Trabalhar com pré-definições de saída com o AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [DeletePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-preset.html) na *Referência de comandos da AWS CLI*. 

### `delete-queue`
<a name="mediaconvert_DeleteQueue_cli_topic"></a>

O código de exemplo a seguir mostra como usar `delete-queue`.

**AWS CLI**  
**Para excluir uma fila sob demanda**  
O exemplo `delete-queue` a seguir exclui a fila sob demanda personalizada especificada.  
Não é possível excluir sua fila padrão. Não é possível excluir uma fila reservada que tenha um plano de preços ativo ou que contenha tarefas não processadas.  

```
aws mediaconvert delete-queue \
    --name Customer1 \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Este comando não produz saída. Execute `aws mediaconvert list-queues` para confirmar que a fila foi excluída.  
Para obter mais informações, consulte [Trabalhar com filas no AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Consulte detalhes da API em [DeleteQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-queue.html) na *Referência de comandos da AWS CLI*. 

### `describe-endpoints`
<a name="mediaconvert_DescribeEndpoints_cli_topic"></a>

O código de exemplo a seguir mostra como usar `describe-endpoints`.

**AWS CLI**  
**Para obter o endpoint específico da conta**  
O exemplo `describe-endpoints` a seguir recupera o endpoint necessário para enviar qualquer outra solicitação ao serviço.  

```
aws mediaconvert describe-endpoints
```
Resultado:  

```
{
    "Endpoints": [
        {
            "Url": "https://abcd1234.mediaconvert.region-name-1.amazonaws.com"
        }
    ]
}
```
Para obter mais informações, consulte [Conceitos básicos do MediaConvert usando a API](https://docs.aws.amazon.com/mediaconvert/latest/apireference/getting-started.html) na *Referência da API do AWS MediaConvert*.  
+  Para ver detalhes da API, consulte [DescribeEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/describe-endpoints.html) na *Referência de comandos da AWS CLI*. 

### `get-job-template`
<a name="mediaconvert_GetJobTemplate_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-job-template`.

**AWS CLI**  
**Obtenha detalhes sobre um modelo de trabalho**  
O exemplo `get-job-template` a seguir exibe a definição JSON do modelo de trabalho personalizado especificado.  

```
aws mediaconvert get-job-template \
    --name "DASH Streaming" \
    --endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com
```
Resultado:  

```
{
    "JobTemplate": {
        "StatusUpdateInterval": "SECONDS_60",
        "LastUpdated": 1568652998,
        "Description": "Create a DASH streaming ABR stack",
        "CreatedAt": 1568652998,
        "Priority": 0,
        "Name": "DASH Streaming",
        "Settings": {
            ...<truncatedforbrevity>...
        },
        "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming",
        "Type": "CUSTOM"
    }
}
```
Para obter mais informações, consulte [Trabalhar com modelos de trabalho do AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [GetJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job-template.html) na *Referência de comandos da AWS CLI*. 

### `get-job`
<a name="mediaconvert_GetJob_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-job`.

**AWS CLI**  
**Como obter detalhes de um trabalho específico**  
O exemplo a seguir solicita as informações do trabalho com o ID `1234567890987-1ab2c3` que, neste exemplo, resultou em erro.  

```
aws mediaconvert get-job \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1 \
    --id 1234567890987-1ab2c3
```
Use `describe-endpoints` para obter o endpoint específico da sua conta ou envie o comando sem o endpoint. O serviço retorna um erro e o endpoint.  
Se a solicitação for bem-sucedida, o serviço retornará um arquivo JSON com as informações do trabalho, incluindo as configurações do trabalho, quaisquer erros retornados e outros dados do trabalho, da seguinte forma:  

```
{
    "Job": {
        "Status": "ERROR",
        "Queue": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1",
        "Settings": {
            ...<truncated for brevity>...
        },
        "ErrorMessage": "Unable to open input file [s3://my-input-bucket/file-name.mp4]: [Failed probe/open: [Failed to read data: AssumeRole failed]]",
        "ErrorCode": 1434,
        "Role": "arn:aws:iam::012345678998:role/MediaConvertServiceRole",
        "Arn": "arn:aws:mediaconvert:us-west-1:012345678998:jobs/1234567890987-1ab2c3",
        "UserMetadata": {},
        "Timing": {
            "FinishTime": 1517442131,
            "SubmitTime": 1517442103,
            "StartTime": 1517442104
        },
        "Id": "1234567890987-1ab2c3",
        "CreatedAt": 1517442103
    }
}
```
Para obter mais informações, consulte [Working with AWS Elemental MediaConvert Jobs](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Consulte detalhes da API em [GetJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job.html) na *Referência de comandos da AWS CLI*. 

### `get-preset`
<a name="mediaconvert_GetPreset_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-preset`.

**AWS CLI**  
**Para obter detalhes de uma pré-definição específica**  
O exemplo `get-preset` a seguir solicita a definição JSON da pré-definição personalizada especificada.  

```
aws mediaconvert get-preset \
    --name SimpleMP4 \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "Preset": {
        "Description": "Creates basic MP4 file. No filtering or preproccessing.",
        "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4",
        "LastUpdated": 1568843141,
        "Name": "SimpleMP4",
        "Settings": {
            "ContainerSettings": {
                "Mp4Settings": {
                    "FreeSpaceBox": "EXCLUDE",
                    "CslgAtom": "INCLUDE",
                    "MoovPlacement": "PROGRESSIVE_DOWNLOAD"
                },
                "Container": "MP4"
            },
            "AudioDescriptions": [
                {
                    "LanguageCodeControl": "FOLLOW_INPUT",
                    "AudioTypeControl": "FOLLOW_INPUT",
                    "CodecSettings": {
                        "AacSettings": {
                            "RawFormat": "NONE",
                            "CodecProfile": "LC",
                            "AudioDescriptionBroadcasterMix": "NORMAL",
                            "SampleRate": 48000,
                            "Bitrate": 96000,
                            "RateControlMode": "CBR",
                            "Specification": "MPEG4",
                            "CodingMode": "CODING_MODE_2_0"
                        },
                        "Codec": "AAC"
                    }
                }
            ],
            "VideoDescription": {
                "RespondToAfd": "NONE",
                "TimecodeInsertion": "DISABLED",
                "Sharpness": 50,
                "ColorMetadata": "INSERT",
                "CodecSettings": {
                    "H264Settings": {
                        "FramerateControl": "INITIALIZE_FROM_SOURCE",
                        "SpatialAdaptiveQuantization": "ENABLED",
                        "Softness": 0,
                        "Telecine": "NONE",
                        "CodecLevel": "AUTO",
                        "QualityTuningLevel": "SINGLE_PASS",
                        "UnregisteredSeiTimecode": "DISABLED",
                        "Slices": 1,
                        "Syntax": "DEFAULT",
                        "GopClosedCadence": 1,
                        "AdaptiveQuantization": "HIGH",
                        "EntropyEncoding": "CABAC",
                        "InterlaceMode": "PROGRESSIVE",
                        "ParControl": "INITIALIZE_FROM_SOURCE",
                        "NumberBFramesBetweenReferenceFrames": 2,
                        "GopSizeUnits": "FRAMES",
                        "RepeatPps": "DISABLED",
                        "CodecProfile": "MAIN",
                        "FieldEncoding": "PAFF",
                        "GopSize": 90.0,
                        "SlowPal": "DISABLED",
                        "SceneChangeDetect": "ENABLED",
                        "GopBReference": "DISABLED",
                        "RateControlMode": "CBR",
                        "FramerateConversionAlgorithm": "DUPLICATE_DROP",
                        "FlickerAdaptiveQuantization": "DISABLED",
                        "DynamicSubGop": "STATIC",
                        "MinIInterval": 0,
                        "TemporalAdaptiveQuantization": "ENABLED",
                        "Bitrate": 400000,
                        "NumberReferenceFrames": 3
                    },
                    "Codec": "H_264"
                },
                "AfdSignaling": "NONE",
                "AntiAlias": "ENABLED",
                "ScalingBehavior": "DEFAULT",
                "DropFrameTimecode": "ENABLED"
            }
        },
        "Type": "CUSTOM",
        "CreatedAt": 1568841521
    }
}
```
Para obter mais informações, consulte [Trabalhar com pré-definições de saída com o AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [GetPreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-preset.html) na *Referência de comandos da AWS CLI*. 

### `get-queue`
<a name="mediaconvert_GetQueue_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-queue`.

**AWS CLI**  
**Para obter detalhes de uma fila**  
O exemplo `get-queue` a seguir recupera detalhes sobre a fila personalizada especificada.  

```
aws mediaconvert get-queue \
    --name Customer1 \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "Queue": {
        "LastUpdated": 1526428502,
        "Type": "CUSTOM",
        "SubmittedJobsCount": 0,
        "Status": "ACTIVE",
        "PricingPlan": "ON_DEMAND",
        "CreatedAt": 1526428502,
        "ProgressingJobsCount": 0,
        "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Customer1",
        "Name": "Customer1"
    }
}
```
Para obter mais informações, consulte [Trabalhar com filas no AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [GetQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-queue.html) na *Referência de comandos da AWS CLI*. 

### `list-job-templates`
<a name="mediaconvert_ListJobTemplates_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-job-templates`.

**AWS CLI**  
**Exemplo 1: listar seus modelos de trabalho personalizados**  
O exemplo `list-job-templates` a seguir lista todos os modelos de trabalho personalizados na região atual. Para listar os modelos de trabalho do sistema, consulte o próximo exemplo.  

```
aws mediaconvert list-job-templates \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "JobTemplates": [
        {
            "Description": "Create a DASH streaming ABR stack",
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming",
            "Name": "DASH Streaming",
            "LastUpdated": 1568653007,
            "Priority": 0,
            "Settings": {
                ...<truncatedforbrevity>...
            },
            "Type": "CUSTOM",
            "StatusUpdateInterval": "SECONDS_60",
            "CreatedAt": 1568653007
        },
        {
            "Description": "Create a high-res file",
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/File",
            "Name": "File",
            "LastUpdated": 1568653007,
            "Priority": 0,
            "Settings": {
                ...<truncatedforbrevity>...
            },
            "Type": "CUSTOM",
            "StatusUpdateInterval": "SECONDS_60",
            "CreatedAt": 1568653023
        }
    ]
}
```
**Exemplo 2: listar os modelos de trabalho do sistema do MediaConvert**  
O exemplo `list-job-templates` a seguir lista todos os modelos de trabalho do sistema.  

```
aws mediaconvert list-job-templates \
    --endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com \
    --list-by SYSTEM
```
Resultado:  

```
{
    "JobTemplates": [
        {
            "CreatedAt": 1568321779,
            "Arn": "arn:aws:mediaconvert:us-east-1:123456789012:jobTemplates/System-Generic_Mp4_Hev1_Avc_Aac_Sdr_Qvbr",
            "Name": "System-Generic_Mp4_Hev1_Avc_Aac_Sdr_Qvbr",
            "Description": "GENERIC, MP4, AVC + HEV1(HEVC,SDR), AAC, SDR, QVBR",
            "Category": "GENERIC",
            "Settings": {
                "AdAvailOffset": 0,
                "OutputGroups": [
                    {
                        "Outputs": [
                            {
                                "Extension": "mp4",
                                "Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1280x720p_30Hz_5Mbps_Qvbr_Vq9",
                                "NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1280x720p_30Hz_5000Kbps_Qvbr_Vq9"
                            },
                            {
                                "Extension": "mp4",
                                "Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1920x1080p_30Hz_10Mbps_Qvbr_Vq9",
                                "NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1920x1080p_30Hz_10000Kbps_Qvbr_Vq9"
                            },
                            {
                                "Extension": "mp4",
                                "Preset": "System-Generic_Sd_Mp4_Avc_Aac_16x9_Sdr_640x360p_30Hz_0.8Mbps_Qvbr_Vq7",
                                "NameModifier": "_Generic_Sd_Mp4_Avc_Aac_16x9_Sdr_640x360p_30Hz_800Kbps_Qvbr_Vq7"
                            },
                            {
                                "Extension": "mp4",
                                "Preset": "System-Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1280x720p_30Hz_4Mbps_Qvbr_Vq9",
                                "NameModifier": "_Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1280x720p_30Hz_4000Kbps_Qvbr_Vq9"
                            },
                            {
                                "Extension": "mp4",
                                "Preset": "System-Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1920x1080p_30Hz_8Mbps_Qvbr_Vq9",
                                "NameModifier": "_Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1920x1080p_30Hz_8000Kbps_Qvbr_Vq9"
                            },
                            {
                                "Extension": "mp4",
                                "Preset": "System-Generic_Uhd_Mp4_Hev1_Aac_16x9_Sdr_3840x2160p_30Hz_12Mbps_Qvbr_Vq9",
                                "NameModifier": "_Generic_Uhd_Mp4_Hev1_Aac_16x9_Sdr_3840x2160p_30Hz_12000Kbps_Qvbr_Vq9"
                            }
                        ],
                        "OutputGroupSettings": {
                            "FileGroupSettings": {

                            },
                            "Type": "FILE_GROUP_SETTINGS"
                        },
                        "Name": "File Group"
                    }
                ]
            },
            "Type": "SYSTEM",
            "LastUpdated": 1568321779
        },
        ...<truncatedforbrevity>...
    ]
}
```
Para obter mais informações, consulte [Trabalhar com modelos de trabalho do AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [ListJobTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-job-templates.html) na *Referência de comandos da AWS CLI*. 

### `list-jobs`
<a name="mediaconvert_ListJobs_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-jobs`.

**AWS CLI**  
**Como obter detalhes de todos os trabalhos de uma região**  
O exemplo a seguir solicita as informações de todos os trabalhos na região especificada.  

```
aws mediaconvert list-jobs \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1
```
Use `describe-endpoints` para obter o endpoint específico da sua conta ou envie o comando sem o endpoint. O serviço retorna um erro e o endpoint.  
Para obter mais informações, consulte [Working with AWS Elemental MediaConvert Jobs](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Consulte detalhes da API em [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-jobs.html) na *Referência de comandos da AWS CLI*. 

### `list-presets`
<a name="mediaconvert_ListPresets_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-presets`.

**AWS CLI**  
**Exemplo 1: listar suas predefinições de saída personalizadas**  
O exemplo `list-presets` a seguir lista suas predefinições de saída personalizadas. Para listar as pré-definições do sistema, consulte o próximo exemplo.  

```
aws mediaconvert list-presets \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "Presets": [
        {
            "Name": "SimpleMP4",
            "CreatedAt": 1568841521,
            "Settings": {
                ......
            },
            "Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleMP4",
            "Type": "CUSTOM",
            "LastUpdated": 1568843141,
            "Description": "Creates basic MP4 file. No filtering or preproccessing."
        },
        {
            "Name": "SimpleTS",
            "CreatedAt": 1568843113,
            "Settings": {
                ... truncated for brevity ...
            },
            "Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleTS",
            "Type": "CUSTOM",
            "LastUpdated": 1568843113,
            "Description": "Create a basic transport stream."
        }
    ]
}
```
**Exemplo 2: listar as predefinições de saída do sistema**  
O exemplo `list-presets` a seguir lista as predefinições de sistema do MediaConvert disponíveis. Para listar suas predefinições personalizadas, consulte o exemplo anterior.  

```
aws mediaconvert list-presets \
    --list-by SYSTEM \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "Presets": [
        {
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/System-Avc_16x9_1080p_29_97fps_8500kbps",
            "Name": "System-Avc_16x9_1080p_29_97fps_8500kbps",
            "CreatedAt": 1568321789,
            "Description": "Wifi, 1920x1080, 16:9, 29.97fps, 8500kbps",
            "LastUpdated": 1568321789,
            "Type": "SYSTEM",
            "Category": "HLS",
            "Settings": {
            ...<output settings removed for brevity>...
            }
        },

        ...<list of presets shortened for brevity>...

        {
            "Arn": "arn:aws:mediaconvert:us-east-1:123456789012:presets/System-Xdcam_HD_1080i_29_97fps_35mpbs",
            "Name": "System-Xdcam_HD_1080i_29_97fps_35mpbs",
            "CreatedAt": 1568321790,
            "Description": "XDCAM MPEG HD, 1920x1080i, 29.97fps, 35mbps",
            "LastUpdated": 1568321790,
            "Type": "SYSTEM",
            "Category": "MXF",
            "Settings": {
            ...<output settings removed for brevity>...
            }
        }
    ]
}
```
Para obter mais informações, consulte [Trabalhar com pré-definições de saída com o AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [ListPresets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-presets.html) na *Referência de comandos da AWS CLI*. 

### `list-queues`
<a name="mediaconvert_ListQueues_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-queues`.

**AWS CLI**  
**Para listar as filas**  
O exemplo `list-queues` a seguir lista todas as filas MediaConvert.  

```
aws mediaconvert list-queues \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "Queues": [
        {
            "PricingPlan": "ON_DEMAND",
            "Type": "SYSTEM",
            "Status": "ACTIVE",
            "CreatedAt": 1503451595,
            "Name": "Default",
            "SubmittedJobsCount": 0,
            "ProgressingJobsCount": 0,
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Default",
            "LastUpdated": 1534549158
        },
        {
            "PricingPlan": "ON_DEMAND",
            "Type": "CUSTOM",
            "Status": "ACTIVE",
            "CreatedAt": 1537460025,
            "Name": "Customer1",
            "SubmittedJobsCount": 0,
            "Description": "Jobs we run for our cusotmer.",
            "ProgressingJobsCount": 0,
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Customer1",
            "LastUpdated": 1537460025
        },
        {
            "ProgressingJobsCount": 0,
            "Status": "ACTIVE",
            "Name": "transcode-library",
            "SubmittedJobsCount": 0,
            "LastUpdated": 1564066204,
            "ReservationPlan": {
                "Status": "ACTIVE",
                "ReservedSlots": 1,
                "PurchasedAt": 1564066203,
                "Commitment": "ONE_YEAR",
                "ExpiresAt": 1595688603,
                "RenewalType": "EXPIRE"
            },
            "PricingPlan": "RESERVED",
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/transcode-library",
            "Type": "CUSTOM",
            "CreatedAt": 1564066204
        }
    ]
}
```
Para obter mais informações, consulte [Trabalhar com filas no AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Consulte detalhes da API em [ListQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-queues.html) na *Referência de comandos da AWS CLI*. 

### `list-tags-for-resource`
<a name="mediaconvert_ListTagsForResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-tags-for-resource`.

**AWS CLI**  
**Para listar as tags de uma fila, modelo de trabalho ou predefinição de saída do MediaConvert**  
O exemplo `list-tags-for-resource` a seguir lista as tags da pré-definição de saída especificada.  

```
aws mediaconvert list-tags-for-resource \
    --arn arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4 \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "ResourceTags": {
        "Tags": {
            "customer": "zippyVideo"
        },
        "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4"
    }
}
```
Para obter mais informações, consulte [Adicionar tags em filas, modelos de trabalho e pré-definições de saída do AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-queues-templates-presets.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-tags-for-resource.html) na *AWS CLI Command Reference*. 

### `update-job-template`
<a name="mediaconvert_UpdateJobTemplate_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-job-template`.

**AWS CLI**  
**Para alterar um modelo de trabalho**  
O exemplo `update-job-template` a seguir substitui a definição JSON do modelo de trabalho especificado pela definição JSON no arquivo fornecido.  
aws mediaconvert update-job-template --name File1 --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com --cli-input-json file://\$1/job-template-update.json  
Conteúdo de `job-template-update.json`:  

```
{
    "Description": "A simple job template that generates a single file output.",
    "Queue": "arn:aws:mediaconvert:us-east-1:012345678998:queues/Default",
    "Name": "SimpleFile",
    "Settings": {
      "OutputGroups": [
        {
          "Name": "File Group",
          "Outputs": [
            {
              "ContainerSettings": {
                "Container": "MP4",
                "Mp4Settings": {
                  "CslgAtom": "INCLUDE",
                  "FreeSpaceBox": "EXCLUDE",
                  "MoovPlacement": "PROGRESSIVE_DOWNLOAD"
                }
              },
              "VideoDescription": {
                "ScalingBehavior": "DEFAULT",
                "TimecodeInsertion": "DISABLED",
                "AntiAlias": "ENABLED",
                "Sharpness": 50,
                "CodecSettings": {
                  "Codec": "H_264",
                  "H264Settings": {
                    "InterlaceMode": "PROGRESSIVE",
                    "NumberReferenceFrames": 3,
                    "Syntax": "DEFAULT",
                    "Softness": 0,
                    "GopClosedCadence": 1,
                    "GopSize": 90,
                    "Slices": 1,
                    "GopBReference": "DISABLED",
                    "SlowPal": "DISABLED",
                    "SpatialAdaptiveQuantization": "ENABLED",
                    "TemporalAdaptiveQuantization": "ENABLED",
                    "FlickerAdaptiveQuantization": "DISABLED",
                    "EntropyEncoding": "CABAC",
                    "Bitrate": 400000,
                    "FramerateControl": "INITIALIZE_FROM_SOURCE",
                    "RateControlMode": "CBR",
                    "CodecProfile": "MAIN",
                    "Telecine": "NONE",
                    "MinIInterval": 0,
                    "AdaptiveQuantization": "HIGH",
                    "CodecLevel": "AUTO",
                    "FieldEncoding": "PAFF",
                    "SceneChangeDetect": "ENABLED",
                    "QualityTuningLevel": "SINGLE_PASS",
                    "FramerateConversionAlgorithm": "DUPLICATE_DROP",
                    "UnregisteredSeiTimecode": "DISABLED",
                    "GopSizeUnits": "FRAMES",
                    "ParControl": "INITIALIZE_FROM_SOURCE",
                    "NumberBFramesBetweenReferenceFrames": 2,
                    "RepeatPps": "DISABLED",
                    "DynamicSubGop": "STATIC"
                  }
                },
                "AfdSignaling": "NONE",
                "DropFrameTimecode": "ENABLED",
                "RespondToAfd": "NONE",
                "ColorMetadata": "INSERT"
              },
              "AudioDescriptions": [
                {
                  "AudioTypeControl": "FOLLOW_INPUT",
                  "CodecSettings": {
                    "Codec": "AAC",
                    "AacSettings": {
                      "AudioDescriptionBroadcasterMix": "NORMAL",
                      "Bitrate": 96000,
                      "RateControlMode": "CBR",
                      "CodecProfile": "LC",
                      "CodingMode": "CODING_MODE_2_0",
                      "RawFormat": "NONE",
                      "SampleRate": 48000,
                      "Specification": "MPEG4"
                    }
                  },
                  "LanguageCodeControl": "FOLLOW_INPUT"
                }
              ]
            }
          ],
          "OutputGroupSettings": {
            "Type": "FILE_GROUP_SETTINGS",
            "FileGroupSettings": {}
          }
        }
      ],
      "AdAvailOffset": 0
    },
    "StatusUpdateInterval": "SECONDS_60",
    "Priority": 0
}
```
O sistema retorna a carga útil JSON que enviada com a solicitação, mesmo quando a solicitação resulta em um erro. Portanto, o JSON retornado não é necessariamente a nova definição do modelo de trabalho.  
Como a carga útil do JSON pode ser longa, talvez seja necessário rolar para cima para ver as mensagens de erro.  
Para obter mais informações, consulte [Trabalhar com modelos de trabalho do AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [UpdateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-job-template.html) na *Referência de comandos da AWS CLI*. 

### `update-preset`
<a name="mediaconvert_UpdatePreset_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-preset`.

**AWS CLI**  
**Para alterar uma predefinição**  
O exemplo `update-preset` a seguir substitui a descrição da pré-definição especificada.  

```
aws mediaconvert update-preset \
--name Customer1 \
--description "New description text."
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Este comando não produz saída. Resultado:  

```
{
    "Preset": {
        "Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleMP4",
        "Settings": {
        ...<output settings removed for brevity>...
        },
        "Type": "CUSTOM",
        "LastUpdated": 1568938411,
        "Description": "New description text.",
        "Name": "SimpleMP4",
        "CreatedAt": 1568938240
    }
}
```
Para obter mais informações, consulte [Trabalhar com pré-definições de saída com o AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [UpdatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-preset.html) na *Referência de comandos da AWS CLI*. 

### `update-queue`
<a name="mediaconvert_UpdateQueue_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-queue`.

**AWS CLI**  
**Para alterar uma fila**  
O exemplo `update-queue` a seguir pausa a fila especificada, alterando seu status para `PAUSED`.  

```
aws mediaconvert update-queue \
--name Customer1 \
--status PAUSED
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "Queue": {
        "LastUpdated": 1568839845,
        "Status": "PAUSED",
        "ProgressingJobsCount": 0,
        "CreatedAt": 1526428516,
        "Arn": "arn:aws:mediaconvert:us-west-1:123456789012:queues/Customer1",
        "Name": "Customer1",
        "SubmittedJobsCount": 0,
        "PricingPlan": "ON_DEMAND",
        "Type": "CUSTOM"
    }
}
```
Para obter mais informações, consulte [Trabalhar com filas no AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) no *Guia do usuário do AWS Elemental MediaConvert*.  
+  Para ver detalhes da API, consulte [UpdateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-queue.html) na *Referência de comandos da AWS CLI*.