Ejemplos de MediaConvert que utilizan la AWS CLI - AWS Command Line Interface

Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Ejemplos de MediaConvert que utilizan la AWS CLI

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con MediaConvert.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar cancel-job.

AWS CLI

Para cancelar un trabajo que está en una cola

En el siguiente ejemplo de cancel-job, se cancela un trabajo con el ID 1234567891234-abc123. No se puede cancelar un trabajo cuando el servicio comience a procesarlo.

aws mediaconvert cancel-job \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 \ --id 1234567891234-abc123

Para obtener el punto de conexión específico de su cuenta, utilice describe-endpoints o envíe el comando sin el punto de conexión. El servicio devuelve un error y su punto de conexión.

Para obtener más información, consulte Trabajar con AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener más información sobre la API, consulte CancelJob en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-job-template.

AWS CLI

Para crear una nueva plantilla de trabajo

En el siguiente ejemplo de create-job-template, se crea una plantilla de trabajos con la configuración de transcodificación especificada en un archivo job-template.json que reside en el 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

Si crea el archivo JSON de plantilla de trabajos utilizando get-job-template y, a continuación, modifica el archivo, elimine el objeto JobTemplate, pero mantenga el objeto secundario de Configuración dentro de él. Asimismo, asegúrese de eliminar los siguientes pares de clave-valor: LastUpdated, Arn, Type y CreatedAt. Puede especificar la categoría, la descripción, el nombre y la cola en el archivo JSON o en la línea de comandos.

Para obtener el punto de conexión específico de su cuenta, utilice describe-endpoints o envíe el comando sin el punto de conexión. El servicio devuelve un error y su punto de conexión.

Si la solicitud se realiza correctamente, el servicio devuelve la especificación JSON para la plantilla de trabajos que ha creado.

Para obtener más información, consulte Uso de plantillas de tarea de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte CreateJobTemplate en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-job.

AWS CLI

Creación de un trabajo

En el siguiente ejemplo de create-job se crea un trabajo de transcodificación con la configuración especificada en un archivo job.json que reside en el sistema desde el que se envía el comando. Esta especificación de trabajo de JSON puede especificar cada configuración de forma individual, hacer referencia a una plantilla de trabajo o hacer referencia a ajustes preestablecidos de salida.

aws mediaconvert create-job \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 \ --cli-input-json file://~/job.json

Puede utilizar la consola de AWS Elemental MediaConvert para generar la especificación de trabajo de JSON eligiendo la configuración del trabajo y, a continuación, eligiendo Mostrar JSON del trabajo en la parte inferior de la sección Trabajo.

Para obtener el punto de conexión específico de su cuenta, utilice describe-endpoints o envíe el comando sin el punto de conexión. El servicio devuelve un error y su punto de conexión.

Si la solicitud se realiza correctamente, el servicio devuelve la especificación de trabajo JSON que envió con la solicitud.

Para obtener más información, consulte Trabajar con AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener más información sobre la API, consulte CreateJob en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-preset.

AWS CLI

Para crear un elemento preestablecido de salida personalizado

En el siguiente ejemplo de create-preset, se crea un elemento preestablecido de salida personalizado basado en la configuración de salida especificada en el archivo preset.json. Puede especificar la categoría, la descripción y el nombre en el archivo JSON o en la línea de comandos.

aws mediaconvert create-preset \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com --region region-name-1 \ --cli-input-json file://~/preset.json

Si crea el archivo JSON preestablecido utilizando get-preset y, a continuación, modificando el archivo de salida, asegúrese de eliminar los siguientes pares clave-valor: LastUpdated, Arn, Type y CreatedAt.

Para obtener el punto de conexión específico de su cuenta, utilice describe-endpoints o envíe el comando sin el punto de conexión. El servicio devuelve un error y su punto de conexión.

Para obtener más información, consulte Trabajar con elementos preestablecidos de salida de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte CreatePreset en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-queue.

AWS CLI

Para crear una cola

En el siguiente ejemplo de create-queue, se crea una cola de transcodificación 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."

Para obtener el punto de conexión específico de su cuenta, utilice describe-endpoints o envíe el comando sin el punto de conexión. El servicio devuelve un error y su punto de conexión.

Salida:

{ "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 obtener más información, consulte Trabajar con colas en AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte CreateQueue en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-job-template.

AWS CLI

Para eliminar una plantilla de trabajo

En el siguiente ejemplo de delete-job-template, se elimina la plantilla de trabajo personalizada especificada.

aws mediaconvert delete-job-template \ --name "DASH Streaming" \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

Este comando no genera ninguna salida. Ejecute aws mediaconvert list-job-templates para confirmar que se ha eliminado la plantilla.

Para obtener más información, consulte Uso de plantillas de tarea de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte DeleteJobTemplate en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-preset.

AWS CLI

Para eliminar una cola bajo demanda personalizada

En el siguiente ejemplo de delete-preset, se elimina el elemento preestablecido especificado.

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

Este comando no genera ninguna salida. Ejecute aws mediaconvert list-presets para confirmar que se ha eliminado el elemento preestablecido.

Para obtener más información, consulte Trabajar con elementos preestablecidos de salida de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte DeletePreset en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-queue.

AWS CLI

Para eliminar una cola bajo demanda personalizada

En el siguiente ejemplo de delete-queue, se elimina la cola bajo demanda personalizada especificada.

No puede eliminar la cola predeterminada. No se puede eliminar una cola reservada que tenga un plan de precios activo o que contenga trabajos sin procesar.

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

Este comando no genera ninguna salida. Ejecute aws mediaconvert list-queues para confirmar que se ha eliminado la cola.

Para obtener más información, consulte Trabajar con colas en AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte DeleteQueue en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-endpoints.

AWS CLI

Para obtener un punto de conexión específico de la cuenta

En el siguiente ejemplo de describe-endpoints, se recupera el punto de conexión que necesita para enviar cualquier otra solicitud al servicio.

aws mediaconvert describe-endpoints

Salida:

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

Para obtener más información, consulte la Getting Started with MediaConvert Using the API en la AWSReferencia de la API de MediaConvert.

  • Para obtener detalles sobre la API, consulte DescribeEndpoints en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-job-template.

AWS CLI

Para obtener detalles sobre una plantilla de trabajo

En el siguiente ejemplo de get-job-template, se muestra la definición JSON de la plantilla de trabajo personalizada especificada.

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

Salida:

{ "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 obtener más información, consulte Uso de plantillas de tarea de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte GetJobTemplate en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-job.

AWS CLI

Obtención de los detalles de un trabajo en particular

En el siguiente ejemplo, se solicita la información del trabajo con el ID 1234567890987-1ab2c3, que en este ejemplo finalizó con un error.

aws mediaconvert get-job \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 \ --id 1234567890987-1ab2c3

Para obtener el punto de conexión específico de su cuenta, utilice describe-endpoints o envíe el comando sin el punto de conexión. El servicio devuelve un error y su punto de conexión.

Si la solicitud se realiza correctamente, el servicio devuelve un archivo JSON con la información del trabajo, incluida la configuración de este, los errores devueltos y otros datos del trabajo, de la siguiente manera:

{ "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 obtener más información, consulte Trabajar con AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener más información sobre la API, consulte GetJob en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-preset.

AWS CLI

Para obtener detalles de un elemento preestablecido en particular

En el siguiente ejemplo de get-preset, se solicita la definición JSON del elemento preestablecido personalizado especificado.

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

Salida:

{ "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 obtener más información, consulte Trabajar con elementos preestablecidos de salida de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte GetPreset en la Referencia de comandos de AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-queue.

AWS CLI

Para obtener información de una cola

En el siguiente ejemplo de get-queue, se recuperan los detalles sobre la cola personalizada especificada.

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

Salida:

{ "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 obtener más información, consulte Trabajar con colas en AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte GetQueue en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-job-templates.

AWS CLI

Ejemplo 1: mostrar plantillas de trabajo personalizadas

En el siguiente ejemplo de list-job-templates, se muestran todas las plantillas de trabajos personalizadas de la región actual. Para ver una lista de las plantillas de trabajo del sistema, consulte el siguiente ejemplo.

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

Salida:

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

Ejemplo 2: mostrar las plantillas de trabajo del sistema de MediaConvert

En el siguiente ejemplo de list-job-templates, se muestran todas las plantillas de trabajo del sistema.

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

Salida:

{ "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 obtener más información, consulte Uso de plantillas de tarea de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte ListJobTemplates en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-jobs.

AWS CLI

Obtención de los detalles de todos los trabajos de una región

En el siguiente ejemplo se solicita la información de todos los trabajos de la región especificada.

aws mediaconvert list-jobs \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1

Para obtener el punto de conexión específico de su cuenta, utilice describe-endpoints o envíe el comando sin el punto de conexión. El servicio devuelve un error y su punto de conexión.

Para obtener más información, consulte Trabajar con AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte ListJobs en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-presets.

AWS CLI

Ejemplo 1: mostrar los elementos preestablecidos de salida personalizados

En el siguiente ejemplo de list-presets, se muestran los elementos preestablecidos de salida personalizados. Para ver una lista de los elementos preestablecidos del sistema, consulte el siguiente ejemplo.

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

Salida:

{ "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." } ] }

Ejemplo 2: mostrar los elementos preestablecidos de salida del sistema

El siguiente ejemplo de list-presets muestra los elementos preestablecidos disponibles del sistema de MediaConvert. Para ver una lista de los elementos preestablecidos personalizados, consulte el ejemplo anterior.

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

Salida:

{ "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 obtener más información, consulte Trabajar con elementos preestablecidos de salida de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte ListPresets en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-queues.

AWS CLI

Para mostrar colas

En el siguiente ejemplo de list-queues, se muestran todas las colas de MediaConvert.

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

Salida:

{ "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 obtener más información, consulte Trabajar con colas en AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte ListQueues en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-tags-for-resource.

AWS CLI

Para mostrar las etiquetas de una cola, plantilla de trabajo o elemento preestablecido de salida de MediaConvert

En el siguiente ejemplo de list-tags-for-resource, se muestran las etiquetas del elemento preestablecido de salida especificado.

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

Salida:

{ "ResourceTags": { "Tags": { "customer": "zippyVideo" }, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4" } }

Para obtener más información, consulte Etiquetado de recursos de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte ListTagsForResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-job-template.

AWS CLI

Para cambiar una plantilla de trabajo

En el siguiente ejemplo de update-job-template, se reemplaza la definición de JSON de la plantilla de trabajo personalizada especificada por la definición de JSON del archivo proporcionado.

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

Contenido 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 }

El sistema devuelve la carga útil de JSON que usted envía con la solicitud, incluso si la solicitud produce un error. Por tanto, el JSON devuelto no es necesariamente la nueva definición de la plantilla de trabajo.

Dado que la carga útil de JSON puede ser larga, es posible que tenga que desplazarse hacia arriba para ver los mensajes de error.

Para obtener más información, consulte Uso de plantillas de tarea de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte UpdateJobTemplate en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-preset.

AWS CLI

Para cambiar un elemento preestablecido

En el siguiente ejemplo de update-preset, se reemplaza la descripción del elemento preestablecido especificado.

aws mediaconvert update-preset \ --name Customer1 \ --description "New description text." --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

Este comando no genera ninguna salida. Salida:

{ "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 obtener más información, consulte Trabajar con elementos preestablecidos de salida de AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte UpdatePreset en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-queue.

AWS CLI

Para cambiar una cola

En el siguiente ejemplo de update-queue, se pausa la cola especificada, cambiando su estado a PAUSED.

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

Salida:

{ "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 obtener más información, consulte Trabajar con colas en AWS Elemental MediaConvert en la Guía del usuario de AWS Elemental MediaConvert.

  • Para obtener información sobre la API, consulte UpdateQueue en la Referencia de comandos de la AWS CLI.