View a markdown version of this page

MediaConvert esempi di utilizzo AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

MediaConvert esempi di utilizzo AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with MediaConvert.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare cancel-job.

AWS CLI

Come annullare un processo in coda

L’esempio cancel-job seguente annulla il processo con l’ID 1234567891234-abc123. Non è possibile annullare un processo dopo che il servizio ne ha avviato l’elaborazione.

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

Per ottenere un endpoint specifico per l’account, utilizza describe-endpoints o invia il comando senza l’endpoint. Il servizio restituisce un errore e il tuo endpoint.

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Jobs nella Guida per l'utente di Elemental AWS . MediaConvert

  • Per i dettagli sull'API, consulta AWS CLI Command CancelJob Reference.

L’esempio di codice seguente mostra come utilizzare create-job-template.

AWS CLI

Come creare un modello di processo

L’esempio create-job-template seguente crea un modello di processo con le impostazioni di transcodifica specificate nel file job-template.json che si trova nel sistema.

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

Se crei il file JSON del modello di processo utilizzando get-job-template e quindi modificando il file, rimuovi l’oggetto JobTemplate, ma conserva al suo interno l’oggetto secondario Settings. Inoltre, assicurati di rimuovere le seguenti coppie chiave-valore: LastUpdated, Arn, Type e CreatedAt. Puoi specificare la categoria, la descrizione, il nome e la coda nel file JSON o nella riga di comando.

Per ottenere un endpoint specifico per l’account, utilizza describe-endpoints o invia il comando senza l’endpoint. Il servizio restituisce un errore e il tuo endpoint.

Se la richiesta ha esito positivo, il servizio restituisce la specifica JSON per il modello di processo che hai creato.

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Job Templates nella Guida per l'utente di Elemental. AWS MediaConvert

L’esempio di codice seguente mostra come utilizzare create-job.

AWS CLI

Come creare un processo

L’esempio create-job seguente crea un processo di transcodifica con le impostazioni specificate in un file job.json che si trova nel sistema da cui viene inviato il comando. Questa specifica del processo JSON può definire le singole impostazioni, fare riferimento a un modello di processo o a preimpostazioni di output.

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

Puoi utilizzare la MediaConvert console AWS Elemental per generare le specifiche del job JSON scegliendo le impostazioni del job e quindi scegliendo Show job JSON nella parte inferiore della sezione Job.

Per ottenere un endpoint specifico per l’account, utilizza describe-endpoints o invia il comando senza l’endpoint. Il servizio restituisce un errore e il tuo endpoint.

Se la richiesta ha esito positivo, il servizio restituisce la specifica del processo JSON inviata con la richiesta.

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Jobs nella Guida per l'utente di Elemental AWS . MediaConvert

  • Per i dettagli sull'API, consulta AWS CLI Command CreateJob Reference.

L’esempio di codice seguente mostra come utilizzare create-preset.

AWS CLI

Come creare una preimpostazione di output personalizzata

L’esempio create-preset seguente crea una preimpostazione di output personalizzata basata sulle impostazioni di output specificate nel file preset.json. Puoi specificare la categoria, la descrizione e il nome nel file JSON o nella riga di comando.

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

Se crei il file JSON con una preimpostazione utilizzando get-preset e quindi modifichi il file di output, assicurati di rimuovere le seguenti coppie chiave-valore: LastUpdated, Arn, Type e CreatedAt.

Per ottenere un endpoint specifico per l’account, utilizza describe-endpoints o invia il comando senza l’endpoint. Il servizio restituisce un errore e il tuo endpoint.

Per ulteriori informazioni, consultate Utilizzo dei preset di MediaConvert output AWS elementali nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, consulta Command CreatePreset Reference AWS CLI .

L’esempio di codice seguente mostra come utilizzare create-queue.

AWS CLI

Come creare una coda personalizzata

L’esempio create-queue seguente crea una coda di transcodifica personalizzata.

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

Per ottenere un endpoint specifico per l’account, utilizza describe-endpoints o invia il comando senza l’endpoint. Il servizio restituisce un errore e il tuo endpoint.

Output:

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

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Queues nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, vedi CreateQueue in Command Reference. AWS CLI

L’esempio di codice seguente mostra come utilizzare delete-job-template.

AWS CLI

Come eliminare un modello di processo

L’esempio delete-job-template seguente elimina il modello di processo specificato.

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

Questo comando non produce alcun output. Esegui aws mediaconvert list-job-templates per verificare che il modello sia stato eliminato.

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Job Templates nella Guida per l'utente di Elemental. AWS MediaConvert

L’esempio di codice seguente mostra come utilizzare delete-preset.

AWS CLI

Come eliminare una coda on demand

L’esempio delete-preset seguente elimina la preimpostazione personalizzata specificata.

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

Questo comando non produce alcun output. Esegui aws mediaconvert list-presets per verificare che la preimpostazione sia stata eliminata.

Per ulteriori informazioni, consultate Utilizzo dei preset di MediaConvert output AWS elementali nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, consulta Command DeletePreset Reference AWS CLI .

L’esempio di codice seguente mostra come utilizzare delete-queue.

AWS CLI

Come eliminare una coda on demand

L’esempio delete-queue seguente elimina la coda on demand personalizzata specificata.

Non è possibile eliminare la coda predefinita. Non è possibile eliminare una coda riservata che ha un piano tariffario attivo o che contiene processi non elaborati.

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

Questo comando non produce alcun output. Esegui aws mediaconvert list-queues per verificare che la coda sia stata eliminata.

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Queues nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, vedi DeleteQueue in Command Reference. AWS CLI

L’esempio di codice seguente mostra come utilizzare describe-endpoints.

AWS CLI

Come recuperare l’endpoint specifico dell’account

L’esempio describe-endpoints seguente recupera l’endpoint necessario per inviare qualsiasi altra richiesta al servizio.

aws mediaconvert describe-endpoints

Output:

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

Per ulteriori informazioni, consulta Guida introduttiva all' MediaConvert utilizzo dell'API in Elemental API Reference. AWS MediaConvert

L’esempio di codice seguente mostra come utilizzare get-job-template.

AWS CLI

Come ottenere dettagli su un modello di processo

L’esempio get-job-template seguente visualizza la definizione JSON del modello di processo personalizzato specificato.

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

Output:

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

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Job Templates nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, consulta la sezione AWS CLI Command GetJobTemplate Reference.

L’esempio di codice seguente mostra come utilizzare get-job.

AWS CLI

Come ottenere dettagli su un determinato processo

L’esempio seguente richiede le informazioni per il processo con ID 1234567890987-1ab2c3, che in questo esempio è terminato con un errore.

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

Per ottenere un endpoint specifico per l’account, utilizza describe-endpoints o invia il comando senza l’endpoint. Il servizio restituisce un errore e il tuo endpoint.

Se la richiesta ha esito positivo, il servizio restituisce un file JSON contenente le informazioni sul processo, incluse le relative impostazioni, eventuali errori restituiti e altri dati sul processo, come indicato di seguito:

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

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Jobs nella Guida per l'utente di AWS MediaConvert Elemental.

  • Per i dettagli sull'API, consulta AWS CLI Command GetJob Reference.

L’esempio di codice seguente mostra come utilizzare get-preset.

AWS CLI

Come ottenere dettagli su una particolare preimpostazione

L’esempio get-preset seguente richiede la definizione JSON della preimpostazione personalizzata specificata.

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

Output:

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

Per ulteriori informazioni, consultate Utilizzo dei preset di MediaConvert output AWS elementali nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, consulta Command GetPreset Reference AWS CLI .

L’esempio di codice seguente mostra come utilizzare get-queue.

AWS CLI

Come ottenere dettagli su una coda

L’esempio get-queue seguente recupera i dettagli della coda personalizzata specificata.

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

Output:

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

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Queues nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, vedi GetQueue in Command Reference. AWS CLI

L’esempio di codice seguente mostra come utilizzare list-job-templates.

AWS CLI

Esempio 1: come elencare i modelli di processo personalizzati

L’esempio list-job-templates seguente elenca tutti i modelli di processo personalizzati nella Regione corrente. Per elencare i modelli di processo del sistema, consulta l’esempio successivo.

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

Output:

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

Esempio 2: Per elencare i modelli di lavoro di sistema MediaConvert

L’esempio list-job-templates seguente elenca tutti i modelli di processo di sistema.

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

Output:

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

Per ulteriori informazioni, consulta Lavorare con i modelli di MediaConvert lavoro AWS Elemental nella Guida per l' MediaConvert utente di AWS Elemental.

  • Per i dettagli sull'API, consulta la sezione AWS CLI Command ListJobTemplates Reference.

L’esempio di codice seguente mostra come utilizzare list-jobs.

AWS CLI

Come ottenere dettagli su tutti i processi in una Regione

L’esempio seguente richiede le informazioni per tutti i processi nella Regione specificata.

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

Per ottenere un endpoint specifico per l’account, utilizza describe-endpoints o invia il comando senza l’endpoint. Il servizio restituisce un errore e il tuo endpoint.

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Jobs nella Guida per l'utente di AWS MediaConvert Elemental.

  • Per i dettagli sull'API, consulta AWS CLI Command ListJobs Reference.

L’esempio di codice seguente mostra come utilizzare list-presets.

AWS CLI

Esempio 1: come elencare le preimpostazioni di output personalizzate

L’esempio list-presets seguente elenca le preimpostazioni di output personalizzate. Per elencare le preimpostazioni del sistema, consulta l’esempio successivo.

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

Output:

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

Esempio 2: come elencare le preimpostazioni di output del sistema

L'list-presetsesempio seguente elenca i preset di sistema disponibili. MediaConvert Per elencare le preimpostazioni personalizzate, consulta l’esempio precedente.

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

Output:

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

Per ulteriori informazioni, consultate Utilizzo dei preset di MediaConvert output AWS elementali nella Guida per l'utente di AWS MediaConvert Elemental.

  • Per i dettagli sull'API, consulta Command ListPresets Reference AWS CLI .

L’esempio di codice seguente mostra come utilizzare list-queues.

AWS CLI

Come elencare le code

L'list-queuesesempio seguente elenca tutte le MediaConvert code.

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

Output:

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

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Queues nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, vedi ListQueues in Command Reference. AWS CLI

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Per elencare i tag su una MediaConvert coda, un modello di lavoro o un predefinito di output

L’esempio list-tags-for-resource seguente elenca i tag per la preimpostazione specificata.

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

Output:

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

Per ulteriori informazioni, consultate Tagging AWS Elemental MediaConvert Queues, Job Templates e Output Preets nella Guida per l'utente di Elemental. AWS MediaConvert

L’esempio di codice seguente mostra come utilizzare update-job-template.

AWS CLI

Come creare un modello di processo

L’esempio update-job-template seguente sostituisce la definizione JSON del modello di processo personalizzato specificato con la definizione JSON presente nel file fornito.

aws mediaconvert update-job-template --name File1 --endpoint-url --cli-input-json file: //~/job-template-update.json https://abcd1234.mediaconvert.us-west-2.amazonaws.com

Contenuto di 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
}

Il sistema restituisce il payload JSON inviato con la richiesta, anche quando la richiesta genera un errore. Pertanto, il codice JSON restituito non è necessariamente la nuova definizione del modello di processo.

Poiché il payload JSON può essere lungo, potrebbe essere necessario scorrere verso l’alto per visualizzare eventuali messaggi di errore.

Per ulteriori informazioni, consulta Lavorare con Elemental Job Templates nella Guida per l'utente di Elemental. AWS MediaConvert AWS MediaConvert

L’esempio di codice seguente mostra come utilizzare update-preset.

AWS CLI

Come modificare una preimpostazione

L’esempio update-preset seguente sostituisce la descrizione per la preimpostazione specificata.

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

Questo comando non produce alcun output. Output:

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

Per ulteriori informazioni, consultate Utilizzo dei preset di MediaConvert output di AWS Elemental nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, consulta Command UpdatePreset Reference AWS CLI .

L’esempio di codice seguente mostra come utilizzare update-queue.

AWS CLI

Come modificare una coda

L’esempio update-queue seguente mette in pausa la coda specificata, modificandone lo stato in PAUSED.

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

Output:

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

Per ulteriori informazioni, consulta Lavorare con AWS Elemental MediaConvert Queues nella Guida per l'utente di Elemental. AWS MediaConvert

  • Per i dettagli sull'API, vedi UpdateQueue in Command Reference. AWS CLI