openapi: 3.0.0 info: version: 2018-04-23 x-release: v4 title: AWS MediaTailor Alerts#resourceArn Channel API description:

Use the AWS Elemental MediaTailor SDKs and CLI to configure scalable ad insertion and linear channels. With MediaTailor, you can assemble existing content into a linear stream and serve targeted ads to viewers while maintaining broadcast quality in over-the-top (OTT) video applications. For information about using the service, including detailed information about the settings covered in this guide, see the AWS Elemental MediaTailor User Guide.

Through the SDKs and the CLI you manage AWS Elemental MediaTailor configurations and channels the same as you do through the console. For example, you specify ad insertion behavior and mapping information for the origin server and the ad decision server (ADS).

x-logo: url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: mediatailor x-aws-signingName: mediatailor x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/mediatailor-2018-04-23.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://api.mediatailor.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The MediaTailor multi-region endpoint - url: https://api.mediatailor.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The MediaTailor multi-region endpoint - url: http://api.mediatailor.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The MediaTailor endpoint for China (Beijing) and China (Ningxia) - url: https://api.mediatailor.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The MediaTailor endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: Channel paths: /channel/{ChannelName}: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CreateChannel description: Creates a channel. For information about MediaTailor channels, see Working with channels in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CreateChannelResponse' examples: CreateChannel200Example: summary: Default CreateChannel 200 response x-microcks-default: true value: Arn: arn:aws:service:us-east-1:123456789012:resource/example ChannelName: example-resource ChannelState: example-value CreationTime: example-value FillerSlate: example-value parameters: - name: ChannelName in: path required: true description: The name of the channel. schema: type: string requestBody: required: true content: application/json: schema: type: object required: - Outputs - PlaybackMode properties: FillerSlate: description: Slate VOD source configuration. type: object properties: SourceLocationName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the source location where the slate VOD source is stored. VodSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate. Outputs: description: An object that represents an object in the CreateChannel request. type: array items: $ref: '#/components/schemas/RequestOutputItem' PlaybackMode: description:

The type of playback mode to use for this channel.

LINEAR - The programs in the schedule play once back-to-back in the schedule.

LOOP - The programs in the schedule play back-to-back in an endless loop. When the last program in the schedule stops playing, playback loops back to the first program in the schedule.

type: string enum: - LOOP - LINEAR tags: description: The tags to assign to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see Tagging AWS Elemental MediaTailor Resources. type: object additionalProperties: $ref: '#/components/schemas/__string' Tier: description: The tier of the channel. type: string enum: - BASIC - STANDARD summary: Amazon MediaTailor Create Channel x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel delete: operationId: DeleteChannel description: Deletes a channel. For information about MediaTailor channels, see Working with channels in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DeleteChannelResponse' examples: DeleteChannel200Example: summary: Default DeleteChannel 200 response x-microcks-default: true value: {} parameters: - name: ChannelName in: path required: true description: The name of the channel. schema: type: string summary: Amazon MediaTailor Delete Channel x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel get: operationId: DescribeChannel description: Describes a channel. For information about MediaTailor channels, see Working with channels in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DescribeChannelResponse' examples: DescribeChannel200Example: summary: Default DescribeChannel 200 response x-microcks-default: true value: Arn: arn:aws:service:us-east-1:123456789012:resource/example ChannelName: example-resource ChannelState: example-value CreationTime: example-value FillerSlate: example-value parameters: - name: ChannelName in: path required: true description: The name of the channel. schema: type: string summary: Amazon MediaTailor Describe Channel x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel put: operationId: UpdateChannel description: Updates a channel. For information about MediaTailor channels, see Working with channels in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/UpdateChannelResponse' examples: UpdateChannel200Example: summary: Default UpdateChannel 200 response x-microcks-default: true value: Arn: arn:aws:service:us-east-1:123456789012:resource/example ChannelName: example-resource ChannelState: example-value CreationTime: example-value FillerSlate: example-value parameters: - name: ChannelName in: path required: true description: The name of the channel. schema: type: string requestBody: required: true content: application/json: schema: type: object required: - Outputs properties: FillerSlate: description: Slate VOD source configuration. type: object properties: SourceLocationName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the source location where the slate VOD source is stored. VodSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate. Outputs: description: An object that represents an object in the CreateChannel request. type: array items: $ref: '#/components/schemas/RequestOutputItem' summary: Amazon MediaTailor Update Channel x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel /channel/{ChannelName}/program/{ProgramName}: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CreateProgram description: Creates a program within a channel. For information about programs, see Working with programs in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CreateProgramResponse' examples: CreateProgram200Example: summary: Default CreateProgram 200 response x-microcks-default: true value: AdBreaks: example-value Arn: arn:aws:service:us-east-1:123456789012:resource/example ChannelName: example-resource ClipRange: example-value CreationTime: example-value parameters: - name: ChannelName in: path required: true description: The name of the channel for this Program. schema: type: string - name: ProgramName in: path required: true description: The name of the Program. schema: type: string requestBody: required: true content: application/json: schema: type: object required: - ScheduleConfiguration - SourceLocationName properties: AdBreaks: description: The ad break configuration settings. type: array items: $ref: '#/components/schemas/AdBreak' LiveSourceName: description: The name of the LiveSource for this Program. type: string ScheduleConfiguration: description: Schedule configuration parameters. A channel must be stopped before changes can be made to the schedule. type: object properties: ClipRange: allOf: - $ref: '#/components/schemas/ClipRange' - description: Program clip range configuration. Transition: allOf: - $ref: '#/components/schemas/Transition' - description: Program transition configurations. SourceLocationName: description: The name of the source location. type: string VodSourceName: description: The name that's used to refer to a VOD source. type: string summary: Amazon MediaTailor Create Program x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel delete: operationId: DeleteProgram description: Deletes a program within a channel. For information about programs, see Working with programs in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DeleteProgramResponse' examples: DeleteProgram200Example: summary: Default DeleteProgram 200 response x-microcks-default: true value: {} parameters: - name: ChannelName in: path required: true description: The name of the channel. schema: type: string - name: ProgramName in: path required: true description: The name of the program. schema: type: string summary: Amazon MediaTailor Delete Program x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel get: operationId: DescribeProgram description: Describes a program within a channel. For information about programs, see Working with programs in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DescribeProgramResponse' examples: DescribeProgram200Example: summary: Default DescribeProgram 200 response x-microcks-default: true value: AdBreaks: example-value Arn: arn:aws:service:us-east-1:123456789012:resource/example ChannelName: example-resource ClipRange: example-value CreationTime: example-value parameters: - name: ChannelName in: path required: true description: The name of the channel associated with this Program. schema: type: string - name: ProgramName in: path required: true description: The name of the program. schema: type: string summary: Amazon MediaTailor Describe Program x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel put: operationId: UpdateProgram description: Updates a program within a channel. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/UpdateProgramResponse' examples: UpdateProgram200Example: summary: Default UpdateProgram 200 response x-microcks-default: true value: AdBreaks: example-value Arn: arn:aws:service:us-east-1:123456789012:resource/example ChannelName: example-resource ClipRange: example-value CreationTime: example-value parameters: - name: ChannelName in: path required: true description: The name of the channel for this Program. schema: type: string - name: ProgramName in: path required: true description: The name of the Program. schema: type: string requestBody: required: true content: application/json: schema: type: object required: - ScheduleConfiguration properties: AdBreaks: description: The ad break configuration settings. type: array items: $ref: '#/components/schemas/AdBreak' ScheduleConfiguration: description: Schedule configuration parameters. type: object properties: ClipRange: allOf: - $ref: '#/components/schemas/ClipRange' - description: Program clip range configuration. Transition: allOf: - $ref: '#/components/schemas/UpdateProgramTransition' - description: Program transition configuration. summary: Amazon MediaTailor Update Program x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel /channel/{ChannelName}/policy: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' delete: operationId: DeleteChannelPolicy description: The channel policy to delete. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DeleteChannelPolicyResponse' examples: DeleteChannelPolicy200Example: summary: Default DeleteChannelPolicy 200 response x-microcks-default: true value: {} parameters: - name: ChannelName in: path required: true description: The name of the channel associated with this channel policy. schema: type: string summary: Amazon MediaTailor Delete Channel Policy x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel get: operationId: GetChannelPolicy description: Returns the channel's IAM policy. IAM policies are used to control access to your channel. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GetChannelPolicyResponse' examples: GetChannelPolicy200Example: summary: Default GetChannelPolicy 200 response x-microcks-default: true value: Policy: example-value parameters: - name: ChannelName in: path required: true description: The name of the channel associated with this Channel Policy. schema: type: string summary: Amazon MediaTailor Get Channel Policy x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel put: operationId: PutChannelPolicy description: Creates an IAM policy for the channel. IAM policies are used to control access to your channel. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/PutChannelPolicyResponse' examples: PutChannelPolicy200Example: summary: Default PutChannelPolicy 200 response x-microcks-default: true value: {} parameters: - name: ChannelName in: path required: true description: The channel name associated with this Channel Policy. schema: type: string requestBody: required: true content: application/json: schema: type: object required: - Policy properties: Policy: description: Adds an IAM role that determines the permissions of your channel. type: string summary: Amazon MediaTailor Put Channel Policy x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel /channel/{ChannelName}/schedule: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' get: operationId: GetChannelSchedule description: Retrieves information about your channel's schedule. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GetChannelScheduleResponse' examples: GetChannelSchedule200Example: summary: Default GetChannelSchedule 200 response x-microcks-default: true value: Items: example-value NextToken: example-value parameters: - name: ChannelName in: path required: true description: The name of the channel associated with this Channel Schedule. schema: type: string - name: durationMinutes in: query required: false description: The duration in minutes of the channel schedule. schema: type: string - name: maxResults in: query required: false description: The maximum number of channel schedules that you want MediaTailor to return in response to the current request. If there are more than MaxResults channel schedules, use the value of NextToken in the response to get the next page of results. schema: type: integer minimum: 1 maximum: 100 - name: nextToken in: query required: false description:

(Optional) If the playback configuration has more than MaxResults channel schedules, use NextToken to get the second and subsequent pages of results.

For the first GetChannelScheduleRequest request, omit this value.

For the second and subsequent requests, get the value of NextToken from the previous response and specify that value for NextToken in the request.

If the previous response didn't include a NextToken element, there are no more channel schedules to get.

schema: type: string - name: MaxResults in: query schema: type: string description: Pagination limit required: false - name: NextToken in: query schema: type: string description: Pagination token required: false summary: Amazon MediaTailor Get Channel Schedule x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel /channel/{ChannelName}/start: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' put: operationId: StartChannel description: Starts a channel. For information about MediaTailor channels, see Working with channels in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/StartChannelResponse' examples: StartChannel200Example: summary: Default StartChannel 200 response x-microcks-default: true value: {} parameters: - name: ChannelName in: path required: true description: The name of the channel. schema: type: string summary: Amazon MediaTailor Start Channel x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel /channel/{ChannelName}/stop: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' put: operationId: StopChannel description: Stops a channel. For information about MediaTailor channels, see Working with channels in the MediaTailor User Guide. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/StopChannelResponse' examples: StopChannel200Example: summary: Default StopChannel 200 response x-microcks-default: true value: {} parameters: - name: ChannelName in: path required: true description: The name of the channel. schema: type: string summary: Amazon MediaTailor Stop Channel x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Channel components: schemas: ClipRange: type: object required: - EndOffsetMillis properties: EndOffsetMillis: allOf: - $ref: '#/components/schemas/__long' - description: The end offset of the clip range, in milliseconds, starting from the beginning of the VOD source associated with the program. description: Clip range configuration for the VOD source associated with the program. Transition: type: object required: - RelativePosition - Type properties: DurationMillis: allOf: - $ref: '#/components/schemas/__long' - description: The duration of the live program in seconds. RelativePosition: allOf: - $ref: '#/components/schemas/RelativePosition' - description: The position where this program will be inserted relative to the RelativePosition. RelativeProgram: allOf: - $ref: '#/components/schemas/__string' - description: The name of the program that this program will be inserted next to, as defined by RelativePosition. ScheduledStartTimeMillis: allOf: - $ref: '#/components/schemas/__long' - description: The date and time that the program is scheduled to start, in epoch milliseconds. Type: allOf: - $ref: '#/components/schemas/__string' - description:

Defines when the program plays in the schedule. You can set the value to ABSOLUTE or RELATIVE.

ABSOLUTE - The program plays at a specific wall clock time. This setting can only be used for channels using the LINEAR PlaybackMode.

Note the following considerations when using ABSOLUTE transitions:

If the preceding program in the schedule has a duration that extends past the wall clock time, MediaTailor truncates the preceding program on a common segment boundary.

If there are gaps in playback, MediaTailor plays the FillerSlate you configured for your linear channel.

RELATIVE - The program is inserted into the schedule either before or after a program that you specify via RelativePosition.

description: Program transition configuration. ChannelState: type: string enum: - RUNNING - STOPPED __mapOf__string: type: object additionalProperties: $ref: '#/components/schemas/__string' TimeSignalMessage: type: object properties: SegmentationDescriptors: allOf: - $ref: '#/components/schemas/SegmentationDescriptorList' - description: The configurations for the SCTE-35 segmentation_descriptor message(s) sent with the time_signal message. description:

The SCTE-35 time_signal message can be sent with one or more segmentation_descriptor messages. A time_signal message can be sent only if a single segmentation_descriptor message is sent.

The time_signal message contains only the splice_time field which is constructed using a given presentation timestamp. When sending a time_signal message, the splice_command_type field in the splice_info_section message is set to 6 (0x06).

See the time_signal() table of the 2022 SCTE-35 specification for more information.

__timestampUnix: type: string format: date-time SpliceInsertMessage: type: object properties: AvailNum: allOf: - $ref: '#/components/schemas/__integer' - description: This is written to splice_insert.avail_num, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 0. Values must be between 0 and 256, inclusive. AvailsExpected: allOf: - $ref: '#/components/schemas/__integer' - description: This is written to splice_insert.avails_expected, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 0. Values must be between 0 and 256, inclusive. SpliceEventId: allOf: - $ref: '#/components/schemas/__integer' - description: This is written to splice_insert.splice_event_id, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 1. UniqueProgramId: allOf: - $ref: '#/components/schemas/__integer' - description: This is written to splice_insert.unique_program_id, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 0. Values must be between 0 and 256, inclusive. description: Splice insert message configuration. Integer: type: integer ScheduleEntryType: type: string enum: - PROGRAM - FILLER_SLATE __long: type: integer SegmentationDescriptor: type: object properties: SegmentNum: allOf: - $ref: '#/components/schemas/Integer' - description: The segment number to assign to the segmentation_descriptor.segment_num message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0. SegmentationEventId: allOf: - $ref: '#/components/schemas/Integer' - description: The Event Identifier to assign to the segmentation_descriptor.segmentation_event_id message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The default value is 1. SegmentationTypeId: allOf: - $ref: '#/components/schemas/Integer' - description: The Type Identifier to assign to the segmentation_descriptor.segmentation_type_id message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 48. SegmentationUpid: allOf: - $ref: '#/components/schemas/String' - description: The Upid to assign to the segmentation_descriptor.segmentation_upid message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The value must be a hexadecimal string containing only the characters 0 though 9 and A through F. The default value is "" (an empty string). SegmentationUpidType: allOf: - $ref: '#/components/schemas/Integer' - description: The Upid Type to assign to the segmentation_descriptor.segmentation_upid_type message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 14. SegmentsExpected: allOf: - $ref: '#/components/schemas/Integer' - description: The number of segments expected, which is assigned to the segmentation_descriptor.segments_expectedS message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0. SubSegmentNum: allOf: - $ref: '#/components/schemas/Integer' - description: The sub-segment number to assign to the segmentation_descriptor.sub_segment_num message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The defualt value is null. SubSegmentsExpected: allOf: - $ref: '#/components/schemas/Integer' - description: The number of sub-segments expected, which is assigned to the segmentation_descriptor.sub_segments_expected message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is null. description:

The segmentation_descriptor message can contain advanced metadata fields, like content identifiers, to convey a wide range of information about the ad break. MediaTailor writes the ad metadata in the egress manifest as part of the EXT-X-DATERANGE or EventStream ad marker's SCTE-35 data.

segmentation_descriptor messages must be sent with the time_signal message type.

See the segmentation_descriptor() table of the 2022 SCTE-35 specification for more information.

ScheduleEntry: type: object required: - Arn - ChannelName - ProgramName - SourceLocationName properties: ApproximateDurationSeconds: allOf: - $ref: '#/components/schemas/__long' - description: The approximate duration of this program, in seconds. ApproximateStartTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The approximate time that the program will start playing. Arn: allOf: - $ref: '#/components/schemas/__string' - description: The ARN of the program. ChannelName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the channel that uses this schedule. LiveSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the live source used for the program. ProgramName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the program. ScheduleAdBreaks: allOf: - $ref: '#/components/schemas/__listOfScheduleAdBreak' - description: The schedule's ad break properties. ScheduleEntryType: allOf: - $ref: '#/components/schemas/ScheduleEntryType' - description: The type of schedule entry. SourceLocationName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the source location. VodSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the VOD source. description: The properties for a schedule. SegmentationDescriptorList: type: array items: $ref: '#/components/schemas/SegmentationDescriptor' __integer: type: integer __listOfScheduleEntry: type: array items: $ref: '#/components/schemas/ScheduleEntry' DescribeChannelResponse: type: object required: - LogConfiguration properties: Arn: allOf: - $ref: '#/components/schemas/__string' - description: The ARN of the channel. ChannelName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the channel. ChannelState: allOf: - $ref: '#/components/schemas/ChannelState' - description: Indicates whether the channel is in a running state or not. CreationTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The timestamp of when the channel was created. FillerSlate: allOf: - $ref: '#/components/schemas/SlateSource' - description: Contains information about the slate used to fill gaps between programs in the schedule. LastModifiedTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The timestamp of when the channel was last modified. LogConfiguration: allOf: - $ref: '#/components/schemas/LogConfigurationForChannel' - description: The log configuration for the channel. Outputs: allOf: - $ref: '#/components/schemas/ResponseOutputs' - description: The channel's output properties. PlaybackMode: allOf: - $ref: '#/components/schemas/__string' - description: The channel's playback mode. Tags: allOf: - $ref: '#/components/schemas/__mapOf__string' - xml: name: tags description: The tags assigned to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see Tagging AWS Elemental MediaTailor Resources. Tier: allOf: - $ref: '#/components/schemas/__string' - description: The channel's tier. __listOfScheduleAdBreak: type: array items: $ref: '#/components/schemas/ScheduleAdBreak' LogType: type: string enum: - AS_RUN PutChannelPolicyResponse: type: object properties: {} __string: type: string ScheduleAdBreak: type: object properties: ApproximateDurationSeconds: allOf: - $ref: '#/components/schemas/__long' - description: The approximate duration of the ad break, in seconds. ApproximateStartTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The approximate time that the ad will start playing. SourceLocationName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the source location containing the VOD source used for the ad break. VodSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the VOD source used for the ad break. description: The schedule's ad break properties. UpdateProgramResponse: type: object properties: AdBreaks: allOf: - $ref: '#/components/schemas/__listOfAdBreak' - description: The ad break configuration settings. Arn: allOf: - $ref: '#/components/schemas/__string' - description: The ARN to assign to the program. ChannelName: allOf: - $ref: '#/components/schemas/__string' - description: The name to assign to the channel for this program. ClipRange: allOf: - $ref: '#/components/schemas/ClipRange' - description: The clip range configuration settings. CreationTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The time the program was created. DurationMillis: allOf: - $ref: '#/components/schemas/__long' - description: The duration of the live program in milliseconds. LiveSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the LiveSource for this Program. ProgramName: allOf: - $ref: '#/components/schemas/__string' - description: The name to assign to this program. ScheduledStartTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The scheduled start time for this Program. SourceLocationName: allOf: - $ref: '#/components/schemas/__string' - description: The name to assign to the source location for this program. VodSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name that's used to refer to a VOD source. CreateChannelResponse: type: object properties: Arn: allOf: - $ref: '#/components/schemas/__string' - description: The Amazon Resource Name (ARN) to assign to the channel. ChannelName: allOf: - $ref: '#/components/schemas/__string' - description: The name to assign to the channel. ChannelState: allOf: - $ref: '#/components/schemas/ChannelState' - description: Indicates whether the channel is in a running state or not. CreationTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The timestamp of when the channel was created. FillerSlate: allOf: - $ref: '#/components/schemas/SlateSource' - description: Contains information about the slate used to fill gaps between programs in the schedule. LastModifiedTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The timestamp of when the channel was last modified. Outputs: allOf: - $ref: '#/components/schemas/ResponseOutputs' - description: The output properties to assign to the channel. PlaybackMode: allOf: - $ref: '#/components/schemas/__string' - description: The playback mode to assign to the channel. Tags: allOf: - $ref: '#/components/schemas/__mapOf__string' - xml: name: tags description: The tags to assign to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see Tagging AWS Elemental MediaTailor Resources. Tier: allOf: - $ref: '#/components/schemas/__string' - description: The tier of the channel. ResponseOutputItem: type: object required: - ManifestName - PlaybackUrl - SourceGroup properties: DashPlaylistSettings: allOf: - $ref: '#/components/schemas/DashPlaylistSettings' - description: DASH manifest configuration settings. HlsPlaylistSettings: allOf: - $ref: '#/components/schemas/HlsPlaylistSettings' - description: HLS manifest configuration settings. ManifestName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the manifest for the channel that will appear in the channel output's playback URL. PlaybackUrl: allOf: - $ref: '#/components/schemas/__string' - description: The URL used for playback by content players. SourceGroup: allOf: - $ref: '#/components/schemas/__string' - description: A string used to associate a package configuration source group with a channel output. description: The output item response. String: type: string LogConfigurationForChannel: type: object properties: LogTypes: allOf: - $ref: '#/components/schemas/LogTypes' - description: The log types. description: The log configuration for the channel. Long: type: integer RequestOutputItem: type: object required: - ManifestName - SourceGroup properties: DashPlaylistSettings: allOf: - $ref: '#/components/schemas/DashPlaylistSettings' - description: DASH manifest configuration parameters. HlsPlaylistSettings: allOf: - $ref: '#/components/schemas/HlsPlaylistSettings' - description: HLS playlist configuration parameters. ManifestName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the manifest for the channel. The name appears in the PlaybackUrl. SourceGroup: allOf: - $ref: '#/components/schemas/__string' - description: A string used to match which HttpPackageConfiguration is used for each VodSource. description: The output configuration for this channel. DeleteChannelResponse: type: object properties: {} SlateSource: type: object properties: SourceLocationName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the source location where the slate VOD source is stored. VodSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate. description: Slate VOD source configuration. DescribeProgramResponse: type: object properties: AdBreaks: allOf: - $ref: '#/components/schemas/__listOfAdBreak' - description: The ad break configuration settings. Arn: allOf: - $ref: '#/components/schemas/__string' - description: The ARN of the program. ChannelName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the channel that the program belongs to. ClipRange: allOf: - $ref: '#/components/schemas/ClipRange' - description: The clip range configuration settings. CreationTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The timestamp of when the program was created. DurationMillis: allOf: - $ref: '#/components/schemas/Long' - description: The duration of the live program in milliseconds. LiveSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the LiveSource for this Program. ProgramName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the program. ScheduledStartTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The date and time that the program is scheduled to start in ISO 8601 format and Coordinated Universal Time (UTC). For example, the value 2021-03-27T17:48:16.751Z represents March 27, 2021 at 17:48:16.751 UTC. SourceLocationName: allOf: - $ref: '#/components/schemas/__string' - description: The source location name. VodSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name that's used to refer to a VOD source. UpdateProgramTransition: type: object properties: DurationMillis: allOf: - $ref: '#/components/schemas/__long' - description: The duration of the live program in seconds. ScheduledStartTimeMillis: allOf: - $ref: '#/components/schemas/__long' - description: The date and time that the program is scheduled to start, in epoch milliseconds. description: Program transition configuration. GetChannelScheduleResponse: type: object properties: Items: allOf: - $ref: '#/components/schemas/__listOfScheduleEntry' - description: A list of schedule entries for the channel. NextToken: allOf: - $ref: '#/components/schemas/__string' - description: Pagination token returned by the list request when results exceed the maximum allowed. Use the token to fetch the next page of results. StopChannelResponse: type: object properties: {} GetChannelPolicyResponse: type: object properties: Policy: allOf: - $ref: '#/components/schemas/__string' - description: The IAM policy for the channel. IAM policies are used to control access to your channel. CreateProgramResponse: type: object properties: AdBreaks: allOf: - $ref: '#/components/schemas/__listOfAdBreak' - description: The ad break configuration settings. Arn: allOf: - $ref: '#/components/schemas/__string' - description: The ARN to assign to the program. ChannelName: allOf: - $ref: '#/components/schemas/__string' - description: The name to assign to the channel for this program. ClipRange: allOf: - $ref: '#/components/schemas/ClipRange' - description: The clip range configuration settings. CreationTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The time the program was created. DurationMillis: allOf: - $ref: '#/components/schemas/__long' - description: The duration of the live program in milliseconds. LiveSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the LiveSource for this Program. ProgramName: allOf: - $ref: '#/components/schemas/__string' - description: The name to assign to this program. ScheduledStartTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The scheduled start time for this Program. SourceLocationName: allOf: - $ref: '#/components/schemas/__string' - description: The name to assign to the source location for this program. VodSourceName: allOf: - $ref: '#/components/schemas/__string' - description: The name that's used to refer to a VOD source. StartChannelResponse: type: object properties: {} UpdateChannelResponse: type: object properties: Arn: allOf: - $ref: '#/components/schemas/__string' - description: The Amazon Resource Name (ARN) associated with the channel. ChannelName: allOf: - $ref: '#/components/schemas/__string' - description: The name of the channel. ChannelState: allOf: - $ref: '#/components/schemas/ChannelState' - description: Returns the state whether the channel is running or not. CreationTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The timestamp of when the channel was created. FillerSlate: allOf: - $ref: '#/components/schemas/SlateSource' - description: The slate used to fill gaps between programs in the schedule. You must configure filler slate if your channel uses the LINEAR PlaybackMode. MediaTailor doesn't support filler slate for channels using the LOOP PlaybackMode. LastModifiedTime: allOf: - $ref: '#/components/schemas/__timestampUnix' - description: The timestamp that indicates when the channel was last modified. Outputs: allOf: - $ref: '#/components/schemas/ResponseOutputs' - description: The channel's output properties. PlaybackMode: allOf: - $ref: '#/components/schemas/__string' - description:

The type of playback mode for this channel.

LINEAR - Programs play back-to-back only once.

LOOP - Programs play back-to-back in an endless loop. When the last program in the schedule plays, playback loops back to the first program in the schedule.

Tags: allOf: - $ref: '#/components/schemas/__mapOf__string' - xml: name: tags description: The tags to assign to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see Tagging AWS Elemental MediaTailor Resources. Tier: allOf: - $ref: '#/components/schemas/__string' - description: The tier associated with this Channel. ResponseOutputs: type: array items: $ref: '#/components/schemas/ResponseOutputItem' HlsPlaylistSettings: type: object properties: ManifestWindowSeconds: allOf: - $ref: '#/components/schemas/__integer' - description: 'The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.' description: HLS playlist configuration parameters. __listOfAdBreak: type: array items: $ref: '#/components/schemas/AdBreak' DeleteChannelPolicyResponse: type: object properties: {} RelativePosition: type: string enum: - BEFORE_PROGRAM - AFTER_PROGRAM DeleteProgramResponse: type: object properties: {} DashPlaylistSettings: type: object properties: ManifestWindowSeconds: allOf: - $ref: '#/components/schemas/__integer' - description: 'The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.' MinBufferTimeSeconds: allOf: - $ref: '#/components/schemas/__integer' - description: 'Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: 2 seconds. Maximum value: 60 seconds.' MinUpdatePeriodSeconds: allOf: - $ref: '#/components/schemas/__integer' - description: 'Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.' SuggestedPresentationDelaySeconds: allOf: - $ref: '#/components/schemas/__integer' - description: 'Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.' description: Dash manifest configuration parameters. AdBreak: type: object properties: MessageType: allOf: - $ref: '#/components/schemas/MessageType' - description: 'The SCTE-35 ad insertion type. Accepted value: SPLICE_INSERT, TIME_SIGNAL.' OffsetMillis: allOf: - $ref: '#/components/schemas/__long' - description: How long (in milliseconds) after the beginning of the program that an ad starts. This value must fall within 100ms of a segment boundary, otherwise the ad break will be skipped. Slate: allOf: - $ref: '#/components/schemas/SlateSource' - description: Ad break slate configuration. SpliceInsertMessage: allOf: - $ref: '#/components/schemas/SpliceInsertMessage' - description: This defines the SCTE-35 splice_insert() message inserted around the ad. For information about using splice_insert(), see the SCTE-35 specficiaiton, section 9.7.3.1. TimeSignalMessage: allOf: - $ref: '#/components/schemas/TimeSignalMessage' - description:

Defines the SCTE-35 time_signal message inserted around the ad.

Programs on a channel's schedule can be configured with one or more ad breaks. You can attach a splice_insert SCTE-35 message to the ad break. This message provides basic metadata about the ad break.

See section 9.7.4 of the 2022 SCTE-35 specification for more information.

description: Ad break configuration parameters. LogTypes: type: array items: $ref: '#/components/schemas/LogType' MessageType: type: string enum: - SPLICE_INSERT - TIME_SIGNAL parameters: X-Amz-Credential: name: X-Amz-Credential in: header schema: type: string required: false X-Amz-Date: name: X-Amz-Date in: header schema: type: string required: false X-Amz-Signature: name: X-Amz-Signature in: header schema: type: string required: false X-Amz-Algorithm: name: X-Amz-Algorithm in: header schema: type: string required: false X-Amz-Security-Token: name: X-Amz-Security-Token in: header schema: type: string required: false X-Amz-SignedHeaders: name: X-Amz-SignedHeaders in: header schema: type: string required: false X-Amz-Content-Sha256: name: X-Amz-Content-Sha256 in: header schema: type: string required: false securitySchemes: hmac: type: apiKey name: Authorization in: header description: Amazon Signature authorization v4 x-amazon-apigateway-authtype: awsSigv4 externalDocs: description: Amazon Web Services documentation url: https://docs.aws.amazon.com/mediatailor/ x-hasEquivalentPaths: true