Esempi di MediaConvert che utilizzano la AWS CLI - AWS Command Line Interface
Operazioni

Esempi di MediaConvert che utilizzano la AWS CLI

Negli esempi di codice seguenti viene mostrato come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con MediaConvert.

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

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

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 Working with AWS Elemental MediaConvert Jobs in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta CancelJob in AWS CLI Command Reference.

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

AWS CLI

Per 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 in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta CreateJobTemplate in AWS CLI Command Reference.

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 set di configurazione dell’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 console AWS Elemental MediaConvert per generare la specifica del processo JSON selezionando le impostazioni del processo e quindi scegliendo Mostra processo JSON nella parte inferiore della sezione Processo.

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 Working with AWS Elemental MediaConvert Jobs in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sulle API, consulta CreateJob nel Riferimento ai comandi AWS CLI.

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

AWS CLI

Come creare un set di configurazione dell’output personalizzato

L’esempio create-preset seguente crea un set di configurazione dell’output personalizzato basato 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 un set di configurazione utilizzando get-preset e quindi modificando 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 Working with AWS Elemental MediaConvert Output Presets in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta CreatePreset in AWS CLI Command Reference.

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 Working with AWS Elemental MediaConvert Queues in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta CreateQueue in AWS CLI Command Reference.

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 Working with AWS Elemental MediaConvert Job Templates in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta DeleteJobTemplate in AWS CLI Command Reference.

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

AWS CLI

Come eliminare una coda on demand

L’esempio delete-preset seguente elimina il set di configurazione personalizzato specificato.

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 il set di configurazione sia stato eliminato.

Per ulteriori informazioni, consulta Working with AWS Elemental MediaConvert Output Presets in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta DeletePreset in AWS CLI Command Reference.

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 Working with AWS Elemental MediaConvert Queues in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta DeleteQueue in AWS CLI Command Reference.

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 Getting Started with MediaConvert Using the API in AWS Elemental MediaConvert API Reference.

  • Per informazioni dettagliate sull’API, consulta DescribeEndpoints in AWS CLI Command Reference.

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 Working with AWS Elemental MediaConvert Job Templates in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta GetJobTemplate in AWS CLI Command 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 Working with AWS Elemental MediaConvert Jobs in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sulle API, consulta GetJob nel Riferimento ai comandi AWS CLI.

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

AWS CLI

Come ottenere dettagli su un particolare set di configurazione

L’esempio get-preset seguente richiede la definizione JSON del set di configurazione personalizzato specificato.

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 Working with AWS Elemental MediaConvert Output Presets in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta GetPreset in AWS CLI Command Reference.

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 Working with AWS Elemental MediaConvert Queues in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta GetQueue in AWS CLI Command Reference.

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, vedi 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: come elencare i modelli di processo del 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 Working with AWS Elemental MediaConvert Job Templates in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta ListJobTemplates in AWS CLI Command Reference.

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

AWS CLI

Come ottenere dettagli su tutti i processi in una Regione

Nell’esempio seguente vengono richieste 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 Working with AWS Elemental MediaConvert Jobs in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta ListJobs in AWS CLI Command Reference.

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

AWS CLI

Esempio 1: come elencare i set di configurazione dell’output personalizzati

L’esempio list-presets seguente elenca i set di configurazione dell’output personalizzati. Per elencare i set di configurazione del sistema, vedi 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 i set di configurazione dell’output del sistema

L’esempio list-presets seguente elenca i set di configurazione del sistema MediaConvert disponibili. Per elencare i set di configurazione personalizzati, vedi 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, consulta Working with AWS Elemental MediaConvert Output Presets in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta ListPresets in AWS CLI Command Reference.

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

AWS CLI

Come elencare le code

L’esempio list-queues seguente elenca tutte le code MediaConvert.

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 in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta ListQueues in AWS CLI Command Reference.

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

AWS CLI

Come elencare i tag per una coda, un modello di processo o il set di configurazione dell’output per MediaConvert

L’esempio list-tags-for-resource seguente elenca i tag per il set di configurazione specificato.

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, and Output Presets in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta ListTagsForResource in Riferimento ai comandi AWS CLI.

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

AWS CLI

Come creare un modello di modifica

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 https://abcd1234.mediaconvert.us-west-2.amazonaws.com --cli-input-json file: //~/job-template-update.json

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 in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta UpdateJobTemplate in AWS CLI Command Reference.

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

AWS CLI

Come modificare un set di configurazione

L’esempio update-preset seguente sostituisce la descrizione per il set di configurazione specificato.

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 Working with AWS Elemental MediaConvert Output Presets in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta UpdatePreset in AWS CLI Command Reference.

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 Working with AWS Elemental MediaConvert Queues in AWS Elemental MediaConvert User Guide.

  • Per informazioni dettagliate sull’API, consulta UpdateQueue in AWS CLI Command Reference.