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
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-joba seguir cancela um trabalho que tenha o ID1234567891234-abc123. Não é possível cancelar um trabalho depois que o serviço começar a processá-lo.aws mediaconvert cancel-job \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --id1234567891234-abc123Use
describe-endpointspara 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-templatea seguir cria um trabalho com as configurações de transcodificação especificadas em um arquivojob-template.jsonpresente no sistema.aws mediaconvert create-job-template \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --nameJobTemplate1\ --cli-input-jsonfile://~/job-template.jsonSe o arquivo de modelo de trabalho JSON criado usando
get-job-templatefor posteriormente modificando, é necessário remover o objetoJobTemplate, mas manter o objeto-filho de Configurações dentro dele. Além disso, deve-se remover os seguintes pares de valores-chave:LastUpdated,Arn,TypeeCreatedAt. É possível especificar a categoria, a descrição, o nome e a fila no arquivo JSON ou na linha de comando.Use
describe-endpointspara 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-joba seguir cria um trabalho de transcodificação com as configurações especificadas em um arquivojob.jsonpresente 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-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --cli-input-jsonfile://~/job.jsonVocê 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-endpointspara 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-preseta seguir cria uma predefinição de saída personalizada com base nas configurações de saída especificadas no arquivopreset.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-urlhttps://abcd1234---mediaconvert---region-name-1.amazonaws.com.rproxy.govskope.ca--regionregion-name-1\ --cli-input-jsonfile://~/preset.jsonSe o arquivo de pré-definições JSON for criado usando
get-presete o arquivo de saída for posteriormente modificando, é necessário remover os seguintes pares de valores-chave:LastUpdated,Arn,TypeeCreatedAt.Use
describe-endpointspara 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-queuea seguir cria uma fila de transcodificação personalizada.aws mediaconvert create-queue \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --nameQueue1\ --description"Keep this queue empty unless job is urgent."Use
describe-endpointspara 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-templatea seguir exclui o modelo de trabalho personalizado especificado.aws mediaconvert delete-job-template \ --name"DASH Streaming"\ --endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caEste comando não produz saída. Execute
aws mediaconvert list-job-templatespara 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-preseta seguir exclui a pré-definição personalizada especificada.aws mediaconvert delete-preset \ --nameSimpleMP4\ --endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caEste comando não produz saída. Execute
aws mediaconvert list-presetspara 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-queuea 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 \ --nameCustomer1\ --endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caEste comando não produz saída. Execute
aws mediaconvert list-queuespara 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-endpointsa seguir recupera o endpoint necessário para enviar qualquer outra solicitação ao serviço.aws mediaconvert describe-endpointsSaí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-templatea seguir exibe a definição JSON do modelo de trabalho personalizado especificado.aws mediaconvert get-job-template \ --name"DASH Streaming"\ --endpoint-urlhttps://abcd1234---mediaconvert---us-east-1.amazonaws.com.rproxy.govskope.caSaí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-1ab2c3que, neste exemplo, resultou em erro.aws mediaconvert get-job \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --id1234567890987-1ab2c3Use
describe-endpointspara 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-preseta seguir solicita a definição JSON da pré-definição personalizada especificada.aws mediaconvert get-preset \ --nameSimpleMP4\ --endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caSaí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-queuea seguir recupera detalhes sobre a fila personalizada especificada.aws mediaconvert get-queue \ --nameCustomer1\ --endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caSaí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-templatesa 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-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caSaí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-templatesa seguir lista todos os modelos de trabalho do sistema.aws mediaconvert list-job-templates \ --endpoint-urlhttps://abcd1234.mediaconvert.us-east-1.amazonaws.com\ --list-bySYSTEMSaí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-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1Use
describe-endpointspara 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-presetsa 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-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caSaí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-presetsa 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-bySYSTEM\ --endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caSaí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-queuesa seguir lista todas as filas MediaConvert.aws mediaconvert list-queues \ --endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caSaí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-resourcea seguir lista as tags da pré-definição de saída especificada.aws mediaconvert list-tags-for-resource \ --arnarn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4\ --endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caSaí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-templatea 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-preseta 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.rproxy.govskope.caEste 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-queuea seguir pausa a fila especificada, alterando seu status paraPAUSED.aws mediaconvert update-queue \ --nameCustomer1\ --statusPAUSED--endpoint-urlhttps://abcd1234---mediaconvert---us-west-2.amazonaws.com.rproxy.govskope.caSaí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.
-