Há mais AWS SDK exemplos disponíveis no GitHub repositório AWS Doc SDK Examples
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 funções de serviço individuais, é possível ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.
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
cancel-job
exemplo a seguir cancela o trabalho com ID1234567891234-abc123
. Você não pode cancelar um trabalho que o serviço começou a processar.aws mediaconvert cancel-job \ --endpoint-url
https://abcd1234.mediaconvert.region-name-1.amazonaws.com
\ --regionregion-name-1
\ --id1234567891234-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 API obter detalhes, consulte CancelJob
na 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
create-job-template
exemplo a seguir cria um modelo de trabalho com as configurações de transcodificação especificadas no arquivojob-template.json
que reside no seu sistema.aws mediaconvert create-job-template \ --endpoint-url
https://abcd1234.mediaconvert.region-name-1.amazonaws.com
\ --regionregion-name-1
\ --nameJobTemplate1
\ --cli-input-jsonfile://~/job-template.json
Se você criar seu JSON arquivo de modelo de trabalho usando
get-job-template
e depois modificando o arquivo, remova oJobTemplate
objeto, mas mantenha o objeto secundário de Configurações dentro dele. Além disso, certifique-se de remover os seguintes pares de valores-chave:LastUpdated
,Arn
Type
, e.CreatedAt
Você pode especificar a categoria, a descrição, o nome e a fila no JSON arquivo 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 sua solicitação for bem-sucedida, o serviço retornará a JSON especificação do modelo de trabalho que você criou.
Para obter mais informações, consulte Working with AWS Elemental MediaConvert Job Templates no AWS Elemental MediaConvert User Guide.
-
Para API obter detalhes, consulte CreateJobTemplate
na 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 arquivojob.json
presente no sistema que você usou para enviar o comando. Essa especificação de JSON trabalho pode especificar cada configuração individualmente, fazer referência a um modelo de trabalho ou referenciar predefinições de saída.aws mediaconvert create-job \ --endpoint-url
https://abcd1234.mediaconvert.region-name-1.amazonaws.com
\ --regionregion-name-1
\ --cli-input-jsonfile://~/job.json
Você pode usar o MediaConvert console AWS Elemental para gerar a especificação do JSON trabalho escolhendo as configurações do 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 sua solicitação for bem-sucedida, o serviço retornará a especificação do JSON trabalho que você enviou com sua solicitação.
Para obter mais informações, consulte Trabalhando com MediaConvert tarefas AWS elementares no Guia do MediaConvert usuário do AWS Elemental.
-
Para API obter detalhes, consulte CreateJob
na 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
create-preset
exemplo a seguir cria uma predefinição de saída personalizada com base nas configurações de saída especificadas no arquivopreset.json
. Você pode especificar a categoria, a descrição e o nome no JSON arquivo ou na linha de comando.aws mediaconvert create-preset \ --endpoint-url
https://abcd1234.mediaconvert.region-name-1.amazonaws.com
--regionregion-name-1
\ --cli-input-jsonfile://~/preset.json
Se você criar seu JSON arquivo predefinido usando
get-preset
e modificando o arquivo de saída, certifique-se de remover os seguintes pares de valores-chave:LastUpdated
,, e.Arn
Type
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 API obter detalhes, consulte CreatePreset
na 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
create-queue
exemplo a seguir cria uma fila de transcodificação personalizada.aws mediaconvert create-queue \ --endpoint-url
https://abcd1234.mediaconvert.region-name-1.amazonaws.com
\ --regionregion-name-1
\ --nameQueue1
\ --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 API obter detalhes, consulte CreateQueue
na 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
delete-job-template
exemplo a 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
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 API obter detalhes, consulte DeleteJobTemplate
na 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 personalizada
O
delete-preset
exemplo a seguir exclui a predefinição personalizada especificada.aws mediaconvert delete-preset \ --name
SimpleMP4
\ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com
Este comando não produz saída. Execute
aws mediaconvert list-presets
para confirmar que sua predefiniçã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 API obter detalhes, consulte DeletePreset
na 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 personalizada
O
delete-queue
exemplo a seguir exclui a fila sob demanda personalizada especificada.Você não pode 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-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com
Este comando não produz saída. Execute
aws mediaconvert list-queues
para confirmar que sua 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 API obter detalhes, consulte DeleteQueue
na 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 sua conta
O
describe-endpoints
exemplo a seguir recupera o endpoint de que você precisa 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 do API na MediaConvert APIReferência AWS Elemental.
-
Para API obter detalhes, consulte DescribeEndpoints
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar get-job-template
.
- AWS CLI
-
Para obter detalhes de um modelo de trabalho
O
get-job-template
exemplo a seguir exibe a JSON definição do modelo de trabalho personalizado especificado.aws mediaconvert get-job-template \ --name
"DASH Streaming"
\ --endpoint-urlhttps://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 API obter detalhes, consulte GetJobTemplate
na 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
\ --regionregion-name-1
\ --id1234567890987-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 sua solicitação for bem-sucedida, o serviço retornará um JSON arquivo com informações do trabalho, incluindo 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 API obter detalhes, consulte GetJob
na 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 predefinição específica
O
get-preset
exemplo a seguir solicita a JSON definição da predefinição personalizada especificada.aws mediaconvert get-preset \ --name
SimpleMP4
\ --endpoint-urlhttps://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 API obter detalhes, consulte GetPreset
na 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
get-queue
exemplo a seguir recupera os detalhes da fila personalizada especificada.aws mediaconvert get-queue \ --name
Customer1
\ --endpoint-urlhttps://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 API obter detalhes, consulte GetQueue
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-job-templates
.
- AWS CLI
-
Exemplo 1: Para listar seus modelos de trabalho personalizados
O
list-job-templates
exemplo a seguir lista todos os modelos de trabalho personalizados na região atual. Para listar os modelos de trabalho do sistema, veja 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
list-job-templates
exemplo 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-bySYSTEM
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 API obter detalhes, consulte ListJobTemplates
na 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
\ --regionregion-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 API obter detalhes, consulte ListJobs
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-presets
.
- AWS CLI
-
Exemplo 1: Para listar suas predefinições de saída personalizadas
O
list-presets
exemplo a seguir lista suas predefinições de saída personalizadas. Para listar as predefinições do sistema, veja 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: Para 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, veja o exemplo anterior.aws mediaconvert list-presets \ --list-by
SYSTEM
\ --endpoint-urlhttps://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 API obter detalhes, consulte ListPresets
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-queues
.
- AWS CLI
-
Para listar suas 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 API obter detalhes, consulte ListQueues
na 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
list-tags-for-resource
exemplo a seguir lista as tags na predefinição de saída especificada.aws mediaconvert list-tags-for-resource \ --arn
arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4
\ --endpoint-urlhttps://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
-
Para API obter detalhes, consulte ListTagsForResource
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar update-job-template
.
- AWS CLI
-
Para alterar um modelo de trabalho
O
update-job-template
exemplo a seguir substitui a JSON definição do modelo de trabalho personalizado especificado pela JSON definição 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 JSON carga que você envia com sua 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 JSON carga útil 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 API obter detalhes, consulte UpdateJobTemplate
na 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
update-preset
exemplo a seguir substitui a descrição da predefiniçã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 API obter detalhes, consulte UpdatePreset
na 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
update-queue
exemplo a seguir pausa a fila especificada, alterando seu status para.PAUSED
aws mediaconvert update-queue \ --name
Customer1
\ --statusPAUSED
--endpoint-urlhttps://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 API obter detalhes, consulte UpdateQueue
na Referência de AWS CLI Comandos.
-