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.
Temas
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 ID1234567891234-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
\ --regionregion-name-1
\ --id1234567891234-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 archivojob-template.json
que reside en el 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
Si crea el archivo JSON de plantilla de trabajos utilizando
get-job-template
y, a continuación, modifica el archivo, elimine el objetoJobTemplate
, 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
yCreatedAt
. 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 archivojob.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
\ --regionregion-name-1
\ --cli-input-jsonfile://~/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 archivopreset.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
--regionregion-name-1
\ --cli-input-jsonfile://~/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
yCreatedAt
.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
\ --regionregion-name-1
\ --nameQueue1
\ --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-urlhttps://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-urlhttps://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-urlhttps://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-urlhttps://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
\ --regionregion-name-1
\ --id1234567890987-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-urlhttps://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-urlhttps://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-bySYSTEM
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
\ --regionregion-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-urlhttps://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-urlhttps://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 aPAUSED
.aws mediaconvert update-queue \ --name
Customer1
\ --statusPAUSED
--endpoint-urlhttps://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.
-