This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
# AWS::MediaConvert::JobTemplate
The AWS::MediaConvert::JobTemplate resource is an AWS Elemental MediaConvert resource type that you can use to generate transcoding jobs.
When you declare this entity in your CloudFormation template, you pass in your transcoding job settings in JSON or YAML format. This settings specification must be formed in a particular way that conforms to AWS Elemental MediaConvert job validation. For more information about creating a job template model for the `SettingsJson` property, see the Remarks section later in this topic.
For information about job templates, see [Working with AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) in the * AWS Elemental MediaConvert User Guide *.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"Type" : "AWS::MediaConvert::JobTemplate",
"Properties" : {
"[AccelerationSettings](#cfn-mediaconvert-jobtemplate-accelerationsettings)" : AccelerationSettings,
"[Category](#cfn-mediaconvert-jobtemplate-category)" : String,
"[Description](#cfn-mediaconvert-jobtemplate-description)" : String,
"[HopDestinations](#cfn-mediaconvert-jobtemplate-hopdestinations)" : [ HopDestination, ... ],
"[Name](#cfn-mediaconvert-jobtemplate-name)" : String,
"[Priority](#cfn-mediaconvert-jobtemplate-priority)" : Integer,
"[Queue](#cfn-mediaconvert-jobtemplate-queue)" : String,
"[SettingsJson](#cfn-mediaconvert-jobtemplate-settingsjson)" : Json,
"[StatusUpdateInterval](#cfn-mediaconvert-jobtemplate-statusupdateinterval)" : String,
"[Tags](#cfn-mediaconvert-jobtemplate-tags)" : [ [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html), ... ]
}
}
```
### YAML
```
Type: AWS::MediaConvert::JobTemplate
Properties:
[AccelerationSettings](#cfn-mediaconvert-jobtemplate-accelerationsettings):
AccelerationSettings
[Category](#cfn-mediaconvert-jobtemplate-category): String
[Description](#cfn-mediaconvert-jobtemplate-description): String
[HopDestinations](#cfn-mediaconvert-jobtemplate-hopdestinations):
- HopDestination
[Name](#cfn-mediaconvert-jobtemplate-name): String
[Priority](#cfn-mediaconvert-jobtemplate-priority): Integer
[Queue](#cfn-mediaconvert-jobtemplate-queue): String
[SettingsJson](#cfn-mediaconvert-jobtemplate-settingsjson):
Json
[StatusUpdateInterval](#cfn-mediaconvert-jobtemplate-statusupdateinterval): String
[Tags](#cfn-mediaconvert-jobtemplate-tags):
- [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html)
```
## Properties
`AccelerationSettings`
Accelerated transcoding can significantly speed up jobs with long, visually complex content. Outputs that use this feature incur pro-tier pricing. For information about feature limitations, For more information, see [Job Limitations for Accelerated Transcoding in AWS Elemental MediaConvert](https://docs.aws.amazon.com/mediaconvert/latest/ug/job-requirements.html) in the *AWS Elemental MediaConvert User Guide*.
*Required*: No
*Type*: [AccelerationSettings](aws-properties-mediaconvert-jobtemplate-accelerationsettings.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Category`
Optional. A category for the job template you are creating
*Required*: No
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Description`
Optional. A description of the job template you are creating.
*Required*: No
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`HopDestinations`
Optional. Configuration for a destination queue to which the job can hop once a customer-defined minimum wait time has passed. For more information, see [Setting Up Queue Hopping to Avoid Long Waits](https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-queue-hopping-to-avoid-long-waits.html) in the *AWS Elemental MediaConvert User Guide*.
*Required*: No
*Type*: Array of [HopDestination](aws-properties-mediaconvert-jobtemplate-hopdestination.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Name`
Name of the output group
*Required*: No
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Priority`
Specify the relative priority for this job. In any given queue, the service begins processing the job with the highest value first. When more than one job has the same priority, the service begins processing the job that you submitted first. If you don't specify a priority, the service uses the default value 0. Minimum: -50 Maximum: 50
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Queue`
Optional. The queue that jobs created from this template are assigned to. Specify the Amazon Resource Name (ARN) of the queue. For example, arn:aws:mediaconvert:us-west-2:505474453218:queues/Default. If you don't specify this, jobs will go to the default queue.
*Required*: No
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`SettingsJson`
Specify, in JSON format, the transcoding job settings for this job template. This specification must conform to the AWS Elemental MediaConvert job validation. For information about forming this specification, see the Remarks section later in this topic.
For more information about MediaConvert job templates, see [Working with AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) in the * AWS Elemental MediaConvert User Guide *.
*Required*: Yes
*Type*: Json
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`StatusUpdateInterval`
Specify how often MediaConvert sends STATUS\$1UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error.
Specify one of the following enums:
SECONDS\$110
SECONDS\$112
SECONDS\$115
SECONDS\$120
SECONDS\$130
SECONDS\$160
SECONDS\$1120
SECONDS\$1180
SECONDS\$1240
SECONDS\$1300
SECONDS\$1360
SECONDS\$1420
SECONDS\$1480
SECONDS\$1540
SECONDS\$1600
*Required*: No
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Tags`
An array of key-value pairs to apply to this resource.
For more information, see [Tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html).
*Required*: No
*Type*: Array of [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
## Return values
### Ref
When you pass the logical ID of an `AWS::MediaConvert::JobTemplate` resource to the intrinsic `Ref` function, the function returns the name of the job template, such as `Streaming stack DASH`.
For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).
### Fn::GetAtt
The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.
For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).
####
`Arn`
The Amazon Resource Name (ARN) of the job template, such as `arn:aws:mediaconvert:us-west-2:123456789012`.
`Name`
The name of the job template, such as `Streaming stack DASH`.
## Remarks
*Creating a Job Template Model for the SettingsJson Property*
When you declare an AWS::MediaConvert::JobTemplate entity in your CloudFormation template, you pass in your transcoding job settings as the value for the property `SettingsJson`. This settings specification must be in in JSON or YAML format and must conform to AWS Elemental MediaConvert job validation.
The following procedure is for generating the specification in JSON. If you need it in YAML, you can create it in JSON and use a conversion utility.
**To create a JSON job template model for `SettingsJson`**
1. Create a job template using the MediaConvert[https://console.aws.amazon.com/mediaconvert/](https://console.aws.amazon.com/mediaconvert/). For more information, see [Working with AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html).
1. Use the AWS CLI to get just the settings structure using the following command:
`aws mediaconvert https://abcd1234.mediaconvert.region-name-1.amazonaws.com get-job-template DASH-stack-template --query 'JobTemplate.Settings'`
1. Copy the settings as the value for the property `SettingsJson`.
For an example job template model in JSON and YAML, see the Examples section of this topic.
## Examples
### Job Template Model for SettingsJson
For more information about creating a job template model in JSON or YAML for the `SettingsJson` property, see the Remarks section of this topic.
#### 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
```