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-job
exemple 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
\ --regionregion-name-1
\ --id1234567891234-abc123
Pour obtenir un point de terminaison spécifique à votre compte
describe-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 CancelJob
la 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-template
exemple suivant crée un modèle de tâche avec les paramètres de transcodage spécifiés dans le fichierjob-template.json
qui réside sur votre système.aws mediaconvert create-job-template \ --endpoint-url
https://abcd1234.mediaconvert.region-name-1.amazonaws.com
\ --regionregion-name-1
\ --nameJobTemplate1
\ --cli-input-jsonfile://~/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'JobTemplate
objet, 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
describe-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 CreateJobTemplate
la 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-job
exemple suivant crée une tâche de transcodage avec les paramètres spécifiés dans un fichierjob.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
\ --regionregion-name-1
\ --cli-input-jsonfile://~/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
describe-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 CreateJob
la 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-preset
exemple 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
--regionregion-name-1
\ --cli-input-jsonfile://~/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
describe-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 CreatePreset
la 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-queue
exemple 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
\ --regionregion-name-1
\ --nameQueue1
\ --description"Keep this queue empty unless job is urgent."
Pour obtenir un point de terminaison spécifique à votre compte
describe-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 CreateQueue
la 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-template
exemple suivant supprime le modèle de tâche personnalisé spécifié.aws mediaconvert delete-job-template \ --name
"DASH Streaming"
\ --endpoint-urlhttps://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 DeleteJobTemplate
la 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-preset
exemple suivant supprime le préréglage personnalisé spécifié.aws mediaconvert delete-preset \ --name
SimpleMP4
\ --endpoint-urlhttps://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 DeletePreset
la 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-queue
exemple 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-urlhttps://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 DeleteQueue
la 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-endpoints
exemple 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 DescribeEndpoints
la 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-template
exemple suivant affiche la définition JSON du modèle de tâche personnalisé spécifié.aws mediaconvert get-job-template \ --name
"DASH Streaming"
\ --endpoint-urlhttps://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 GetJobTemplate
la 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 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
\ --regionregion-name-1
\ --id1234567890987-1ab2c3
Pour obtenir un point de terminaison spécifique à votre compte
describe-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 GetJob
la 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-preset
exemple suivant demande la définition JSON du préréglage personnalisé spécifié.aws mediaconvert get-preset \ --name
SimpleMP4
\ --endpoint-urlhttps://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 GetPreset
la 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-queue
exemple suivant récupère les détails de la file d'attente personnalisée spécifiée.aws mediaconvert get-queue \ --name
Customer1
\ --endpoint-urlhttps://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 GetQueue
la 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-templates
exemple 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-templates
exemple 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-bySYSTEM
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 ListJobTemplates
la 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
\ --regionregion-name-1
Pour obtenir un point de terminaison spécifique à votre compte
describe-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 ListJobs
la 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-presets
exemple 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-urlhttps://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 ListPresets
la 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-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'AWSElemental MediaConvert .
-
Pour plus de détails sur l'API, voir ListQueues
la 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-resource
exemple 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-urlhttps://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 ListTagsForResource
la 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-template
exemple 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 UpdateJobTemplate
la 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-preset
exemple 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 UpdatePreset
la 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-queue
exemple suivant met en pause la file d'attente spécifiée en modifiant son statut enPAUSED
.aws mediaconvert update-queue \ --name
Customer1
\ --statusPAUSED
--endpoint-urlhttps://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 UpdateQueue
la section Référence des AWS CLI commandes.
-