MediaConvert esempi utilizzando AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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 utilizzando 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

Il seguente esempio di codice mostra come utilizzarecancel-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' MediaConvert utente di AWS Elemental.

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

Il seguente esempio di codice mostra come utilizzarecreate-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 Working with AWS Elemental MediaConvert Job Templates nella Guida per l' MediaConvert utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzarecreate-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 lavoro JSON scegliendo le impostazioni del lavoro e quindi scegliendo Mostra lavoro 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 ElementalAWS . MediaConvert

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

Il seguente esempio di codice mostra come utilizzarecreate-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, consulta Lavorare con i preset di MediaConvert output AWS elementali nella Guida per l'utente di AWS MediaConvert Elemental.

  • Per i dettagli sulle API, consultate Command CreatePresetReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarecreate-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 Working with AWS Elemental MediaConvert Queues nella Guida per l'utente di AWS MediaConvert Elemental.

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

Il seguente esempio di codice mostra come utilizzaredelete-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 Working with AWS Elemental MediaConvert Job Templates nella Guida per l' MediaConvert utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzaredelete-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, consulta Lavorare con i preset di MediaConvert output AWS elementali nella Guida per l'utente di AWS MediaConvert Elemental.

  • Per i dettagli sulle API, consultate Command DeletePresetReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredelete-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 Working with AWS Elemental MediaConvert Queues nella Guida per l'utente di AWS MediaConvert Elemental.

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

Il seguente esempio di codice mostra come utilizzaredescribe-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 nell'AWS Elemental MediaConvert API Reference.

Il seguente esempio di codice mostra come utilizzareget-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 Working with AWS Elemental MediaConvert Job Templates nella Guida per l' MediaConvert utente di AWS Elemental.

  • Per i dettagli sulle API, consultate AWS CLI Command GetJobTemplateReference.

Il seguente esempio di codice mostra come utilizzareget-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' MediaConvert utente di AWS Elemental.

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

Il seguente esempio di codice mostra come utilizzareget-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, consulta Lavorare con i preset di MediaConvert output AWS elementali nella Guida per l'utente di AWS MediaConvert Elemental.

  • Per i dettagli sulle API, consultate Command GetPresetReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareget-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 Working with AWS Elemental MediaConvert Queues nella Guida per l'utente di AWS MediaConvert Elemental.

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

Il seguente esempio di codice mostra come utilizzarelist-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 MediaConvert di lavoro del sistema

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 Working with AWS Elemental MediaConvert Job Templates nella Guida per l' MediaConvert utente di AWS Elemental.

  • Per i dettagli sulle API, consultate AWS CLI Command ListJobTemplatesReference.

Il seguente esempio di codice mostra come utilizzarelist-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' MediaConvert utente di AWS Elemental.

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

Il seguente esempio di codice mostra come utilizzarelist-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 le preimpostazioni MediaConvert di sistema disponibili. 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, vedete Lavorare con i preset di MediaConvert output AWS elementali nella Guida per l'utente di AWS MediaConvert Elemental.

  • Per i dettagli sulle API, consultate Command ListPresetsReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarelist-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 Working with AWS Elemental MediaConvert Queues nella Guida per l'utente di AWS MediaConvert Elemental.

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

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Per elencare i tag su una MediaConvert coda, un modello di lavoro o una preimpostazione 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, consulta Tagging AWS Elemental MediaConvert Queues, Job Templates e Output Preset nella Guida utente di Elemental AWS . MediaConvert

Il seguente esempio di codice mostra come utilizzareupdate-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 https://abcd1234.mediaconvert.us-west-2.amazonaws.com --endpoint-url -- file: //~/ .json cli-input-json job-template-update

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 Working with AWS Elemental MediaConvert Job Templates nella Guida per l' MediaConvert utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzareupdate-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, consulta Lavorare con i preset di MediaConvert output AWS elementali nella Guida per l'utente di AWS MediaConvert Elemental.

  • Per i dettagli sulle API, consultate Command UpdatePresetReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareupdate-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 Working with AWS Elemental MediaConvert Queues nella Guida per l'utente di AWS MediaConvert Elemental.

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