MediaConvert exemples utilisant AWS CLI - AWS Command Line Interface

Cette documentation concerne AWS CLI uniquement la version 1 du. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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

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 façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utilisercancel-job.

AWS CLI

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

L'cancel-jobexemple suivant annule la tâche avec ID. 1234567891234-abc123 Vous ne pouvez pas annuler une tâche que le service a commencé à 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 comptedescribe-endpoints, utilisez ou envoyez la commande sans le point de terminaison. Le service renvoie une erreur et renvoie votre point de terminaison.

Pour plus d'informations, consultez la section Travailler avec des MediaConvert tâches AWS élémentaires dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir CancelJobla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-job-template.

AWS CLI

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

L'create-job-templateexemple 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'JobTemplateobjet, mais conservez l'objet enfant Settings à l'intérieur. Assurez-vous également de supprimer les paires clé-valeur suivantes :LastUpdated, ArnType, 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 comptedescribe-endpoints, utilisez ou envoyez la commande sans le point de terminaison. Le service renvoie une erreur et renvoie 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 dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir CreateJobTemplatela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-job.

AWS CLI

Pour créer un emploi

L'create-jobexemple suivant crée une tâche de transcodage avec les paramètres spécifiés dans un fichier job.json résidant sur le système à partir duquel vous envoyez la commande. Cette spécification de tâche JSON peut spécifier chaque paramètre individuellement, 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 comptedescribe-endpoints, utilisez ou envoyez la commande sans le point de terminaison. Le service renvoie une erreur et renvoie 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 dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir CreateJobla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-preset.

AWS CLI

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

L'create-presetexemple suivant crée un préréglage de sortie personnalisé basé sur les paramètres de sortie spécifiés dans le fichierpreset.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, ArnType, et. CreatedAt

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

Pour plus d'informations, consultez la section Utilisation des préréglages de MediaConvert sortie AWS élémentaires dans le guide de l'utilisateur d'AWS Elemental MediaConvert .

  • Pour plus de détails sur l'API, voir CreatePresetla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-queue.

AWS CLI

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

L'create-queueexemple 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 comptedescribe-endpoints, utilisez ou envoyez la commande sans le point de terminaison. Le service renvoie une erreur et renvoie 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'AWSElemental MediaConvert .

  • Pour plus de détails sur l'API, voir CreateQueuela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-job-template.

AWS CLI

Pour supprimer un modèle de tâche

L'delete-job-templateexemple 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 aucun résultat. 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 dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir DeleteJobTemplatela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-preset.

AWS CLI

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

L'delete-presetexemple 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 aucun résultat. 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 dans le guide de l'utilisateur d'AWS Elemental MediaConvert .

  • Pour plus de détails sur l'API, voir DeletePresetla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-queue.

AWS CLI

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

L'delete-queueexemple 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 aucun résultat. 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'AWSElemental MediaConvert .

  • Pour plus de détails sur l'API, voir DeleteQueuela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-endpoints.

AWS CLI

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

L'describe-endpointsexemple 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, voir Commencer à MediaConvert utiliser l'API dans le manuel AWS Elemental MediaConvert API Reference.

  • Pour plus de détails sur l'API, voir DescribeEndpointsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-job-template.

AWS CLI

Pour obtenir les détails d'un modèle de poste

L'get-job-templateexemple 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 dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir GetJobTemplatela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-job.

AWS CLI

Pour obtenir des informations sur un poste en particulier

L'exemple suivant demande les informations relatives à la tâche avec ID1234567890987-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 comptedescribe-endpoints, utilisez ou envoyez la commande sans le point de terminaison. Le service renvoie une erreur et renvoie 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 dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir GetJobla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-preset.

AWS CLI

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

L'get-presetexemple 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 dans le guide de l'utilisateur d'AWS Elemental MediaConvert .

  • Pour plus de détails sur l'API, voir GetPresetla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-queue.

AWS CLI

Pour obtenir les détails d'une file d'attente

L'get-queueexemple suivant récupère les détails 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'AWSElemental MediaConvert .

  • Pour plus de détails sur l'API, voir GetQueuela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-job-templates.

AWS CLI

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

L'list-job-templatesexemple 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'list-job-templatesexemple 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 dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir ListJobTemplatesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-jobs.

AWS CLI

Pour obtenir des informations sur tous les emplois 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 comptedescribe-endpoints, utilisez ou envoyez la commande sans le point de terminaison. Le service renvoie une erreur et renvoie votre point de terminaison.

Pour plus d'informations, consultez la section Travailler avec des MediaConvert tâches AWS élémentaires dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir ListJobsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-presets.

AWS CLI

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

L'list-presetsexemple 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-presetsexemple 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 dans le guide de l'utilisateur d'AWS Elemental MediaConvert .

  • Pour plus de détails sur l'API, voir ListPresetsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-queues.

AWS CLI

Pour répertorier vos files d'attente

L'list-queuesexemple 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'AWSElemental MediaConvert .

  • Pour plus de détails sur l'API, voir ListQueuesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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'list-tags-for-resourceexemple suivant répertorie les balises du 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 dans le guide de l'AWS utilisateur d'Elemental. MediaConvert

  • Pour plus de détails sur l'API, voir ListTagsForResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-job-template.

AWS CLI

Pour modifier un modèle de tâche

L'update-job-templateexemple 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 : //~/ .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 la charge utile 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.

La charge utile JSON pouvant être longue, vous devrez peut-être faire défiler la page vers le haut pour voir les messages d'erreur éventuels.

Pour plus d'informations, consultez la section Travailler avec des modèles de MediaConvert tâches AWS élémentaires dans le guide de l' MediaConvert utilisateur d'AWS Elemental.

  • Pour plus de détails sur l'API, voir UpdateJobTemplatela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-preset.

AWS CLI

Pour modifier un préréglage

L'update-presetexemple 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 aucun résultat. 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 dans le guide de l'utilisateur d'AWS Elemental MediaConvert .

  • Pour plus de détails sur l'API, voir UpdatePresetla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-queue.

AWS CLI

Pour modifier une file d'attente

L'update-queueexemple suivant met en pause la file d'attente spécifiée en modifiant son statut enPAUSED.

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'AWSElemental MediaConvert .

  • Pour plus de détails sur l'API, voir UpdateQueuela section Référence des AWS CLI commandes.