Contrast level.
Type: integer Required: False Minimum: 1 Maximum: 100
hue
Hue in degrees.
Type: integer Required: False Minimum: -180 Maximum: 180
saturation
Saturation level.Properties
Type: integer Required: False Minimum: 1 Maximum: 100
hdr10Metadata
Use these settings when you convert to the HDR 10 color space. Specify the SMPTE ST 2086 Mastering Display Color Volume static metadata that you want signaled in the output. These values don't affect the pixel values that are encoded in the video stream. They are intended to help the downstream video player display content in a way that reflects the intentions of the the content creator. When you set Color space conversion (ColorSpaceConversion) to HDR 10 (FORCE_HDR10), these settings are required.
You must set values for Max frame average light level (maxFrameAverageLightLevel) and Max content light level (maxContentLightLevel); these settings don't have a default value. The default values for the other HDR 10 metadata settings are defined by the P3D65 color space. For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr.
Type: Hdr10Metadata (p. 255) Required: False
ColorMetadata
Choose Insert (INSERT) for this setting to include color metadata in this output. Choose Ignore (IGNORE) to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default.
IGNORE INSERT
ColorSpace
If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value Follow (FOLLOW). The service will automatically detect your input color space.
If your input video has metadata indicating the wrong color space, specify the accurate color space here.
If your input video is HDR 10 and the SMPTE ST 2086 Mastering Display Color Volume static metadata isn't present in your video stream, or if that metadata is present but not accurate, choose Force HDR 10 (FORCE_HDR10) here and specify correct values in the input HDR 10 metadata (Hdr10Metadata) settings. For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/
console/mediaconvert/hdr.
FOLLOW REC_601 REC_709 HDR10 HLG_2020
ColorSpaceConversion
Specify the color space you want for this output. The service supports conversion between HDR formats, between SDR formats, from SDR to HDR, and from HDR to SDR. SDR to HDR conversion doesn't upgrade the dynamic range. The converted video has an HDR format, but visually appears the same as an
unconverted output. HDR to SDR conversion uses Elemental tone mapping technology to approximate the outcome of manually regrading from HDR to SDR.
Properties
NONEFORCE_601 FORCE_709 FORCE_HDR10 FORCE_HLG_2020
ColorSpaceUsage
There are two sources for color metadata, the input file and the job input settings Color space (ColorSpace) and HDR master display information settings(Hdr10Metadata). The Color space usage setting determines which takes precedence. Choose Force (FORCE) to use color metadata from the input job settings. If you don't specify values for those settings, the service defaults to using metadata from your input. FALLBACK - Choose Fallback (FALLBACK) to use color metadata from the source when it is present. If there's no color metadata in your input file, the service defaults to using values you specify in the input settings.
FORCE FALLBACK
ContainerSettings
Container specific settings.
container
Container for this output. Some containers require a container settings object. If not specified, the default object will be created.
Type: ContainerType (p. 180) Required: False
m3u8Settings
These settings relate to the MPEG-2 transport stream (MPEG2-TS) container for the MPEG2-TS segments in your HLS outputs.
Type: M3u8Settings (p. 310) Required: False
f4vSettings
Settings for F4v container Type: F4vSettings (p. 221) Required: False
m2tsSettings
MPEG-2 TS container settings. These apply to outputs in a File output group when the output's container (ContainerType) is MPEG-2 Transport Stream (M2TS). In these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in
Properties
a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.
Type: M2tsSettings (p. 302) Required: False
movSettings
These settings relate to your QuickTime MOV output container.
Type: MovSettings (p. 317) Required: False
mp4Settings
These settings relate to your MP4 output container. You can create audio only outputs with this
container. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/supported-codecs-containers-audio-only.html#output-codecs-and-containers-supported-for-audio-only.
Type: Mp4Settings (p. 320) Required: False
mpdSettings
These settings relate to the fragmented MP4 container for the segments in your DASH outputs.
Type: MpdSettings (p. 322) Required: False
cmfcSettings
These settings relate to the fragmented MP4 container for the segments in your CMAF outputs.
Type: CmfcSettings (p. 174) Required: False
mxfSettings
These settings relate to your MXF output container.
Type: MxfSettings (p. 338) Required: False
ContainerType
Container for this output. Some containers require a container settings object. If not specified, the default object will be created.
F4VISMV M2TSM3U8 CMFCMOV
Properties
MP4MPD MXFWEBM RAW
CopyProtectionAction
The action to take on copy and redistribution control XDS packets. If you select PASSTHROUGH, packets will not be changed. If you select STRIP, any packets will be removed in output captions.
PASSTHROUGH STRIP
CreateJobRequest
Send your create job request with your job settings and IAM role. Optionally, include user metadata and the ARN for the queue.
clientRequestToken
Optional. Idempotency token for CreateJob operation.
Type: string Required: False
jobTemplate
Optional. When you create a job, you can either specify a job template or specify the transcoding settings individually.
Type: string Required: False
queue
Optional. When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at https://
docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html.
Type: string Required: False
role
Required. The IAM role you use for creating this job. For details about permissions, see the User Guide topic at the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.html.
Type: string Required: True
settings
JobSettings contains all the transcode settings for a job.
Properties
Type: JobSettings (p. 290) Required: True
userMetadata
Optional. User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs. Use only for existing integrations or workflows that rely on job metadata tags. Otherwise, we recommend that you use standard AWS tags.
Type: object Required: False
billingTagsSource
Optional. Choose a tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up. Any transcoding outputs that don't have an associated tag will appear in your billing report unsorted. If you don't choose a valid value for this field, your job outputs will appear on the billing report unsorted.
Type: BillingTagsSource (p. 149) Required: False
tags
Optional. The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key. Use standard AWS tags on your job for automatic integration with AWS services and for custom integrations and workflows.
Type: object Required: False
accelerationSettings
Optional. 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, see the AWS Elemental MediaConvert User Guide.
Type: AccelerationSettings (p. 125) Required: False
statusUpdateInterval
Optional. Specify how often MediaConvert sends STATUS_UPDATE 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.
Type: StatusUpdateInterval (p. 367) Required: False
priority
Optional. 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
Properties
processing the job that you submitted first. If you don't specify a priority, the service uses the default value 0.
Type: integer Required: False Format: int32 Minimum: -50 Maximum: 50
simulateReservedQueue
Optional. Enable this setting when you run a test job to estimate how many reserved transcoding slots (RTS) you need. When this is enabled, MediaConvert runs your job from an on-demand queue with similar performance to what you will see with one RTS in a reserved queue. This setting is disabled by default.
Type: SimulateReservedQueue (p. 363) Required: False
hopDestinations
Optional. Use queue hopping to avoid overly long waits in the backlog of the queue that you submit your job to. Specify an alternate queue and the maximum time that your job will wait in the initial queue before hopping. For more information about this feature, see the AWS Elemental MediaConvert User Guide.
Type: Array of type HopDestination (p. 273) Required: False
CreateJobResponse
Successful create job requests will return the job JSON.
job
Each job converts an input file into an output file or files. For more information, see the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html
Type: Job (p. 285) Required: False
DashAdditionalManifest
Specify the details for each additional DASH manifest that you want the service to generate for this output group. Each manifest can reference a different subset of outputs in the group.
manifestNameModifier
Specify a name modifier that the service adds to the name of this manifest to make it different from the file names of the other main manifests in the output group. For example, say that the default main manifest for your DASH group is film-name.mpd. If you enter "-no-premium" for this setting, then the file name the service generates for this top-level manifest is film-name-no-premium.mpd.
Type: string
Properties
Required: False MinLength: 1
selectedOutputs
Specify the outputs that you want this additional top-level manifest to reference.
Type: Array of type string Required: False
MinLength: 1
DashIsoEncryptionSettings
Specifies DRM settings for DASH outputs.
playbackDeviceCompatibility
This setting can improve the compatibility of your output with video players on obsolete devices. It applies only to DASH H.264 outputs with DRM encryption. Choose Unencrypted SEI (UNENCRYPTED_SEI) only to correct problems with playback on older devices. Otherwise, keep the default setting CENC v1 (CENC_V1). If you choose Unencrypted SEI, for that output, the service will exclude the access unit delimiter and will leave the SEI NAL units unencrypted.
Type: DashIsoPlaybackDeviceCompatibility (p. 190) Required: False
spekeKeyProvider
If your output group type is HLS, DASH, or Microsoft Smooth, use these settings when doing DRM encryption with a SPEKE-compliant key provider. If your output group type is CMAF, use the SpekeKeyProviderCmaf settings instead.
Type: SpekeKeyProvider (p. 364) Required: False