Exemplos do MediaConvert usando o AWS CLI

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.

Tópicos

Ações

Ações

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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte CancelJob na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte CreateJobTemplate na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Elemental MediaConvert.

Para obter detalhes da API, consulte CreateJob na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte CreatePreset na Referência de comandos da AWS CLI.

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.

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para obter detalhes da API, consulte CreateQueue na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte DeleteJobTemplate na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte DeletePreset na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Elemental MediaConvert.

Para obter detalhes da API, consulte DeleteQueue na Referência de comandos da AWS CLI.

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

Saída:


{
    "Endpoints": [
        {
            "Url": "https://abcd1234.mediaconvert.region-name-1.amazonaws.com"
        }
    ]
}

Para obter mais informações, consulte Conceitos básicos do MediaConvert usando a API na Referência da API do AWS MediaConvert.

Para ver detalhes da API, consulte DescribeEndpoints na Referência de comandos da AWS CLI.

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

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte GetJobTemplate na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Elemental MediaConvert.

Para obter detalhes da API, consulte GetJob na Referência de comandos da AWS CLI.

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

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte GetPreset na Referência de comandos da AWS CLI.

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

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte GetQueue na Referência de comandos da AWS CLI.

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

Saída:


{
    "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

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte ListJobTemplates na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Elemental MediaConvert.

Para obter detalhes da API, consulte ListJobs na Referência de comandos da AWS CLI.

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

Saída:


{
    "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

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte ListPresets na Referência de comandos da AWS CLI.

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

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para obter detalhes da API, consulte ListQueues na Referência de comandos da AWS CLI.

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

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para obter detalhes sobre a API, consulte ListTagsForResource na AWS CLI Command Reference.

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://~/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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte UpdateJobTemplate na Referência de comandos da AWS CLI.

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. Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte UpdatePreset na Referência de comandos da AWS CLI.

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

Saída:


{
    "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 no Guia do usuário do AWS Elemental MediaConvert.

Para ver detalhes da API, consulte UpdateQueue na Referência de comandos da AWS CLI.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

MediaConnect

MediaLive