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 Elemental MediaConvert
<a name="AWS_MediaConvert"></a>

**Resource types**
+ [AWS::MediaConvert::JobTemplate](aws-resource-mediaconvert-jobtemplate.md)
+ [AWS::MediaConvert::Preset](aws-resource-mediaconvert-preset.md)
+ [AWS::MediaConvert::Queue](aws-resource-mediaconvert-queue.md)

# AWS::MediaConvert::JobTemplate
<a name="aws-resource-mediaconvert-jobtemplate"></a>

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
<a name="aws-resource-mediaconvert-jobtemplate-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-mediaconvert-jobtemplate-syntax.json"></a>

```
{
  "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
<a name="aws-resource-mediaconvert-jobtemplate-syntax.yaml"></a>

```
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
<a name="aws-resource-mediaconvert-jobtemplate-properties"></a>

`AccelerationSettings`  <a name="cfn-mediaconvert-jobtemplate-accelerationsettings"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-category"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-description"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-hopdestinations"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-name"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-priority"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-queue"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-settingsjson"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-statusupdateinterval"></a>
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`  <a name="cfn-mediaconvert-jobtemplate-tags"></a>
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
<a name="aws-resource-mediaconvert-jobtemplate-return-values"></a>

### Ref
<a name="aws-resource-mediaconvert-jobtemplate-return-values-ref"></a>

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
<a name="aws-resource-mediaconvert-jobtemplate-return-values-fn--getatt"></a>

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).

#### 
<a name="aws-resource-mediaconvert-jobtemplate-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
The Amazon Resource Name (ARN) of the job template, such as `arn:aws:mediaconvert:us-west-2:123456789012`.

`Name`  <a name="Name-fn::getatt"></a>
The name of the job template, such as `Streaming stack DASH`.

## Remarks
<a name="aws-resource-mediaconvert-jobtemplate--remarks"></a>

 *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
<a name="aws-resource-mediaconvert-jobtemplate--examples"></a>



### Job Template Model for SettingsJson
<a name="aws-resource-mediaconvert-jobtemplate--examples--Job_Template_Model_for_SettingsJson"></a>

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
<a name="aws-resource-mediaconvert-jobtemplate--examples--Job_Template_Model_for_SettingsJson--json"></a>

```
{
    "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
<a name="aws-resource-mediaconvert-jobtemplate--examples--Job_Template_Model_for_SettingsJson--yaml"></a>

```
---
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
```

# AWS::MediaConvert::JobTemplate AccelerationSettings
<a name="aws-properties-mediaconvert-jobtemplate-accelerationsettings"></a>

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*.

## Syntax
<a name="aws-properties-mediaconvert-jobtemplate-accelerationsettings-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-mediaconvert-jobtemplate-accelerationsettings-syntax.json"></a>

```
{
  "[Mode](#cfn-mediaconvert-jobtemplate-accelerationsettings-mode)" : String
}
```

### YAML
<a name="aws-properties-mediaconvert-jobtemplate-accelerationsettings-syntax.yaml"></a>

```
  [Mode](#cfn-mediaconvert-jobtemplate-accelerationsettings-mode): String
```

## Properties
<a name="aws-properties-mediaconvert-jobtemplate-accelerationsettings-properties"></a>

`Mode`  <a name="cfn-mediaconvert-jobtemplate-accelerationsettings-mode"></a>
Specify the conditions when the service will run your job with accelerated transcoding.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::MediaConvert::JobTemplate HopDestination
<a name="aws-properties-mediaconvert-jobtemplate-hopdestination"></a>

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*.

## Syntax
<a name="aws-properties-mediaconvert-jobtemplate-hopdestination-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-mediaconvert-jobtemplate-hopdestination-syntax.json"></a>

```
{
  "[Priority](#cfn-mediaconvert-jobtemplate-hopdestination-priority)" : Integer,
  "[Queue](#cfn-mediaconvert-jobtemplate-hopdestination-queue)" : String,
  "[WaitMinutes](#cfn-mediaconvert-jobtemplate-hopdestination-waitminutes)" : Integer
}
```

### YAML
<a name="aws-properties-mediaconvert-jobtemplate-hopdestination-syntax.yaml"></a>

```
  [Priority](#cfn-mediaconvert-jobtemplate-hopdestination-priority): Integer
  [Queue](#cfn-mediaconvert-jobtemplate-hopdestination-queue): String
  [WaitMinutes](#cfn-mediaconvert-jobtemplate-hopdestination-waitminutes): Integer
```

## Properties
<a name="aws-properties-mediaconvert-jobtemplate-hopdestination-properties"></a>

`Priority`  <a name="cfn-mediaconvert-jobtemplate-hopdestination-priority"></a>
Optional. When you set up a job to use queue hopping, you can specify a different relative priority for the job in the destination queue. If you don't specify, the relative priority will remain the same as in the previous queue.  
*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`  <a name="cfn-mediaconvert-jobtemplate-hopdestination-queue"></a>
Optional unless the job is submitted on the default queue. When you set up a job to use queue hopping, you can specify a destination queue. This queue cannot be the original queue to which the job is submitted. If the original queue isn't the default queue and you don't specify the destination queue, the job will move 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)

`WaitMinutes`  <a name="cfn-mediaconvert-jobtemplate-hopdestination-waitminutes"></a>
Required for setting up a job to use queue hopping. Minimum wait time in minutes until the job can hop to the destination queue. Valid range is 1 to 4320 minutes, inclusive.  
*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)

# AWS::MediaConvert::Preset
<a name="aws-resource-mediaconvert-preset"></a>

The AWS::MediaConvert::Preset resource is an AWS Elemental MediaConvert resource type that you can use to specify encoding settings for a single output in a transcoding job.

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 an output preset model for the `SettingsJson` property, see the Remarks section later in this topic.

For more information about output MediaConvert presets, see [Working with AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) in the * AWS Elemental MediaConvert User Guide *.

## Syntax
<a name="aws-resource-mediaconvert-preset-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-mediaconvert-preset-syntax.json"></a>

```
{
  "Type" : "AWS::MediaConvert::Preset",
  "Properties" : {
      "[Category](#cfn-mediaconvert-preset-category)" : String,
      "[Description](#cfn-mediaconvert-preset-description)" : String,
      "[Name](#cfn-mediaconvert-preset-name)" : String,
      "[SettingsJson](#cfn-mediaconvert-preset-settingsjson)" : Json,
      "[Tags](#cfn-mediaconvert-preset-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
<a name="aws-resource-mediaconvert-preset-syntax.yaml"></a>

```
Type: AWS::MediaConvert::Preset
Properties:
  [Category](#cfn-mediaconvert-preset-category): String
  [Description](#cfn-mediaconvert-preset-description): String
  [Name](#cfn-mediaconvert-preset-name): String
  [SettingsJson](#cfn-mediaconvert-preset-settingsjson): 
    Json
  [Tags](#cfn-mediaconvert-preset-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
<a name="aws-resource-mediaconvert-preset-properties"></a>

`Category`  <a name="cfn-mediaconvert-preset-category"></a>
The new category for the preset, if you are changing it.  
*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`  <a name="cfn-mediaconvert-preset-description"></a>
The new description for the preset, if you are changing it.  
*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)

`Name`  <a name="cfn-mediaconvert-preset-name"></a>
The name of the preset that you are modifying.  
*Required*: No  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`SettingsJson`  <a name="cfn-mediaconvert-preset-settingsjson"></a>
Specify, in JSON format, the transcoding job settings for this output preset. 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 output presets, see [Working with AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.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)

`Tags`  <a name="cfn-mediaconvert-preset-tags"></a>
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
<a name="aws-resource-mediaconvert-preset-return-values"></a>

### Ref
<a name="aws-resource-mediaconvert-preset-return-values-ref"></a>

When you pass the logical ID of an `AWS::MediaConvert::Preset` resource to the intrinsic `Ref` function, the function returns the name of the output preset, such as `HEVC high res`.

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
<a name="aws-resource-mediaconvert-preset-return-values-fn--getatt"></a>

#### 
<a name="aws-resource-mediaconvert-preset-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
 The Amazon Resource Name (ARN) of the output preset, such as `arn:aws:mediaconvert:us-west-2:123456789012`. 

`Name`  <a name="Name-fn::getatt"></a>
 The name of the output preset, such as `HEVC high res`. 

## Remarks
<a name="aws-resource-mediaconvert-preset--remarks"></a>

 *Creating an Ouput Preset Model for the SettingsJson Property* 

When you declare an AWS::MediaConvert::Preset 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 an output preset using the MediaConvert[https://console.aws.amazon.com/mediaconvert/](https://console.aws.amazon.com/mediaconvert/). For more information, see [Working with AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.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-preset --name HEVC-high-res --query 'Preset.Settings'` 

1. Copy the settings as the value for the property `SettingsJson`.

For an example output preset model in JSON and YAML, see the Examples section of this topic.

## Examples
<a name="aws-resource-mediaconvert-preset--examples"></a>



### Output Preset Model for SettingsJson
<a name="aws-resource-mediaconvert-preset--examples--Output_Preset_Model_for_SettingsJson"></a>

For more information about creating an output preset model in JSON or YAML for the `SettingsJson` property, see the Remarks section of this topic.

#### JSON
<a name="aws-resource-mediaconvert-preset--examples--Output_Preset_Model_for_SettingsJson--json"></a>

```
{
    "AudioDescriptions": [
        {
            "AudioType": 0,
            "AudioTypeControl": "FOLLOW_INPUT",
            "CodecSettings": {
                "AacSettings": {
                    "AudioDescriptionBroadcasterMix": "NORMAL",
                    "Bitrate": 160000,
                    "CodecProfile": "LC",
                    "CodingMode": "CODING_MODE_2_0",
                    "RateControlMode": "CBR",
                    "RawFormat": "NONE",
                    "SampleRate": 48000,
                    "Specification": "MPEG4"
                },
                "Codec": "AAC"
            },
            "LanguageCodeControl": "FOLLOW_INPUT"
        }
    ],
    "ContainerSettings": {
        "Container": "MP4",
        "Mp4Settings": {
            "CslgAtom": "EXCLUDE",
            "FreeSpaceBox": "EXCLUDE",
            "MoovPlacement": "NORMAL"
        }
    },
    "VideoDescription": {
        "AfdSignaling": "NONE",
        "AntiAlias": "ENABLED",
        "CodecSettings": {
            "Codec": "H_265",
            "H265Settings": {
                "AdaptiveQuantization": "HIGH",
                "AlternateTransferFunctionSei": "DISABLED",
                "Bitrate": 10000000,
                "CodecLevel": "LEVEL_5",
                "CodecProfile": "MAIN_MAIN",
                "FlickerAdaptiveQuantization": "DISABLED",
                "FramerateControl": "SPECIFIED",
                "FramerateConversionAlgorithm": "DUPLICATE_DROP",
                "FramerateDenominator": 1001,
                "FramerateNumerator": 24000,
                "GopBReference": "ENABLED",
                "GopClosedCadence": 1,
                "GopSize": 48.0,
                "GopSizeUnits": "FRAMES",
                "HrdBufferInitialFillPercentage": 90,
                "HrdBufferSize": 20000000,
                "InterlaceMode": "PROGRESSIVE",
                "MinIInterval": 0,
                "NumberBFramesBetweenReferenceFrames": 3,
                "NumberReferenceFrames": 3,
                "ParControl": "SPECIFIED",
                "ParDenominator": 1,
                "ParNumerator": 1,
                "QualityTuningLevel": "SINGLE_PASS",
                "RateControlMode": "CBR",
                "SampleAdaptiveOffsetFilterMode": "ADAPTIVE",
                "SceneChangeDetect": "ENABLED",
                "Slices": 4,
                "SlowPal": "DISABLED",
                "SpatialAdaptiveQuantization": "ENABLED",
                "Telecine": "NONE",
                "TemporalAdaptiveQuantization": "ENABLED",
                "TemporalIds": "DISABLED",
                "Tiles": "ENABLED",
                "UnregisteredSeiTimecode": "DISABLED"
            }
        },
        "ColorMetadata": "INSERT",
        "DropFrameTimecode": "ENABLED",
        "Height": 2160,
        "RespondToAfd": "NONE",
        "ScalingBehavior": "DEFAULT",
        "Sharpness": 50,
        "TimecodeInsertion": "DISABLED",
        "VideoPreprocessors": {
            "Deinterlacer": {
                "Algorithm": "INTERPOLATE",
                "Control": "NORMAL",
                "Mode": "DEINTERLACE"
            }
        },
        "Width": 3840
    }
}
```

#### YAML
<a name="aws-resource-mediaconvert-preset--examples--Output_Preset_Model_for_SettingsJson--yaml"></a>

```
---
AudioDescriptions:
- AudioType: 0
  AudioTypeControl: FOLLOW_INPUT
  CodecSettings:
    AacSettings:
      AudioDescriptionBroadcasterMix: NORMAL
      Bitrate: 160000
      CodecProfile: LC
      CodingMode: CODING_MODE_2_0
      RateControlMode: CBR
      RawFormat: NONE
      SampleRate: 48000
      Specification: MPEG4
    Codec: AAC
  LanguageCodeControl: FOLLOW_INPUT
ContainerSettings:
  Container: MP4
  Mp4Settings:
    CslgAtom: EXCLUDE
    FreeSpaceBox: EXCLUDE
    MoovPlacement: NORMAL
VideoDescription:
  AfdSignaling: NONE
  AntiAlias: ENABLED
  CodecSettings:
    Codec: H_265
    H265Settings:
      AdaptiveQuantization: HIGH
      AlternateTransferFunctionSei: DISABLED
      Bitrate: 10000000
      CodecLevel: LEVEL_5
      CodecProfile: MAIN_MAIN
      FlickerAdaptiveQuantization: DISABLED
      FramerateControl: SPECIFIED
      FramerateConversionAlgorithm: DUPLICATE_DROP
      FramerateDenominator: 1001
      FramerateNumerator: 24000
      GopBReference: ENABLED
      GopClosedCadence: 1
      GopSize: 48.0
      GopSizeUnits: FRAMES
      HrdBufferInitialFillPercentage: 90
      HrdBufferSize: 20000000
      InterlaceMode: PROGRESSIVE
      MinIInterval: 0
      NumberBFramesBetweenReferenceFrames: 3
      NumberReferenceFrames: 3
      ParControl: SPECIFIED
      ParDenominator: 1
      ParNumerator: 1
      QualityTuningLevel: SINGLE_PASS
      RateControlMode: CBR
      SampleAdaptiveOffsetFilterMode: ADAPTIVE
      SceneChangeDetect: ENABLED
      Slices: 4
      SlowPal: DISABLED
      SpatialAdaptiveQuantization: ENABLED
      Telecine: NONE
      TemporalAdaptiveQuantization: ENABLED
      TemporalIds: DISABLED
      Tiles: ENABLED
      UnregisteredSeiTimecode: DISABLED
  ColorMetadata: INSERT
  DropFrameTimecode: ENABLED
  Height: 2160
  RespondToAfd: NONE
  ScalingBehavior: DEFAULT
  Sharpness: 50
  TimecodeInsertion: DISABLED
  VideoPreprocessors:
    Deinterlacer:
      Algorithm: INTERPOLATE
      Control: NORMAL
      Mode: DEINTERLACE
  Width: 384
```

# AWS::MediaConvert::Queue
<a name="aws-resource-mediaconvert-queue"></a>

The AWS::MediaConvert::Queue resource is an AWS Elemental MediaConvert resource type that you can use to manage the resources that are available to your account for parallel processing of jobs. For more information about queues, see [Working with AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) in the * AWS Elemental MediaConvert User Guide *.

## Syntax
<a name="aws-resource-mediaconvert-queue-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-mediaconvert-queue-syntax.json"></a>

```
{
  "Type" : "AWS::MediaConvert::Queue",
  "Properties" : {
      "[ConcurrentJobs](#cfn-mediaconvert-queue-concurrentjobs)" : Integer,
      "[Description](#cfn-mediaconvert-queue-description)" : String,
      "[Name](#cfn-mediaconvert-queue-name)" : String,
      "[PricingPlan](#cfn-mediaconvert-queue-pricingplan)" : String,
      "[Status](#cfn-mediaconvert-queue-status)" : String,
      "[Tags](#cfn-mediaconvert-queue-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
<a name="aws-resource-mediaconvert-queue-syntax.yaml"></a>

```
Type: AWS::MediaConvert::Queue
Properties:
  [ConcurrentJobs](#cfn-mediaconvert-queue-concurrentjobs): Integer
  [Description](#cfn-mediaconvert-queue-description): String
  [Name](#cfn-mediaconvert-queue-name): String
  [PricingPlan](#cfn-mediaconvert-queue-pricingplan): String
  [Status](#cfn-mediaconvert-queue-status): String
  [Tags](#cfn-mediaconvert-queue-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
<a name="aws-resource-mediaconvert-queue-properties"></a>

`ConcurrentJobs`  <a name="cfn-mediaconvert-queue-concurrentjobs"></a>
Specify the maximum number of jobs your queue can process concurrently. For on-demand queues, the value you enter is constrained by your service quotas for Maximum concurrent jobs, per on-demand queue and Maximum concurrent jobs, per account. For reserved queues, specify the number of jobs you can process concurrently in your reservation plan instead.  
*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)

`Description`  <a name="cfn-mediaconvert-queue-description"></a>
Optional. A description of the queue that 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)

`Name`  <a name="cfn-mediaconvert-queue-name"></a>
The name of the queue that you are creating.  
*Required*: No  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`PricingPlan`  <a name="cfn-mediaconvert-queue-pricingplan"></a>
When you use CloudFormation, you can create only on-demand queues. Therefore, always set `PricingPlan` to the value "ON\$1DEMAND" when declaring an AWS::MediaConvert::Queue in your CloudFormation template.  
To create a reserved queue, use the AWS Elemental MediaConvert console at https://console.aws.amazon.com/mediaconvert to set up a contract. For more information, see [Working with AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) in the * AWS Elemental MediaConvert User Guide *.  
*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)

`Status`  <a name="cfn-mediaconvert-queue-status"></a>
Initial state of the queue. Queues can be either ACTIVE or PAUSED. If you create a paused queue, then jobs that you send to that queue won't begin.  
*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`  <a name="cfn-mediaconvert-queue-tags"></a>
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
<a name="aws-resource-mediaconvert-queue-return-values"></a>

### Ref
<a name="aws-resource-mediaconvert-queue-return-values-ref"></a>

When you pass the logical ID of an `AWS::MediaConvert::Queue` resource to the intrinsic `Ref` function, the function returns the name of the queue, such as `Queue 2`. 

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
<a name="aws-resource-mediaconvert-queue-return-values-fn--getatt"></a>

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).

#### 
<a name="aws-resource-mediaconvert-queue-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
The Amazon Resource Name (ARN) of the queue, such as `arn:aws:mediaconvert:us-west-2:123456789012`.

`Name`  <a name="Name-fn::getatt"></a>
The name of the queue, such as `Queue 2`.