

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# MediaConvert exemples utilisant AWS CLI
<a name="cli_mediaconvert_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with 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.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `cancel-job`
<a name="mediaconvert_CancelJob_cli_topic"></a>

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

**AWS CLI**  
**Pour annuler une tâche 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 la section [Travailler avec des MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/cancel-job.html)la section *Référence des AWS CLI commandes*. 

### `create-job-template`
<a name="mediaconvert_CreateJobTemplate_cli_topic"></a>

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.  
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.  
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 la section [Travailler avec des modèles de MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [CreateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job-template.html)la section *Référence des AWS CLI commandes*. 

### `create-job`
<a name="mediaconvert_CreateJob_cli_topic"></a>

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 MediaConvert console AWS Elemental pour générer la spécification de tâche JSON en choisissant les paramètres de votre tâche, puis en choisissant **Afficher le JSON de la tâche** en bas de la section **Job**.  
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.  
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 la section [Travailler avec des MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job.html)la section *Référence des AWS CLI commandes*. 

### `create-preset`
<a name="mediaconvert_CreatePreset_cli_topic"></a>

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 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 la section [Utilisation des préréglages de MediaConvert sortie AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) dans le guide de l'utilisateur d'*AWS Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [CreatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-preset.html)la section *Référence des AWS CLI commandes*. 

### `create-queue`
<a name="mediaconvert_CreateQueue_cli_topic"></a>

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."
```
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.  
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 la section [Utilisation des MediaConvert files d'attente AWS élémentaires dans le guide de l'utilisateur d'AWS](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)*Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [CreateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-queue.html)la section *Référence des AWS CLI commandes*. 

### `delete-job-template`
<a name="mediaconvert_DeleteJobTemplate_cli_topic"></a>

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 la section [Travailler avec des modèles de MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [DeleteJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-job-template.html)la section *Référence des AWS CLI commandes*. 

### `delete-preset`
<a name="mediaconvert_DeletePreset_cli_topic"></a>

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 la section [Utilisation des préréglages de MediaConvert sortie AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) dans le guide de l'utilisateur d'*AWS Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [DeletePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-preset.html)la section *Référence des AWS CLI commandes*. 

### `delete-queue`
<a name="mediaconvert_DeleteQueue_cli_topic"></a>

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 la section [Utilisation des MediaConvert files d'attente AWS élémentaires dans le guide de l'utilisateur d'AWS](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)*Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [DeleteQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-queue.html)la section *Référence des AWS CLI commandes*. 

### `describe-endpoints`
<a name="mediaconvert_DescribeEndpoints_cli_topic"></a>

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 extrait 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, voir [Commencer à MediaConvert utiliser l'API dans le](https://docs.aws.amazon.com/mediaconvert/latest/apireference/getting-started.html) manuel *AWS Elemental MediaConvert API Reference*.  
+  Pour plus de détails sur l'API, voir [DescribeEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/describe-endpoints.html)la section *Référence des AWS CLI commandes*. 

### `get-job-template`
<a name="mediaconvert_GetJobTemplate_cli_topic"></a>

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

**AWS CLI**  
**Pour obtenir des 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 la section [Travailler avec des modèles de MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [GetJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job-template.html)la section *Référence des AWS CLI commandes*. 

### `get-job`
<a name="mediaconvert_GetJob_cli_topic"></a>

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

**AWS CLI**  
**Pour obtenir des 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
```
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.  
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 la section [Travailler avec des MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [GetJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job.html)la section *Référence des AWS CLI commandes*. 

### `get-preset`
<a name="mediaconvert_GetPreset_cli_topic"></a>

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 la section [Utilisation des préréglages de MediaConvert sortie AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) dans le guide de l'utilisateur d'*AWS Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [GetPreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-preset.html)la section *Référence des AWS CLI commandes*. 

### `get-queue`
<a name="mediaconvert_GetQueue_cli_topic"></a>

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

**AWS CLI**  
**Pour obtenir des informations sur une file d’attente**  
L’exemple `get-queue` suivant extrait 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 la section [Utilisation des MediaConvert files d'attente AWS élémentaires dans le guide de l'utilisateur d'AWS](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)*Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [GetQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-queue.html)la section *Référence des AWS CLI commandes*. 

### `list-job-templates`
<a name="mediaconvert_ListJobTemplates_cli_topic"></a>

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 MediaConvert du système**  
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 la section [Travailler avec des modèles de MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [ListJobTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-job-templates.html)la section *Référence des AWS CLI commandes*. 

### `list-jobs`
<a name="mediaconvert_ListJobs_cli_topic"></a>

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

**AWS CLI**  
**Pour obtenir des 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 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 la section [Travailler avec des MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-jobs.html)la section *Référence des AWS CLI commandes*. 

### `list-presets`
<a name="mediaconvert_ListPresets_cli_topic"></a>

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'`list-presets`exemple suivant répertorie les préréglages MediaConvert système 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 la section [Utilisation des préréglages de MediaConvert sortie AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) dans le guide de l'utilisateur d'*AWS Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [ListPresets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-presets.html)la section *Référence des AWS CLI commandes*. 

### `list-queues`
<a name="mediaconvert_ListQueues_cli_topic"></a>

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

**AWS CLI**  
**Pour répertorier vos files d’attente**  
L'`list-queues`exemple suivant répertorie toutes vos MediaConvert files d'attente.  

```
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 la section [Utilisation des MediaConvert files d'attente AWS élémentaires dans le guide de l'utilisateur d'AWS](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)*Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [ListQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-queues.html)la section *Référence des AWS CLI commandes*. 

### `list-tags-for-resource`
<a name="mediaconvert_ListTagsForResource_cli_topic"></a>

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

**AWS CLI**  
**Pour répertorier les balises MediaConvert d'une file d'attente, d'un modèle de tâche ou d'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 la section [Marquage des files d' MediaConvert attente AWS élémentaires, des modèles de tâches et des préréglages de sortie](https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-queues-templates-presets.html) dans le guide de l'AWS utilisateur d'Elemental. MediaConvert *  
+  Pour plus de détails sur l'API, voir [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-tags-for-resource.html)la section *Référence des AWS CLI commandes*. 

### `update-job-template`
<a name="mediaconvert_UpdateJobTemplate_cli_topic"></a>

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 https://abcd1234.mediaconvert.us-west-2.amazonaws.com --endpoint-url -- fichier : //\$1/ .json cli-input-json job-template-update  
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 la section [Travailler avec des modèles de MediaConvert tâches AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) dans le guide de l'* MediaConvert utilisateur d'AWS Elemental*.  
+  Pour plus de détails sur l'API, voir [UpdateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-job-template.html)la section *Référence des AWS CLI commandes*. 

### `update-preset`
<a name="mediaconvert_UpdatePreset_cli_topic"></a>

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 la section [Utilisation des préréglages de MediaConvert sortie AWS élémentaires](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) dans le guide de l'utilisateur d'*AWS Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [UpdatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-preset.html)la section *Référence des AWS CLI commandes*. 

### `update-queue`
<a name="mediaconvert_UpdateQueue_cli_topic"></a>

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 la section [Utilisation des MediaConvert files d'attente AWS élémentaires dans le guide de l'utilisateur d'AWS](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)*Elemental MediaConvert *.  
+  Pour plus de détails sur l'API, voir [UpdateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-queue.html)la section *Référence des AWS CLI commandes*. 