Exemples d’utilisation de l’AWS CLI avec MediaConvert

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec MediaConvert.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

Actions

L’exemple de code suivant montre comment utiliser cancel-job.

AWS CLI

Pour annuler une tâche figurant dans une file d’attente

L’exemple cancel-job suivant annule la tâche dotée de l’ID 1234567891234-abc123. Vous ne pouvez pas annuler une tâche une fois que le service a commencé à la traiter.


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

Pour obtenir un point de terminaison spécifique à votre compte, utilisez describe-endpoints ou envoyez la commande sans le point de terminaison. Le service renvoie une erreur ainsi que votre point de terminaison.

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Jobs dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez CancelJob dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-job-template.

AWS CLI

Création d'un modèle de tâche

L’exemple create-job-template suivant crée un modèle de tâche avec les paramètres de transcodage spécifiés dans le fichier job-template.json qui réside sur votre système.


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

Si vous créez le fichier JSON de modèle de tâche en utilisant get-job-template puis en modifiant le fichier, supprimez l’objet JobTemplate, mais conservez l’objet enfant Settings à l’intérieur. Assurez-vous également de supprimer les paires clé-valeur suivantes : LastUpdated, Arn, Type et CreatedAt. Vous pouvez spécifier la catégorie, la description, le nom et la file d’attente dans le fichier JSON ou sur la ligne de commande.

Si votre demande aboutit, le service renvoie la spécification JSON pour le modèle de tâche que vous avez créé.

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Job Templates dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez CreateJobTemplate dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-job.

AWS CLI

Pour créer une tâche

L’exemple create-job suivant crée une tâche de transcodage avec les paramètres spécifiés dans le fichier job.json qui réside sur le système à partir duquel vous envoyez la commande. Cette spécification de tâche JSON peut spécifier chaque paramètre individuellement ou faire référence à un modèle de tâche ou à des préréglages de sortie.


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

Vous pouvez utiliser la console AWS Elemental MediaConvert pour générer les spécifications de tâche JSON en choisissant vos paramètres de tâche, puis en sélectionnant Afficher JSON de tâche dans la section Tâche.

Si votre demande aboutit, le service renvoie la spécification de tâche JSON que vous avez envoyée avec votre demande.

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Jobs dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez CreateJob dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-preset.

AWS CLI

Pour créer un préréglage de sortie personnalisé

L’exemple create-preset suivant crée un préréglage de sortie personnalisé basé sur les paramètres de sortie spécifiés dans le fichier preset.json. Vous pouvez spécifier la catégorie, la description et le nom dans le fichier JSON ou sur la ligne de commande.


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

Si vous créez votre fichier JSON prédéfini en utilisant get-preset, puis en modifiant le fichier de sortie, assurez-vous de supprimer les paires clé-valeur suivantes : LastUpdated, Arn, Type et CreatedAt.

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Output Presets dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez CreatePreset dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-queue.

AWS CLI

Pour créer une file d’attente personnalisée

L’exemple create-queue suivant crée une file d’attente de transcodage personnalisée.


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

Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Queues dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez CreateQueue dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-job-template.

AWS CLI

Pour supprimer un modèle de tâche

L’exemple delete-job-template suivant supprime le modèle de tâche personnalisé spécifié.


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

Cette commande ne produit aucune sortie. Exécutez aws mediaconvert list-job-templates pour confirmer que votre modèle a été supprimé.

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Job Templates dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez DeleteJobTemplate dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-preset.

AWS CLI

Pour supprimer une file d’attente à la demande personnalisée

L’exemple delete-preset suivant supprime le préréglage personnalisé spécifié.


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

Cette commande ne produit aucune sortie. Exécutez aws mediaconvert list-presets pour confirmer que votre préréglage a été supprimé.

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Output Presets dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez DeletePreset dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-queue.

AWS CLI

Pour supprimer une file d’attente à la demande personnalisée

L’exemple delete-queue suivant supprime la file d’attente à la demande personnalisée spécifiée.

Vous ne pouvez pas supprimer votre file d’attente par défaut. Vous ne pouvez pas supprimer une file d'attente réservée qui possède un plan de tarification active ou qui contient des tâches non traitées.


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

Cette commande ne produit aucune sortie. Exécutez aws mediaconvert list-queues pour confirmer que votre file d’attente a été supprimée.

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Queues dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez DeleteQueue dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-endpoints.

AWS CLI

Pour obtenir un point de terminaison spécifique à votre compte

L’exemple describe-endpoints suivant récupère le point de terminaison dont vous avez besoin pour envoyer toute autre demande au service.


aws mediaconvert describe-endpoints

Sortie :


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

Pour plus d’informations, consultez Mise en route avec MediaConvert à l’aide de l’API dans la Référence des API AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez DescribeEndpoints dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-job-template.

AWS CLI

Pour obtenir les informations sur un modèle de tâche

L’exemple get-job-template suivant affiche la définition JSON du modèle de tâche personnalisé spécifié.


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

Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Job Templates dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez GetJobTemplate dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-job.

AWS CLI

Pour obtenir les informations sur une tâche en particulier

L’exemple suivant demande les informations relatives à la tâche ayant l’ID 1234567890987-1ab2c3, ce qui, dans cet exemple, s’est soldé par une erreur.


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

Si votre demande aboutit, le service renvoie un fichier JSON contenant les informations relatives à la tâche, notamment les paramètres de la tâche, les erreurs renvoyées et d’autres données relatives à la tâche, comme suit :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Jobs dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez GetJob dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-preset.

AWS CLI

Pour obtenir les informations sur un préréglage en particulier

L’exemple get-preset suivant demande la définition JSON du préréglage personnalisé spécifié.


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

Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Output Presets dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez GetPreset dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-queue.

AWS CLI

Pour obtenir les informations sur une file d’attente

L’exemple get-queue suivant récupère les informations de la file d’attente personnalisée spécifiée.


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

Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Queues dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez GetQueue dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-job-templates.

AWS CLI

Exemple 1 : pour répertorier vos modèles de tâches personnalisés

L’exemple list-job-templates suivant répertorie tous les modèles de tâches personnalisés de la région actuelle. Pour répertorier les modèles de tâches du système, reportez-vous à l’exemple suivant.


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

Sortie :


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

Exemple 2 : pour répertorier les modèles de tâches du système MediaConvert

L’exemple list-job-templates suivant répertorie tous les modèles de tâches du système.


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

Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Job Templates dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez ListJobTemplates dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-jobs.

AWS CLI

Pour obtenir les informations sur toutes les tâches d’une région

L’exemple suivant demande les informations relatives à toutes vos tâches dans la région spécifiée.


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Jobs dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez ListJobs dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-presets.

AWS CLI

Exemple 1 : pour répertorier vos préréglages de sortie personnalisés

L’exemple list-presets suivant répertorie vos préréglages de sortie personnalisés. Pour répertorier les préréglages du système, reportez-vous à l’exemple suivant.


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

Sortie :


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

Exemple 2 : pour répertorier les préréglages de sortie du système

L’exemple list-presets suivant répertorie les préréglages du système MediaConvert disponibles. Pour répertorier vos préréglages personnalisés, consultez l’exemple précédent.


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

Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Output Presets dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez ListPresets dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-queues.

AWS CLI

Pour répertorier vos files d’attente

L’exemple list-queues suivant répertorie toutes vos files d’attente MediaConvert.


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

Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Queues dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez ListQueues dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-resource.

AWS CLI

Pour répertorier les balises sur une file d’attente MediaConvert, un modèle de tâche ou un préréglage de sortie

L’exemple list-tags-for-resource suivant répertorie les balises sur le préréglage de sortie spécifié.


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

Sortie :


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

Pour plus d’informations, consultez Tagging AWS Elemental MediaConvert Queues, Job Templates, and Output Presets dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-job-template.

AWS CLI

Pour modifier un modèle de tâche

L’exemple update-job-template suivant remplace la définition JSON du modèle de tâche personnalisé spécifié par la définition JSON du fichier fourni.

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

Contenu de job-template-update.json :


{
    "Description": "A simple job template that generates a single file output.",
    "Queue": "arn:aws:mediaconvert:us-east-1:012345678998:queues/Default",
    "Name": "SimpleFile",
    "Settings": {
      "OutputGroups": [
        {
          "Name": "File Group",
          "Outputs": [
            {
              "ContainerSettings": {
                "Container": "MP4",
                "Mp4Settings": {
                  "CslgAtom": "INCLUDE",
                  "FreeSpaceBox": "EXCLUDE",
                  "MoovPlacement": "PROGRESSIVE_DOWNLOAD"
                }
              },
              "VideoDescription": {
                "ScalingBehavior": "DEFAULT",
                "TimecodeInsertion": "DISABLED",
                "AntiAlias": "ENABLED",
                "Sharpness": 50,
                "CodecSettings": {
                  "Codec": "H_264",
                  "H264Settings": {
                    "InterlaceMode": "PROGRESSIVE",
                    "NumberReferenceFrames": 3,
                    "Syntax": "DEFAULT",
                    "Softness": 0,
                    "GopClosedCadence": 1,
                    "GopSize": 90,
                    "Slices": 1,
                    "GopBReference": "DISABLED",
                    "SlowPal": "DISABLED",
                    "SpatialAdaptiveQuantization": "ENABLED",
                    "TemporalAdaptiveQuantization": "ENABLED",
                    "FlickerAdaptiveQuantization": "DISABLED",
                    "EntropyEncoding": "CABAC",
                    "Bitrate": 400000,
                    "FramerateControl": "INITIALIZE_FROM_SOURCE",
                    "RateControlMode": "CBR",
                    "CodecProfile": "MAIN",
                    "Telecine": "NONE",
                    "MinIInterval": 0,
                    "AdaptiveQuantization": "HIGH",
                    "CodecLevel": "AUTO",
                    "FieldEncoding": "PAFF",
                    "SceneChangeDetect": "ENABLED",
                    "QualityTuningLevel": "SINGLE_PASS",
                    "FramerateConversionAlgorithm": "DUPLICATE_DROP",
                    "UnregisteredSeiTimecode": "DISABLED",
                    "GopSizeUnits": "FRAMES",
                    "ParControl": "INITIALIZE_FROM_SOURCE",
                    "NumberBFramesBetweenReferenceFrames": 2,
                    "RepeatPps": "DISABLED",
                    "DynamicSubGop": "STATIC"
                  }
                },
                "AfdSignaling": "NONE",
                "DropFrameTimecode": "ENABLED",
                "RespondToAfd": "NONE",
                "ColorMetadata": "INSERT"
              },
              "AudioDescriptions": [
                {
                  "AudioTypeControl": "FOLLOW_INPUT",
                  "CodecSettings": {
                    "Codec": "AAC",
                    "AacSettings": {
                      "AudioDescriptionBroadcasterMix": "NORMAL",
                      "Bitrate": 96000,
                      "RateControlMode": "CBR",
                      "CodecProfile": "LC",
                      "CodingMode": "CODING_MODE_2_0",
                      "RawFormat": "NONE",
                      "SampleRate": 48000,
                      "Specification": "MPEG4"
                    }
                  },
                  "LanguageCodeControl": "FOLLOW_INPUT"
                }
              ]
            }
          ],
          "OutputGroupSettings": {
            "Type": "FILE_GROUP_SETTINGS",
            "FileGroupSettings": {}
          }
        }
      ],
      "AdAvailOffset": 0
    },
    "StatusUpdateInterval": "SECONDS_60",
    "Priority": 0
}

Le système renvoie les données utiles JSON que vous envoyez avec votre demande, même si celle-ci entraîne une erreur. Par conséquent, le JSON renvoyé n’est pas nécessairement la nouvelle définition du modèle de tâche.

Les données utiles JSON pouvant être longues, vous devrez peut-être faire défiler la page vers le haut pour voir les éventuels messages d’erreur.

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Job Templates dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez UpdateJobTemplate dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-preset.

AWS CLI

Pour modifier un préréglage

L’exemple update-preset suivant remplace la description du préréglage spécifié.


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

Cette commande ne produit aucune sortie. Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Output Presets dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez UpdatePreset dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-queue.

AWS CLI

Pour modifier une file d’attente

L’exemple update-queue suivant met en pause la file d’attente spécifiée, en modifiant son statut sur PAUSED.


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

Sortie :


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

Pour plus d’informations, consultez Working with AWS Elemental MediaConvert Queues dans le Guide de l’utilisateur AWS Elemental MediaConvert.

Pour plus de détails sur l’API, consultez UpdateQueue dans la Référence des commandes de l’AWS CLI.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

MediaConnect

MediaLive