AWS::MediaConvert::JobTemplate - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::MediaConvert::JobTemplate

AWS::MediaConvert::JobTemplate 资源是您可用于生成转码作业的 AWS Elemental MediaConvert 资源类型。

在 AWS CloudFormation 模板中声明此实体时,您将以 JSON 或 YAML 格式传入转码作业设置。此设置规范必须以符合 AWS Elemental MediaConvert 作业验证的特定方式构成。有关为 SettingsJson 属性创建作业模板模型的更多信息,请参阅本主题后面的“备注”部分。

有关作业模板的信息,请参阅 AWS Elemental MediaConvert 用户指南 中的使用 AWS Elemental MediaConvert 作业模板

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::MediaConvert::JobTemplate", "Properties" : { "AccelerationSettings" : AccelerationSettings, "Category" : String, "Description" : String, "HopDestinations" : [ HopDestination, ... ], "Name" : String, "Priority" : Integer, "Queue" : String, "SettingsJson" : Json, "StatusUpdateInterval" : String, "Tags" : Json } }

YAML

Type: AWS::MediaConvert::JobTemplate Properties: AccelerationSettings: AccelerationSettings Category: String Description: String HopDestinations: - HopDestination Name: String Priority: Integer Queue: String SettingsJson: Json StatusUpdateInterval: String Tags: Json

属性

AccelerationSettings

加速转码可以大大加快包含较长视觉复杂内容的作业速度。使用该功能的输出按专业套餐定价付费。对于功能限制的信息,有关更多信息,请参阅 AWS Elemental MediaConvert 用户指南 中的 AWS Elemental MediaConvert 中加速转码的作业限制

必需:否

类型AccelerationSettings

Update requires: No interruption

Category

可选。您正在创建的作业模板的类别

必需:否

类型:字符串

Update requires: No interruption

Description

可选。您正在创建的作业模板的描述。

必需:否

类型:字符串

Update requires: No interruption

HopDestinations

可选。针对一个目标队列的配置,在客户定义的最小等待时间过后,作业可以跳到该队列。有关更多信息,请参阅 AWS Elemental MediaConvert 用户指南 中的设置队列跳跃以避免长等待时间

必需:否

类型HopDestination 的列表

Update requires: No interruption

Name

您正在创建的作业模板的名称。

必需:否

类型:字符串

Update requires: Replacement

Priority

指定此作业的相对优先级。在任何给定队列中,服务首先开始处理具有最高优先级值的作业。当多个作业具有相同的优先级时,服务将开始处理您首先提交的作业。如果未指定优先级,则服务将使用默认值 0。最小值:-50,最大值:50

必需:否

类型:整数

Update requires: No interruption

Queue

可选。从此模板创建的作业分配到的队列。返回队列的 Amazon 资源名称 (ARN)。例如,arn:aws:mediaconvert:us-west-2:505474453218:queues/Default。如果不指定此项,作业将转到默认队列。

必需:否

类型:字符串

Update requires: No interruption

SettingsJson

以 JSON 格式指定此作业模板的转码作业设置。此规范必须符合 AWS Elemental MediaConvert 作业验证。有关构成此规范的信息,请参阅本主题后面的“备注”部分。

有关 MediaConvert 作业模板的更多信息,请参阅 AWS Elemental MediaConvert 用户指南 中的使用 AWS Elemental MediaConvert 作业模板

必需:是

类型:Json

Update requires: No interruption

StatusUpdateInterval

指定 MediaConvert 将 STATUS_UPDATE 事件发送到 Amazon CloudWatch Events 的频率。设置状态更新之间的间隔,以秒为单位。从 MediaConvert 开始处理您的作业直到完成转码或遇到错误时,服务会按此间隔发送更新。

指定下列枚举之一:

SECONDS_10

SECONDS_12

SECONDS_15

SECONDS_20

SECONDS_30

SECONDS_60

SECONDS_120

SECONDS_180

SECONDS_240

SECONDS_300

SECONDS_360

SECONDS_420

SECONDS_480

SECONDS_540

SECONDS_600

必需:否

类型:字符串

Update requires: No interruption

Tags

要应用于此资源的键值对的数组。

有关更多信息,请参阅标签

必需:否

类型:Json

Update requires: No interruption

返回值

Ref

在将 AWS::MediaConvert::JobTemplate 资源的逻辑 ID 传递给内部 Ref 函数时,该函数将返回作业模板的名称,例如 Streaming stack DASH

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

Arn

作业模板的 Amazon 资源名称 (ARN),例如 arn:aws:mediaconvert:us-west-2:123456789012

Name

作业模板的名称,例如 Streaming stack DASH

备注

为 SettingsJson 属性创建作业模板模型

当您在 AWS CloudFormation 模板中声明 AWS::MediaConvert::JobTemplate 实体时,您传入转码作业设置,作为属性 SettingsJson 的值。此设置规范必须采用 JSON 或 YAML 格式,并且必须符合 AWS Elemental MediaConvert 作业验证。

以下过程用于生成 JSON 格式的规范。如果您需要 YAML 格式,则可以使用 JSON 格式创建,然后使用转换实用程序。

SettingsJson 创建 JSON 作业模板模型

  1. 使用 MediaConvert https://console.amazonaws.cn/mediaconvert/ 创建作业模板。有关更多信息,请参阅使用 AWS Elemental MediaConvert 作业模板

  2. 使用 AWS CLI,通过以下命令仅获取设置结构:

    aws mediaconvert https://abcd1234.mediaconvert.region-name-1.amazonaws.com get-job-template DASH-stack-template --query 'JobTemplate.Settings'

  3. 将设置复制为属性 SettingsJson 的值。

有关 JSON 和 YAML 格式的作业模板模型示例,请参阅本主题的“示例”部分。

示例

针对 SettingsJson 的作业模板模型

有关为 SettingsJson 属性创建 JSON 或 YAML 格式的作业模板模型的更多信息,请参阅本主题后面的“备注”部分。

JSON

{ "AdAvailOffset": 0, "OutputGroups": [ { "Name": "File Group", "OutputGroupSettings": { "FileGroupSettings": {}, "Type": "FILE_GROUP_SETTINGS" }, "Outputs": [ { "Extension": "mp4", "NameModifier": "_Generic_Uhd_Mp4_Hevc_Aac_16x9_3840x2160p_24Hz_8Mbps", "Preset": "System-Generic_Uhd_Mp4_Hevc_Aac_16x9_3840x2160p_24Hz_8Mbps" }, { "Extension": "mp4", "NameModifier": "_Generic_Hd_Mp4_Hevc_Aac_16x9_1920x1080p_24Hz_4.5Mbps", "Preset": "System-Generic_Hd_Mp4_Hevc_Aac_16x9_1920x1080p_24Hz_4.5Mbps" }, { "Extension": "mp4", "NameModifier": "_Generic_Hd_Mp4_Hevc_Aac_16x9_1280x720p_24Hz_3.0Mbps", "Preset": "System-Generic_Hd_Mp4_Hevc_Aac_16x9_1280x720p_24Hz_3.0Mbps" }, { "Extension": "mp4", "NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_1920x1080p_24Hz_6Mbps", "Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_1920x1080p_24Hz_6Mbps" }, { "Extension": "mp4", "NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_1280x720p_24Hz_4.5Mbps", "Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_1280x720p_24Hz_4.5Mbps" }, { "Extension": "mp4", "NameModifier": "_Generic_Sd_Mp4_Avc_Aac_4x3_640x480p_24Hz_1.5Mbps", "Preset": "System-Generic_Sd_Mp4_Avc_Aac_4x3_640x480p_24Hz_1.5Mbps" } ] } ] }

YAML

--- AdAvailOffset: 0 OutputGroups: - Name: File Group OutputGroupSettings: FileGroupSettings: {} Type: FILE_GROUP_SETTINGS Outputs: - Extension: mp4 NameModifier: _Generic_Uhd_Mp4_Hevc_Aac_16x9_3840x2160p_24Hz_8Mbps Preset: System-Generic_Uhd_Mp4_Hevc_Aac_16x9_3840x2160p_24Hz_8Mbps - Extension: mp4 NameModifier: _Generic_Hd_Mp4_Hevc_Aac_16x9_1920x1080p_24Hz_4.5Mbps Preset: System-Generic_Hd_Mp4_Hevc_Aac_16x9_1920x1080p_24Hz_4.5Mbps - Extension: mp4 NameModifier: _Generic_Hd_Mp4_Hevc_Aac_16x9_1280x720p_24Hz_3.0Mbps Preset: System-Generic_Hd_Mp4_Hevc_Aac_16x9_1280x720p_24Hz_3.0Mbps - Extension: mp4 NameModifier: _Generic_Hd_Mp4_Avc_Aac_16x9_1920x1080p_24Hz_6Mbps Preset: System-Generic_Hd_Mp4_Avc_Aac_16x9_1920x1080p_24Hz_6Mbps - Extension: mp4 NameModifier: _Generic_Hd_Mp4_Avc_Aac_16x9_1280x720p_24Hz_4.5Mbps Preset: System-Generic_Hd_Mp4_Avc_Aac_16x9_1280x720p_24Hz_4.5Mbps - Extension: mp4 NameModifier: _Generic_Sd_Mp4_Avc_Aac_4x3_640x480p_24Hz_1.5Mbps Preset: System-Generic_Sd_Mp4_Avc_Aac_4x3_640x480p_24Hz_1.5Mbps