Amazon MediaTailor · Schema
SegmentationDescriptor
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.
BroadcastingMedia ProcessingMedia
Properties
| Name | Type | Description |
|---|---|---|
| SegmentNum | object | |
| SegmentationEventId | object | |
| SegmentationTypeId | object | |
| SegmentationUpid | object | |
| SegmentationUpidType | object | |
| SegmentsExpected | object | |
| SubSegmentNum | object | |
| SubSegmentsExpected | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/amazon-mediatailor/refs/heads/main/json-schema/mediatailor-api-segmentation-descriptor-schema.json",
"title": "SegmentationDescriptor",
"description": "<p>The <code>segmentation_descriptor</code> 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 <code>EXT-X-DATERANGE</code> or <code>EventStream</code> ad marker's SCTE-35 data.</p> <p> <code>segmentation_descriptor</code> messages must be sent with the <code>time_signal</code> message type.</p> <p>See the <code>segmentation_descriptor()</code> table of the 2022 SCTE-35 specification for more information.</p>",
"type": "object",
"properties": {
"SegmentNum": {
"allOf": [
{
"$ref": "#/components/schemas/Integer"
},
{
"description": "The segment number to assign to the <code>segmentation_descriptor.segment_num</code> 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 <code>segmentation_descriptor.segmentation_event_id</code> 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 <code>segmentation_descriptor.segmentation_type_id</code> 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 <code>segmentation_descriptor.segmentation_upid</code> 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 <code>segmentation_descriptor.segmentation_upid_type</code> 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 <code>segmentation_descriptor.segments_expectedS</code> 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 <code>segmentation_descriptor.sub_segment_num</code> 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 <code>segmentation_descriptor.sub_segments_expected</code> 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."
}
]
}
}
}