以下代码示例演示了如何通过将 AWS Command Line Interface与 MediaConvert 结合使用，来执行操作和实现常见场景。
操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
主题
操作
以下代码示例演示如何使用 cancel-job。
- AWS CLI
-
取消队列中的一个作业
以下
cancel-job示例取消 ID 为1234567891234-abc123的作业。如果服务已经开始处理该作业，则无法取消它。aws mediaconvert cancel-job \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --id1234567891234-abc123要获取账户特定的端点，请使用
describe-endpoints，或发送不带端点的命令。该服务会返回错误和您的端点。有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 CancelJob
。
-
以下代码示例演示如何使用 create-job-template。
- AWS CLI
-
创建作业模板
以下
create-job-template示例使用您的系统上的文件job-template.json中指定的转码设置创建一个作业模板。aws mediaconvert create-job-template \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --nameJobTemplate1\ --cli-input-jsonfile://~/job-template.json如果您通过使用
get-job-template然后修改文件的方法来创建作业模板 JSON 文件，则移除JobTemplate对象，但保留其中的 Settings 子对象。另外，请务必移除以下键-值对：LastUpdated、Arn、Type和CreatedAt。您可以在 JSON 文件或命令行中指定类别、描述、名称和队列。要获取账户特定的端点，请使用
describe-endpoints，或发送不带端点的命令。该服务会返回错误和您的端点。如果您的请求成功，则服务会为您创建的作业模板返回 JSON 规范。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业模板。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 CreateJobTemplate
。
-
以下代码示例演示如何使用 create-job。
- AWS CLI
-
创建作业
以下
create-job示例使用在位于您发送命令的系统上的文件job.json中指定的设置创建转码作业。此 JSON 作业规范可以单独指定每个设置，引用作业模板或引用输出预设。aws mediaconvert create-job \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --cli-input-jsonfile://~/job.json您可以使用 AWS Elemental MediaConvert 控制台生成 JSON 作业规范，方法是：选择您的作业设置，然后选择作业 部分底部的显示作业 JSON。
要获取账户特定的端点，请使用
describe-endpoints，或发送不带端点的命令。该服务会返回错误和您的端点。如果您的请求成功，则该服务将返回您在请求中发送的 JSON 作业规范。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 CreateJob
。
-
以下代码示例演示如何使用 create-preset。
- AWS CLI
-
创建自定义输出预设
以下
create-preset示例根据文件preset.json中指定的输出设置创建自定义输出预设。您可以在 JSON 文件或命令行中指定类别、描述和名称。aws mediaconvert create-preset \ --endpoint-urlhttps://abcd1234---mediaconvert---region-name-1.amazonaws.com.rproxy.goskope.com--regionregion-name-1\ --cli-input-jsonfile://~/preset.json如果您通过使用
get-preset然后修改输出文件的方法来创建预设 JSON 文件，请务必删除以下键-值对：LastUpdated、Arn、Type和CreatedAt。要获取账户特定的端点，请使用
describe-endpoints，或发送不带端点的命令。该服务会返回错误和您的端点。有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 输出预设。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 CreatePreset
。
-
以下代码示例演示如何使用 create-queue。
- AWS CLI
-
创建自定义队列
以下
create-queue示例创建一个自定义转码队列。aws mediaconvert create-queue \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --nameQueue1\ --description"Keep this queue empty unless job is urgent."要获取账户特定的端点，请使用
describe-endpoints，或发送不带端点的命令。该服务会返回错误和您的端点。输出：
{ "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." } }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 队列。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 CreateQueue
。
-
以下代码示例演示如何使用 delete-job-template。
- AWS CLI
-
删除作业模板
以下
delete-job-template示例删除指定的自定义作业模板。aws mediaconvert delete-job-template \ --name"DASH Streaming"\ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com此命令不生成任何输出。运行
aws mediaconvert list-job-templates来确认您的模板是否被删除。有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业模板。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 DeleteJobTemplate
。
-
以下代码示例演示如何使用 delete-preset。
- AWS CLI
-
删除自定义按需队列
以下
delete-preset示例删除指定自定义预设。aws mediaconvert delete-preset \ --nameSimpleMP4\ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com此命令不生成任何输出。运行
aws mediaconvert list-presets来确认您的预设是否被删除。有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 输出预设。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 DeletePreset
。
-
以下代码示例演示如何使用 delete-queue。
- AWS CLI
-
删除自定义按需队列
以下
delete-queue示例删除指定的自定义按需队列。您无法删除您的默认队列。您无法删除具有活动定价计划或包含未处理作业的预留队列。
aws mediaconvert delete-queue \ --nameCustomer1\ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com此命令不生成任何输出。运行
aws mediaconvert list-queues来确认您的队列是否被删除。有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 队列。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 DeleteQueue
。
-
以下代码示例演示如何使用 describe-endpoints。
- AWS CLI
-
获取特定账户端点
以下
describe-endpoints示例检索向服务发送任何其他请求所需的端点。aws mediaconvert describe-endpoints输出：
{ "Endpoints": [ { "Url": "https://abcd1234.mediaconvert.region-name-1.amazonaws.com" } ] }有关更多信息，请参阅《AWS Elemental MediaConvert API 参考》中的使用 API 的 MediaConvert 入门。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 DescribeEndpoints
。
-
以下代码示例演示如何使用 get-job-template。
- AWS CLI
-
获取作业模板的详细信息
以下
get-job-template示例显示指定的自定义作业模板的 JSON 定义。aws mediaconvert get-job-template \ --name"DASH Streaming"\ --endpoint-urlhttps://abcd1234.mediaconvert.us-east-1.amazonaws.com输出：
{ "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" } }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业模板。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 GetJobTemplate
。
-
以下代码示例演示如何使用 get-job。
- AWS CLI
-
获取特定作业的详细信息
以下示例请求 ID 为
1234567890987-1ab2c3的作业的信息，在本示例中，该作业以错误结尾。aws mediaconvert get-job \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1\ --id1234567890987-1ab2c3要获取账户特定的端点，请使用
describe-endpoints，或发送不带端点的命令。该服务会返回错误和您的端点。如果您的请求成功，该服务将返回一个含作业信息的 JSON 文件，包括作业设置、任何返回的错误以及其他作业数据，如下所示：
{ "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 } }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 GetJob
。
-
以下代码示例演示如何使用 get-preset。
- AWS CLI
-
获取特定预设的详细信息
以下
get-preset示例请求指定的自定义预设的 JSON 定义。aws mediaconvert get-preset \ --nameSimpleMP4\ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com输出：
{ "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 } }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 输出预设。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 GetPreset
。
-
以下代码示例演示如何使用 get-queue。
- AWS CLI
-
获取队列的详细信息
以下
get-queue示例检索指定自定义队列的详细信息。aws mediaconvert get-queue \ --nameCustomer1\ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com输出：
{ "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" } }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 队列。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 GetQueue
。
-
以下代码示例演示如何使用 list-job-templates。
- AWS CLI
-
示例 1：列出您的自定义作业模板
以下
list-job-templates示例列出当前区域中的所有自定义作业模板。要列出系统作业模板，请参阅下一个示例。aws mediaconvert list-job-templates \ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com输出：
{ "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 } ] }示例 2：列出 MediaConvert 系统作业模板
以下
list-job-templates示例列出所有系统作业模板。aws mediaconvert list-job-templates \ --endpoint-urlhttps://abcd1234.mediaconvert.us-east-1.amazonaws.com\ --list-bySYSTEM输出：
{ "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>... ] }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业模板。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 ListJobTemplates
。
-
以下代码示例演示如何使用 list-jobs。
- AWS CLI
-
获取某个区域中所有作业的详细信息
以下示例请求您在指定区域所有作业的信息。
aws mediaconvert list-jobs \ --endpoint-urlhttps://abcd1234.mediaconvert.region-name-1.amazonaws.com\ --regionregion-name-1要获取账户特定的端点，请使用
describe-endpoints，或发送不带端点的命令。该服务会返回错误和您的端点。有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 ListJobs
。
-
以下代码示例演示如何使用 list-presets。
- AWS CLI
-
示例 1：列出您的自定义输出预设
以下
list-presets示例列出您的自定义输出预设。要列出系统预设，请参阅下一个示例。aws mediaconvert list-presets \ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com输出：
{ "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." } ] }示例 2：列出系统输出预设
以下
list-presets示例列出可用的 MediaConvert 系统预设。要列出您的自定义预设，请参阅前面的示例。aws mediaconvert list-presets \ --list-bySYSTEM\ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com输出：
{ "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>... } } ] }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 输出预设。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 ListPresets
。
-
以下代码示例演示如何使用 list-queues。
- AWS CLI
-
列出队列
以下
list-queues示例列出您的所有 MediaConvert 队列。aws mediaconvert list-queues \ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com输出：
{ "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 } ] }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 队列。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 ListQueues
。
-
以下代码示例演示如何使用 list-tags-for-resource。
- AWS CLI
-
列出 MediaConvert 队列、作业模板或输出预设上的标签
以下
list-tags-for-resource示例列出指定输出预设上的标签。aws mediaconvert list-tags-for-resource \ --arnarn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4\ --endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com输出：
{ "ResourceTags": { "Tags": { "customer": "zippyVideo" }, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4" } }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的标记 AWS Elemental MediaConvert 队列、作业模板和输出预设。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 ListTagsForResource
。
-
以下代码示例演示如何使用 update-job-template。
- AWS CLI
-
更改作业模板
以下
update-job-template示例将指定自定义作业模板的 JSON 定义替换为提供的文件中的 JSON 定义。aws mediaconvert update-job-template --name File1 --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com --cli-input-json file://~/job-template-update.json
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 }即使请求导致错误，系统也会返回随您的请求发送的 JSON 有效载荷。因此，返回的 JSON 不一定是作业模板的新定义。
因为 JSON 有效载荷较长，所以您可能需要向上滚动才能看到错误消息。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 作业模板。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 UpdateJobTemplate
。
-
以下代码示例演示如何使用 update-preset。
- AWS CLI
-
更改预设
以下
update-preset示例替换了指定预设的描述。aws mediaconvert update-preset \ --name Customer1 \ --description "New description text." --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com此命令不生成任何输出。输出：
{ "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 } }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 输出预设。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 UpdatePreset
。
-
以下代码示例演示如何使用 update-queue。
- AWS CLI
-
更改队列
以下
update-queue示例通过将指定队列的状态改为PAUSED来暂停它。aws mediaconvert update-queue \ --nameCustomer1\ --statusPAUSED--endpoint-urlhttps://abcd1234.mediaconvert.us-west-2.amazonaws.com输出：
{ "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" } }有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》中的使用 AWS Elemental MediaConvert 队列。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 UpdateQueue
。
-
