MediaConvert exemplos usando AWS CLI - AWS Exemplos de código do SDK
Ações

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

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á.

MediaConvert exemplos usando 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 with 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

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

  • Para obter detalhes da API, consulte CancelJobem Referência de AWS CLI Comandos.

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 Working with AWS Elemental MediaConvert Job Templates no AWS Elemental MediaConvert User Guide.

  • Para obter detalhes da API, consulte CreateJobTemplateem Referência de AWS CLI Comandos.

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 MediaConvert console AWS Elemental para gerar a especificação de trabalho JSON escolhendo suas configurações de trabalho e, em seguida, escolhendo Mostrar trabalho JSON 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 Trabalhando com MediaConvert tarefas AWS elementares no Guia do MediaConvert usuário do AWS Elemental.

  • Para obter detalhes da API, consulte CreateJobem Referência de AWS CLI Comandos.

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 Trabalhando com predefinições de MediaConvert saída AWS elementares no Guia do usuário do AWS Elemental MediaConvert .

  • Para obter detalhes da API, consulte CreatePresetem Referência de AWS CLI Comandos.

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

  • Para obter detalhes da API, consulte CreateQueueem Referência de AWS CLI Comandos.

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 Working with AWS Elemental MediaConvert Job Templates no AWS Elemental MediaConvert User Guide.

  • Para obter detalhes da API, consulte DeleteJobTemplateem Referência de AWS CLI Comandos.

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 Trabalhando com predefinições de MediaConvert saída AWS elementares no Guia do usuário do AWS Elemental MediaConvert .

  • Para obter detalhes da API, consulte DeletePresetem Referência de AWS CLI Comandos.

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

  • Para obter detalhes da API, consulte DeleteQueueem Referência de AWS CLI Comandos.

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 Introdução ao MediaConvert uso da API na Referência da MediaConvert API AWS Elemental.

  • Para obter detalhes da API, consulte DescribeEndpointsem Referência de AWS CLI Comandos.

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 Working with AWS Elemental MediaConvert Job Templates no AWS Elemental MediaConvert User Guide.

  • Para obter detalhes da API, consulte GetJobTemplateem Referência de AWS CLI Comandos.

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

  • Para obter detalhes da API, consulte GetJobem Referência de AWS CLI Comandos.

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 Trabalhando com predefinições de MediaConvert saída AWS elementares no Guia do usuário do AWS Elemental MediaConvert .

  • Para obter detalhes da API, consulte GetPresetem Referência de AWS CLI Comandos.

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

  • Para obter detalhes da API, consulte GetQueueem Referência de AWS CLI Comandos.

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: Para listar os modelos MediaConvert de trabalho do sistema

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 Working with AWS Elemental MediaConvert Job Templates no AWS Elemental MediaConvert User Guide.

  • Para obter detalhes da API, consulte ListJobTemplatesem Referência de AWS CLI Comandos.

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

  • Para obter detalhes da API, consulte ListJobsem Referência de AWS CLI Comandos.

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 list-presets exemplo a seguir lista as predefinições MediaConvert de sistema 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 Trabalhando com predefinições de MediaConvert saída AWS elementares no Guia do usuário do AWS Elemental MediaConvert .

  • Para obter detalhes da API, consulte ListPresetsem Referência de AWS CLI Comandos.

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

AWS CLI

Para listar as filas

O list-queues exemplo a seguir lista todas as suas MediaConvert filas.

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

  • Para obter detalhes da API, consulte ListQueuesem Referência de AWS CLI Comandos.

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

AWS CLI

Para listar as tags em uma MediaConvert fila, modelo de trabalho ou predefinição de saída

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 Como marcar MediaConvert filas AWS elementares, modelos de trabalho e predefinições de saída no Guia do usuário do AWS Elemental. MediaConvert

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 Arquivo1 https://abcd1234.mediaconvert.us-west-2.amazonaws.com --endpoint-url -- arquivo: //~/.json cli-input-json job-template-update

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 Working with AWS Elemental MediaConvert Job Templates no AWS Elemental MediaConvert User Guide.

  • Para obter detalhes da API, consulte UpdateJobTemplateem Referência de AWS CLI Comandos.

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 Trabalhando com predefinições de MediaConvert saída AWS elementares no Guia do usuário do AWS Elemental MediaConvert .

  • Para obter detalhes da API, consulte UpdatePresetem Referência de AWS CLI Comandos.

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

  • Para obter detalhes da API, consulte UpdateQueueem Referência de AWS CLI Comandos.