[ aws . mediapackagev2 ]
create-origin-endpoint
Описание
Точка входа присоединена к каналу и представляет выходной поток живого контента. Вы можете ассоциировать несколько точек входа с одним каналом. Каждая точка входа предоставляет игрокам и внешним CDN (таким как Amazon CloudFront) доступ к контенту для воспроизведения. Контент не может быть передан с канала, пока у него нет точки входа. Вы можете создать только одну точку входа с каждым запросом.
См. также: Документация API AWS
Синтаксис
create-origin-endpoint
--channel-group-name <value>
--channel-name <value>
--origin-endpoint-name <value>
--container-type <value>
[--segment <value>]
[--client-token <value>]
[--description <value>]
[--startover-window-seconds <value>]
[--hls-manifests <value>]
[--low-latency-hls-manifests <value>]
[--dash-manifests <value>]
[--force-endpoint-error-configuration <value>]
[--tags <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--channel-group-name (строка)
--channel-name (строка)
--origin-endpoint-name (строка)
--container-type (строка)
Тип контейнера для подключения к этой точке входа. Тип контейнера — это формат файла, который объединяет один или несколько потоков медиа, таких как аудио и видео, в один файл. Вы не можете изменить тип контейнера после создания точки входа.
Возможные значения:
TSCMAF
--segment (структура)
Настройка сегмента, включая имя сегмента, длительность и другие значения настроек.
SegmentDurationSeconds -> (целое число)
SegmentName -> (строка)
TsUseAudioRenditionGroup -> (булево)
IncludeIframeOnlyStreams -> (булево)
TsIncludeDvbSubtitles -> (булево)
Scte -> (структура)
Настройки конфигурации SCTE в настройках сегмента.
ScteFilter -> (список)
Типы сообщений SCTE-35, которые вы хотите рассматривать как метки рекламы в выводе.
(строка)
Encryption -> (структура)
Параметры для шифрования контента.
ConstantInitializationVector -> (строка)
EncryptionMethod -> (структура)
Используемый метод шифрования.
TsEncryptionMethod -> (строка)
CmafEncryptionMethod -> (строка)
KeyRotationIntervalSeconds -> (целое число)
Частота (в секундах) изменения ключей для живых рабочих процессов, в которых контент передается в реальном времени. Сервис получает ключи контента до начала потоковой передачи живого контента и затем получает их по мере необходимости на протяжении всего жизненного цикла рабочего процесса. По умолчанию вращение ключей установлено на 300 секунд (5 минут), минимальный интервал вращения, что эквивалентно установке его на 300. Если вы не вводите интервал, ключи контента не вращаются.
Следующее примерное значение заставляет сервис вращать ключи каждые тридцать минут: 1800
SpekeKeyProvider -> (структура)
Параметры для поставщика ключей SPEKE.
EncryptionContractConfiguration -> (структура)
Настройте один или несколько ключей шифрования контента для ваших точек входа, использующих SPEKE Версию 2.0. Договор о шифровании определяет, какие ключи контента используются для шифрования аудио- и видеодорожек в вашем потоке. Для настройки договора о шифровании укажите, какие предустановки шифрования аудио и видео использовать.
PresetSpeke20Audio -> (строка)
Набор предустановок аудиошифрования.
Описание значения:
- PRESET-AUDIO-1 - Используйте один ключ контента для шифрования всех аудиодорожек в вашем потоке.
- PRESET-AUDIO-2 - Используйте один ключ контента для шифрования всех стерео аудиодорожек и один ключ контента для шифрования всех многоканальных аудиодорожек.
- PRESET-AUDIO-3 - Используйте один ключ контента для шифрования всех стерео аудиодорожек, один ключ контента для шифрования всех многоканальных аудиодорожек с 3 до 6 каналов и один ключ контента для шифрования всех многоканальных аудиодорожек с более чем 6 каналами.
- SHARED - Используйте один и тот же ключ контента для всех аудио- и видеодорожек в вашем потоке.
- UNENCRYPTED - Не шифруйте аудиодорожки в вашем потоке.
PresetSpeke20Video -> (строка)
Набор предустановок видеошифрования.
Описание значения:
- PRESET-VIDEO-1 - Используйте один ключ контента для шифрования всех видеодорожек в вашем потоке.
- PRESET-VIDEO-2 - Используйте один ключ контента для шифрования всех видеодорожек SD и один ключ контента для всех видеодорожек HD и выше.
- PRESET-VIDEO-3 - Используйте один ключ контента для шифрования всех видеодорожек SD, один ключ контента для видеодорожек HD и один ключ контента для всех видеодорожек UHD.
- PRESET-VIDEO-4 - Используйте один ключ контента для шифрования всех видеодорожек SD, один ключ контента для видеодорожек HD, один ключ контента для всех видеодорожек UHD1 и один ключ контента для всех видеодорожек UHD2.
- PRESET-VIDEO-5 - Используйте один ключ контента для шифрования всех видеодорожек SD, один ключ контента для видеодорожек HD1, один ключ контента для видеодорожек HD2, один ключ контента для всех видеодорожек UHD1 и один ключ контента для всех видеодорожек UHD2.
- PRESET-VIDEO-6 - Используйте один ключ контента для шифрования всех видеодорожек SD, один ключ контента для видеодорожек HD1, один ключ контента для видеодорожек HD2 и один ключ контента для всех видеодорожек UHD.
- PRESET-VIDEO-7 - Используйте один ключ контента для шифрования всех видеодорожек SD+HD1, один ключ контента для видеодорожек HD2 и один ключ контента для всех видеодорожек UHD.
- PRESET-VIDEO-8 - Используйте один ключ контента для шифрования всех видеодорожек SD+HD1, один ключ контента для видеодорожек HD2, один ключ контента для всех видеодорожек UHD1 и один ключ контента для всех видеодорожек UHD2.
- SHARED - Используйте один и тот же ключ контента для всех видео- и аудиодорожек в вашем потоке.
- UNENCRYPTED - Не шифруйте видеодорожки в вашем потоке.
ResourceId -> (строка)
Уникальный идентификатор контента. Сервис отправляет это в сервер ключей для идентификации текущей точки входа. Насколько уникальным вы сделаете его, зависит от того, насколько точными вы хотите сделать контрольные списки доступа. Сервис не допускает использование одного и того же идентификатора для двух одновременных процессов шифрования. Идентификатор ресурса также известен как идентификатор контента.
Следующий пример показывает идентификатор ресурса: MovieNight20171126093045
DrmSystems -> (список)
Поставщик решений DRM, который вы используете для защиты контента во время распределения.
(строка)
RoleArn -> (строка)
ARN для роли IAM, предоставленной поставщиком ключей, предоставляющей доступ к API поставщика ключей. Эта роль должна иметь политику доверия, которая позволяет MediaPackage принимать роль, и она должна иметь достаточную политику разрешений для доступа к конкретной URL-адресу получения ключа. Получите это у вашего поставщика решений DRM.
Формат: arn:aws:iam::{accountID}:role/{name} . Следующий пример показывает ARN роли: arn:aws:iam::444455556666:role/SpekeAccess
Url -> (строка)
URL-адрес прокси-сервера API Gateway, который вы настроили для общения с сервером ключей. Прокси-сервер API Gateway должен находиться в том же регионе AWS, что и MediaPackage, и должен начинаться с https://.
Следующий пример показывает URL-адрес: https://1wm2dx1f33.execute-api.us-west-2.amazonaws.com/SpekeSample/copyProtection
Синтаксис JSON:
{
"SegmentDurationSeconds": integer,
"SegmentName": "string",
"TsUseAudioRenditionGroup": true|false,
"IncludeIframeOnlyStreams": true|false,
"TsIncludeDvbSubtitles": true|false,
"Scte": {
"ScteFilter": ["SPLICE_INSERT"|"BREAK"|"PROVIDER_ADVERTISEMENT"|"DISTRIBUTOR_ADVERTISEMENT"|"PROVIDER_PLACEMENT_OPPORTUNITY"|"DISTRIBUTOR_PLACEMENT_OPPORTUNITY"|"PROVIDER_OVERLAY_PLACEMENT_OPPORTUNITY"|"DISTRIBUTOR_OVERLAY_PLACEMENT_OPPORTUNITY"|"PROGRAM", ...]
},
"Encryption": {
"ConstantInitializationVector": "string",
"EncryptionMethod": {
"TsEncryptionMethod": "AES_128"|"SAMPLE_AES",
"CmafEncryptionMethod": "CENC"|"CBCS"
},
"KeyRotationIntervalSeconds": integer,
"SpekeKeyProvider": {
"EncryptionContractConfiguration": {
"PresetSpeke20Audio": "PRESET_AUDIO_1"|"PRESET_AUDIO_2"|"PRESET_AUDIO_3"|"SHARED"|"UNENCRYPTED",
"PresetSpeke20Video": "PRESET_VIDEO_1"|"PRESET_VIDEO_2"|"PRESET_VIDEO_3"|"PRESET_VIDEO_4"|"PRESET_VIDEO_5"|"PRESET_VIDEO_6"|"PRESET_VIDEO_7"|"PRESET_VIDEO_8"|"SHARED"|"UNENCRYPTED"
},
"ResourceId": "string",
"DrmSystems": ["CLEAR_KEY_AES_128"|"FAIRPLAY"|"PLAYREADY"|"WIDEVINE"|"IRDETO", ...],
"RoleArn": "string",
"Url": "string"
}
}
}
--client-token (строка)
--description (целое число)
--hls-manifests (список)
Настройка манифеста потокового воспроизведения HTTP (HLS).
(структура)
Создайте конфигурацию манифеста потокового воспроизведения HTTP (HLS).
ManifestName -> (строка)
ChildManifestName -> (строка)
ScteHls -> (структура)
Настройка SCTE.
AdMarkerHls -> (строка)
Маркеры рекламы указывают, когда должна быть вставлена реклама во время воспроизведения. Если вы включаете маркеры рекламы в поток контента в своих потоковых энкодерах, вам необходимо указать MediaPackage, что делать с маркерами рекламы в выводе. Выберите, что вы хотите, чтобы MediaPackage сделал с маркерами рекламы.
Описание значений:
- DATERANGE - Вставить теги EXT-X-DATERANGE для сигнализации о событиях рекламы и перехода программы в манифестах TS и CMAF. Если вы используете DATERANGE, вы должны установить значение programDateTimeIntervalSeconds равным 1 или выше. Чтобы узнать больше о DATERANGE, см. SCTE-35 Ad Marker EXT-X-DATERANGE.
StartTag -> (структура)
Чтобы вставить тег EXT-X-START в ваш плейлист HLS, укажите объект конфигурации StartTag с допустимым значением TimeOffset. При этом вы также можете необязательно указать, нужно ли включать значение PRECISE в тег EXT-X-START.
TimeOffset -> (число с плавающей точкой)
Precise -> (булево)
ManifestWindowSeconds -> (целое число)
ProgramDateTimeIntervalSeconds -> (целое число)
Вставляет теги EXT-X-PROGRAM-DATE-TIME в выходной манифест с указанным интервалом. Если вы не введете интервал, теги EXT-X-PROGRAM-DATE-TIME не будут включены в манифест. Эти теги синхронизируют поток с реальным временем, чтобы зрители могли перейти к определенному моменту во временной шкале воспроизведения на плеере.
Независимо от этого параметра, если в входном HLS есть какие-либо данные ID3Timed, они передаются в выходной HLS.
FilterConfiguration -> (структура)
Настройка фильтра включает параметры для фильтрации манифеста, начального и конечного времени и задержки времени, которые применяются ко всем вашим запросам к этому манифесту.
ManifestFilter -> (строка)
Start -> (метка времени)
End -> (метка времени)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (метка времени)
UrlEncodeChildManifest -> (булево)
Краткий синтаксис:
ManifestName=string,ChildManifestName=string,ScteHls={AdMarkerHls=string},StartTag={TimeOffset=float,Precise=boolean},ManifestWindowSeconds=integer,ProgramDateTimeIntervalSeconds=integer,FilterConfiguration={ManifestFilter=string,Start=timestamp,End=timestamp,TimeDelaySeconds=integer,ClipStartTime=timestamp},UrlEncodeChildManifest=boolean ...
Синтаксис JSON:
[
{
"ManifestName": "string",
"ChildManifestName": "string",
"ScteHls": {
"AdMarkerHls": "DATERANGE"
},
"StartTag": {
"TimeOffset": float,
"Precise": true|false
},
"ManifestWindowSeconds": integer,
"ProgramDateTimeIntervalSeconds": integer,
"FilterConfiguration": {
"ManifestFilter": "string",
"Start": timestamp,
"End": timestamp,
"TimeDelaySeconds": integer,
"ClipStartTime": timestamp
},
"UrlEncodeChildManifest": true|false
}
...
]
--low-latency-hls-manifests (список)
Конфигурация манифеста HLS с низкой задержкой.
(структура)
Создайте конфигурацию манифеста потокового воспроизведения HTTP (HLS) с низкой задержкой.
ManifestName -> (строка)
ChildManifestName -> (строка)
ScteHls -> (структура)
Настройка SCTE.
AdMarkerHls -> (строка)
Маркеры рекламы указывают, когда должна быть вставлена реклама во время воспроизведения. Если вы включаете маркеры рекламы в поток контента в своих потоковых энкодерах, вам необходимо указать MediaPackage, что делать с маркерами рекламы в выводе. Выберите, что вы хотите, чтобы MediaPackage сделал с маркерами рекламы.
Описание значений:
- DATERANGE - Вставить теги EXT-X-DATERANGE для сигнализации о событиях рекламы и перехода программы в манифестах TS и CMAF. Если вы используете DATERANGE, вы должны установить значение programDateTimeIntervalSeconds равным 1 или выше. Чтобы узнать больше о DATERANGE, см. SCTE-35 Ad Marker EXT-X-DATERANGE.
StartTag -> (структура)
Чтобы вставить тег EXT-X-START в ваш плейлист HLS, укажите объект конфигурации StartTag с допустимым значением TimeOffset. При этом вы также можете необязательно указать, нужно ли включать значение PRECISE в тег EXT-X-START.
TimeOffset -> (число с плавающей точкой)
Precise -> (булево)
ManifestWindowSeconds -> (целое число)
ProgramDateTimeIntervalSeconds -> (целое число)
Вставляет теги EXT-X-PROGRAM-DATE-TIME в выходной манифест с указанным интервалом. Если вы не введете интервал, теги EXT-X-PROGRAM-DATE-TIME не будут включены в манифест. Эти теги синхронизируют поток с реальным временем, чтобы зрители могли перейти к определенному моменту во временной шкале воспроизведения на плеере.
Независимо от этого параметра, если в входном HLS есть какие-либо данные ID3Timed, они передаются в выходной HLS.
FilterConfiguration -> (структура)
Настройка фильтра включает параметры для фильтрации манифеста, начального и конечного времени и задержки времени, которые применяются ко всем вашим запросам к этому манифесту.
ManifestFilter -> (строка)
Start -> (метка времени)
End -> (метка времени)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (метка времени)
UrlEncodeChildManifest -> (булево)
Краткий синтаксис:
ManifestName=string,ChildManifestName=string,ScteHls={AdMarkerHls=string},StartTag={TimeOffset=float,Precise=boolean},ManifestWindowSeconds=integer,ProgramDateTimeIntervalSeconds=integer,FilterConfiguration={ManifestFilter=string,Start=timestamp,End=timestamp,TimeDelaySeconds=integer,ClipStartTime=timestamp},UrlEncodeChildManifest=boolean ...
Синтаксис JSON:
[
{
"ManifestName": "string",
"ChildManifestName": "string",
"ScteHls": {
"AdMarkerHls": "DATERANGE"
},
"StartTag": {
"TimeOffset": float,
"Precise": true|false
},
"ManifestWindowSeconds": integer,
"ProgramDateTimeIntervalSeconds": integer,
"FilterConfiguration": {
"ManifestFilter": "string",
"Start": timestamp,
"End": timestamp,
"TimeDelaySeconds": integer,
"ClipStartTime": timestamp
},
"UrlEncodeChildManifest": true|false
}
...
]
--dash-manifests (список)
Конфигурация манифеста DASH.
(структура)
Создать конфигурацию манифеста DASH.
ManifestName -> (строка)
ManifestWindowSeconds -> (целое число)
FilterConfiguration -> (структура)
Конфигурация фильтра включает параметры для фильтрации манифеста, начального и конечного времени и задержки времени, которые применяются ко всем вашим запросам к выходу для этого манифеста.
ManifestFilter -> (строка)
Start -> (отметка времени)
End -> (отметка времени)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (отметка времени)
MinUpdatePeriodSeconds -> (целое число)
MinBufferTimeSeconds -> (целое число)
SuggestedPresentationDelaySeconds -> (целое число)
SegmentTemplateFormat -> (строка)
Определяет тип переменной, используемой в URL media тега SegmentTemplate в манифесте. Также указывает, включена ли информация о временной шкале сегмента в SegmentTimeline или SegmentTemplate .
Описание значения:
-
NUMBER_WITH_TIMELINE- Переменная$Number$используется в URLmedia. Значение этой переменной - порядковый номер сегмента. Полный объектSegmentTimelineпредставлен в каждом элементеSegmentTemplate.
PeriodTriggers -> (список)
Список триггеров, управляющих тем, когда AWS Elemental MediaPackage разделяет манифест MPEG-DASH на несколько периодов. Тип ADS указывает, что AWS Elemental MediaPackage должен создавать периоды в выходном манифесте, соответствующие маркерам рекламы SCTE-35 в исходном источнике. Оставьте это значение пустым, чтобы указать, что манифест содержится в одном периоде. Дополнительную информацию о периодах в манифесте DASH см. в разделе Многопериодический DASH в AWS Elemental MediaPackage .
(строка)
ScteDash -> (структура)
Настройка SCTE.
AdMarkerDash -> (строка)
Выберите, как маркеры рекламы включаются в упакованное содержимое. Если вы включаете маркеры рекламы в поток содержимого в своих верхних кодерах, вам необходимо сообщить MediaPackage, что делать с маркерами рекламы в выходе.
Описание значения:
-
Binary- Маркер SCTE-35 выражается как шестнадцатеричная строка (строка Base64), а не полным XML. -
XML- Маркер SCTE выражен полностью в XML.
DrmSignaling -> (строка)
UtcTiming -> (структура)
Определяет тип отметки времени UTC, включенной в описание представления медиа DASH (MPD).
TimingMode -> (строка)
TimingSource -> (строка)
Profiles -> (список)
Профиль, с которым совместим выход.
(строка)
BaseUrls -> (список)
Базовые URL-адреса для получения сегментов.
(структура)
Базовые URL-адреса для получения сегментов. Вы можете указать несколько расположений и указать приоритет и вес для использования каждого из них, для использования в многоканальных рабочих процессах.
Url -> (строка)
ServiceLocation -> (строка)
DvbPriority -> (целое число)
DvbWeight -> (целое число)
ProgramInformation -> (структура)
Подробности о содержимом, которое вы хотите, чтобы MediaPackage передавал в манифест устройству воспроизведения.
Title -> (строка)
Source -> (строка)
Copyright -> (строка)
LanguageCode -> (строка)
MoreInformationUrl -> (строка)
DvbSettings -> (структура)
Только для конечных точек, использующих профиль DVB-DASH. Информация о загрузке шрифтов и сообщениях об ошибках, которую вы хотите, чтобы MediaPackage передавал в манифест.
FontDownload -> (структура)
Настройки шрифтов субтитров.
Url -> (строка)
MimeType -> (строка)
mimeType ресурса, который находится по URL загрузки шрифтов.
Дополнительную информацию о типах MIME шрифтов см. в документе MPEG-DASH Profile for Transport of ISO BMFF Based DVB Services over IP Based Networks.
FontFamily -> (строка)
fontFamily для субтитров, как описано в формате распространения субтитров EBU-TT-D.ErrorMetrics -> (список)
Настройки отчетов об ошибках устройства воспроизведения.
(структура)
Только для профилей DVB-DASH. Настройки отчетов об ошибках от устройства воспроизведения, которые вы хотите, чтобы Elemental MediaPackage передавал в манифест.
ReportingUrl -> (строка)
Probability -> (целое число)
Compactness -> (строка)
Макет манифеста DASH, который производит MediaPackage. STANDARD указывает на стандартный манифест, который сжат. NONE указывает на полный манифест.
Дополнительную информацию о компактности см. в руководстве пользователя AWS Elemental MediaPackage v2 в разделе Компактность манифеста DASH.
SubtitleConfiguration -> (структура)
Конфигурация субтитров DASH.
TtmlConfiguration -> (структура)
Настройки субтитров TTML.
TtmlProfile -> (строка)
IMSC - это профиль по умолчанию. EBU-TT-D создает субтитры, совместимые с профилем TTML EBU-TT-D. MediaPackage передает стили субтитров в манифест. Дополнительную информацию о субтитрах EBU-TT-D см. в формате распространения субтитров EBU-TT-D.Синтаксис JSON:
[
{
"ManifestName": "string",
"ManifestWindowSeconds": integer,
"FilterConfiguration": {
"ManifestFilter": "string",
"Start": timestamp,
"End": timestamp,
"TimeDelaySeconds": integer,
"ClipStartTime": timestamp
},
"MinUpdatePeriodSeconds": integer,
"MinBufferTimeSeconds": integer,
"SuggestedPresentationDelaySeconds": integer,
"SegmentTemplateFormat": "NUMBER_WITH_TIMELINE",
"PeriodTriggers": ["AVAILS"|"DRM_KEY_ROTATION"|"SOURCE_CHANGES"|"SOURCE_DISRUPTIONS"|"NONE", ...],
"ScteDash": {
"AdMarkerDash": "BINARY"|"XML"
},
"DrmSignaling": "INDIVIDUAL"|"REFERENCED",
"UtcTiming": {
"TimingMode": "HTTP_HEAD"|"HTTP_ISO"|"HTTP_XSDATE"|"UTC_DIRECT",
"TimingSource": "string"
},
"Profiles": ["DVB_DASH", ...],
"BaseUrls": [
{
"Url": "string",
"ServiceLocation": "string",
"DvbPriority": integer,
"DvbWeight": integer
}
...
],
"ProgramInformation": {
"Title": "string",
"Source": "string",
"Copyright": "string",
"LanguageCode": "string",
"MoreInformationUrl": "string"
},
"DvbSettings": {
"FontDownload": {
"Url": "string",
"MimeType": "string",
"FontFamily": "string"
},
"ErrorMetrics": [
{
"ReportingUrl": "string",
"Probability": integer
}
...
]
},
"Compactness": "STANDARD"|"NONE",
"SubtitleConfiguration": {
"TtmlConfiguration": {
"TtmlProfile": "IMSC_1"|"EBU_TT_D_101"
}
}
}
...
]
--force-endpoint-error-configuration (структура)
Настройки отключения для конечной точки.
EndpointErrorConditions -> (список)
Условия отключения для конечной точки. Варианты:
-
STALE_MANIFEST- Манифест приостановлен, и новых сегментов или частей нет. -
INCOMPLETE_MANIFEST- Есть разрыв в манифесте. -
MISSING_DRM_KEY- Включен поворот ключей, но мы не можем получить ключ для текущего периода ключей. -
SLATE_INPUT- Сегменты, содержащие содержимое заставки, считаются отсутствующим контентом.
(строка)
Краткий синтаксис:
EndpointErrorConditions=string,string
Синтаксис JSON:
{
"EndpointErrorConditions": ["STALE_MANIFEST"|"INCOMPLETE_MANIFEST"|"MISSING_DRM_KEY"|"SLATE_INPUT", ...]
}
--tags (карта)
Список значений ключей и значений тегов, разделенных запятыми, которые вы определяете. Например:
"Key1": "Value1",
"Key2": "Value2"
ключ -> (строка)
значение -> (строка)
Краткий синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "string"
...}
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному в --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределяют значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-каркас в стандартный вывод без отправки запроса к API. Если не предоставлено значение или значение input, выводится пример JSON ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, будет напечатан пример ввода YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Общие параметры
--debug (boolean)
Включить отладочную запись в журнал.
--endpoint-url (string)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию по проверке SSL-сертификатов.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла аутентификации.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Данные аутентификации не будут загружены, если этот аргумент предоставлен.
--ca-bundle (string)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для бинарных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что бинарные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и бинарные значения должны передаваться буквально. При предоставлении содержимого из файла, которое отображается как бинарный блок fileb:// всегда будет обрабатываться как бинарный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматический запрос параметров ввода CLI.
Вывод
Arn -> (строка)
ChannelGroupName -> (строка)
ChannelName -> (строка)
OriginEndpointName -> (строка)
ContainerType -> (строка)
Segment -> (структура)
Настройка сегмента, включая имя сегмента, продолжительность и другие значения настроек.
SegmentDurationSeconds -> (целое число)
SegmentName -> (строка)
TsUseAudioRenditionGroup -> (булево)
IncludeIframeOnlyStreams -> (булево)
TsIncludeDvbSubtitles -> (булево)
Scte -> (структура)
Настройки конфигурации SCTE в настройках сегмента.
ScteFilter -> (список)
Типы сообщений SCTE-35, которые вы хотите обрабатывать как метки рекламы в выводе.
(строка)
Encryption -> (структура)
Параметры шифрования содержимого.
ConstantInitializationVector -> (строка)
EncryptionMethod -> (структура)
Способ шифрования, который следует использовать.
TsEncryptionMethod -> (строка)
CmafEncryptionMethod -> (строка)
KeyRotationIntervalSeconds -> (целое число)
Частота (в секундах) изменения ключей для потоковых рабочих процессов в реальном времени, в которых контент передаётся в реальном времени. Сервис получает ключи контента до начала потоковой передачи живого контента, а затем получает их по мере необходимости на протяжении всего жизненного цикла рабочего процесса. По умолчанию вращение ключей установлено в 300 секунд (5 минут), минимальный интервал вращения, что эквивалентно установке его в 300. Если вы не введёте интервал, ключи контента не будут вращаться.
Следующее примерное значение заставляет сервис вращать ключи каждые тридцать минут: 1800
SpekeKeyProvider -> (структура)
Параметры поставщика ключей SPEKE.
EncryptionContractConfiguration -> (структура)
Настройте один или несколько ключей шифрования контента для ваших конечных точек, использующих SPEKE Version 2.0. Договор шифрования определяет, какие ключи контента используются для шифрования аудио- и видеодорожек в вашем потоке. Для настройки договора шифрования укажите, какие пресеты шифрования аудио и видео следует использовать.
PresetSpeke20Audio -> (строка)
Коллекция пресетов шифрования аудио.
Описание значений:
- PRESET-AUDIO-1 - Используйте один ключ контента для шифрования всех аудиодорожек в вашем потоке.
- PRESET-AUDIO-2 - Используйте один ключ контента для шифрования всех стерео аудиодорожек и один ключ контента для шифрования всех многоканальных аудиодорожек.
- PRESET-AUDIO-3 - Используйте один ключ контента для шифрования всех стерео аудиодорожек, один ключ контента для шифрования всех многоканальных аудиодорожек с 3 по 6 каналами и один ключ контента для шифрования всех многоканальных аудиодорожек с более чем 6 каналами.
- SHARED - Используйте один и тот же ключ контента для всех аудио- и видеодорожек в вашем потоке.
- UNENCRYPTED - Не шифруйте ни одну из аудиодорожек в вашем потоке.
PresetSpeke20Video -> (строка)
Коллекция пресетов шифрования видео.
Описание значений:
- PRESET-VIDEO-1 - Используйте один ключ контента для шифрования всех видеодорожек в вашем потоке.
- PRESET-VIDEO-2 - Используйте один ключ контента для шифрования всех видеодорожек SD и один ключ для всех видеодорожек HD и выше.
- PRESET-VIDEO-3 - Используйте один ключ контента для шифрования всех видеодорожек SD, один ключ для видеодорожек HD и один ключ для всех видеодорожек UHD.
- PRESET-VIDEO-4 - Используйте один ключ контента для шифрования всех видеодорожек SD, один ключ для видеодорожек HD, один ключ для всех видеодорожек UHD1 и один ключ для всех видеодорожек UHD2.
- PRESET-VIDEO-5 - Используйте один ключ контента для шифрования всех видеодорожек SD, один ключ для видеодорожек HD1, один ключ для видеодорожек HD2, один ключ для всех видеодорожек UHD1 и один ключ для всех видеодорожек UHD2.
- PRESET-VIDEO-6 - Используйте один ключ контента для шифрования всех видеодорожек SD, один ключ для видеодорожек HD1, один ключ для видеодорожек HD2 и один ключ для всех видеодорожек UHD.
- PRESET-VIDEO-7 - Используйте один ключ контента для шифрования всех видеодорожек SD+HD1, один ключ для видеодорожек HD2 и один ключ для всех видеодорожек UHD.
- PRESET-VIDEO-8 - Используйте один ключ контента для шифрования всех видеодорожек SD+HD1, один ключ для видеодорожек HD2, один ключ для всех видеодорожек UHD1 и один ключ для всех видеодорожек UHD2.
- SHARED - Используйте один и тот же ключ контента для всех видео- и аудиодорожек в вашем потоке.
- UNENCRYPTED - Не шифруйте ни одну из видеодорожек в вашем потоке.
ResourceId -> (строка)
Уникальный идентификатор содержимого. Сервис отправляет его на сервер ключей для идентификации текущей конечной точки. Насколько уникальным вы сделаете этот идентификатор зависит от того, насколько детальным вы хотите сделать контроль доступа. Сервис не позволяет вам использовать один и тот же идентификатор для двух одновременных процессов шифрования. Идентификатор ресурса также известен как идентификатор контента.
Следующий пример показывает идентификатор ресурса: MovieNight20171126093045
DrmSystems -> (список)
Поставщик решений DRM, который вы используете для защиты своего контента во время распространения.
(строка)
RoleArn -> (строка)
ARN для роли IAM, предоставленной поставщиком ключей, которая предоставляет доступ к API поставщика ключей. Эта роль должна иметь политику доверия, которая позволяет MediaPackage принять роль, и она должна иметь достаточную политику разрешений для доступа к конкретному URL-адресу получения ключей. Получите её у вашего поставщика решений DRM.
Допустимый формат: arn:aws:iam::{accountID}:role/{name}. Следующий пример показывает ARN роли: arn:aws:iam::444455556666:role/SpekeAccess
Url -> (строка)
URL прокси-сервера API Gateway, который вы настроили для связи с сервером ключей. Прокси-сервер API Gateway должен находиться в том же AWS-регионе, что и MediaPackage, и должен начинаться с https://.
Следующий пример показывает URL: https://1wm2dx1f33.execute-api.us-west-2.amazonaws.com/SpekeSample/copyProtection
CreatedAt -> (метка времени)
ModifiedAt -> (метка времени)
Description -> (строка)
StartoverWindowSeconds -> (целое число)
HlsManifests -> (список)
Конфигурация манифеста потоковой передачи (HLS) по протоколу HTTP.
(структура)
Получение конфигурации манифеста потоковой передачи (HLS) по протоколу HTTP.
ManifestName -> (строка)
Url -> (строка)
ChildManifestName -> (строка)
ManifestWindowSeconds -> (целое число)
ProgramDateTimeIntervalSeconds -> (целое число)
Вставляет теги EXT-X-PROGRAM-DATE-TIME в выходной манифест с указанным интервалом. Если вы не укажете интервал, теги EXT-X-PROGRAM-DATE-TIME не будут включены в манифест. Эти теги синхронизируют поток со временем, чтобы зрители могли перейти к определенному моменту во временной шкале воспроизведения на плеере.
Независимо от этого параметра, если в входном HLS содержится любой метаданные ID3Timed, они передаются в выходной HLS.
ScteHls -> (структура)
Конфигурация SCTE.
AdMarkerHls -> (строка)
Маркеры рекламы указывают, когда должна быть вставлена реклама во время воспроизведения. Если вы включаете маркеры рекламы в поток контента в своих upstream-кодерах, вам необходимо указать MediaPackage, что делать с маркерами рекламы в выходе. Выберите, что вы хотите, чтобы MediaPackage делал с маркерами рекламы.
Описание значения:
- DATERANGE - Вставить теги EXT-X-DATERANGE для обозначения событий перехода рекламы и программы в манифестах TS и CMAF. Если вы используете DATERANGE, вы должны установить значение programDateTimeIntervalSeconds равным 1 или выше. Дополнительную информацию о DATERANGE см. в разделе SCTE-35 Маркер рекламы EXT-X-DATERANGE.
FilterConfiguration -> (структура)
Конфигурация фильтра включает параметры для фильтрации манифеста, начального и конечного времени и задержки времени, которые применяются ко всем вашим запросам вывода для этого манифеста.
ManifestFilter -> (строка)
Start -> (временная метка)
End -> (временная метка)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (временная метка)
StartTag -> (структура)
Чтобы вставить тег EXT-X-START в ваш плейлист HLS, укажите объект конфигурации StartTag со значением TimeOffset. При этом можно также необязательно указать, следует ли включать значение PRECISE в теге EXT-X-START.
TimeOffset -> (число с плавающей запятой)
Precise -> (булево)
UrlEncodeChildManifest -> (булево)
LowLatencyHlsManifests -> (список)
Конфигурация манифеста низкой задержки HLS.
(структура)
Получение конфигурации манифеста низкой задержки потоковой передачи (HLS) по протоколу HTTP.
ManifestName -> (строка)
Url -> (строка)
ChildManifestName -> (строка)
ManifestWindowSeconds -> (целое число)
ProgramDateTimeIntervalSeconds -> (целое число)
Вставляет теги EXT-X-PROGRAM-DATE-TIME в выходной манифест с указанным интервалом. Если вы не укажете интервал, теги EXT-X-PROGRAM-DATE-TIME не будут включены в манифест. Эти теги синхронизируют поток со временем, чтобы зрители могли перейти к определенному моменту во временной шкале воспроизведения на плеере.
Независимо от этого параметра, если в входном HLS содержится любой метаданные ID3Timed, они передаются в выходной HLS.
ScteHls -> (структура)
Конфигурация SCTE.
AdMarkerHls -> (строка)
Маркеры рекламы указывают, когда должна быть вставлена реклама во время воспроизведения. Если вы включаете маркеры рекламы в поток контента в своих upstream-кодерах, вам необходимо указать MediaPackage, что делать с маркерами рекламы в выходе. Выберите, что вы хотите, чтобы MediaPackage делал с маркерами рекламы.
Описание значения:
- DATERANGE - Вставить теги EXT-X-DATERANGE для обозначения событий перехода рекламы и программы в манифестах TS и CMAF. Если вы используете DATERANGE, вы должны установить значение programDateTimeIntervalSeconds равным 1 или выше. Дополнительную информацию о DATERANGE см. в разделе SCTE-35 Маркер рекламы EXT-X-DATERANGE.
FilterConfiguration -> (структура)
Конфигурация фильтра включает параметры для фильтрации манифеста, начального и конечного времени и задержки времени, которые применяются ко всем вашим запросам вывода для этого манифеста.
ManifestFilter -> (строка)
Start -> (временная метка)
End -> (временная метка)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (временная метка)
StartTag -> (структура)
Чтобы вставить тег EXT-X-START в ваш плейлист HLS, укажите объект конфигурации StartTag со значением TimeOffset. При этом можно также необязательно указать, следует ли включать значение PRECISE в теге EXT-X-START.
TimeOffset -> (число с плавающей запятой)
Precise -> (булево)
UrlEncodeChildManifest -> (булево)
DashManifests -> (список)
Конфигурация манифеста DASH.
(структура)
Получение конфигурации манифеста DASH.
ManifestName -> (строка)
Url -> (строка)
ManifestWindowSeconds -> (целое число)
FilterConfiguration -> (структура)
Конфигурация фильтра включает параметры для фильтрации манифеста, начального и конечного времени, и задержки времени, которые применяются ко всем вашим запросам egress для этого манифеста.
ManifestFilter -> (строка)
Start -> (отметка времени)
End -> (отметка времени)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (отметка времени)
MinUpdatePeriodSeconds -> (целое число)
MinBufferTimeSeconds -> (целое число)
SuggestedPresentationDelaySeconds -> (целое число)
SegmentTemplateFormat -> (строка)
Определяет тип переменной, используемой в URL media тега SegmentTemplate в манифесте. Также указывает, включена ли информация о временной шкале сегментов в SegmentTimeline или SegmentTemplate.
Описание значения:
-
NUMBER_WITH_TIMELINE- Переменная$Number$используется в URLmedia. Значение этой переменной — порядковый номер сегмента. Полный объектSegmentTimelineпредставлен в каждом элементеSegmentTemplate.
PeriodTriggers -> (список)
Список триггеров, управляющих тем, когда AWS Elemental MediaPackage разделяет манифест MPEG-DASH на несколько периодов. Оставьте это значение пустым, чтобы указать, что весь манифест находится в одном периоде. Для получения дополнительной информации о периодах в манифесте DASH см. Multi-period DASH в AWS Elemental MediaPackage.
(строка)
ScteDash -> (структура)
Конфигурация SCTE.
AdMarkerDash -> (строка)
Выберите, как встраивать метки рекламы в упакованное содержимое. Если вы включаете метки рекламы в поток содержимого в своих потоковых энкодерах, вам необходимо сообщить MediaPackage, что делать с метками рекламы на выходе.
Описание значения:
-
Binary- Метка SCTE-35 выражается как шестнадцатеричная строка (строка Base64) вместо полного XML. -
XML- Метка SCTE выражается полностью в XML.
DrmSignaling -> (строка)
UtcTiming -> (структура)
Определяет тип UTC-времени, включенного в описание представления DASH-медиа (MPD).
TimingMode -> (строка)
TimingSource -> (строка)
Profiles -> (список)
Профиль, с которым соответствует выходной сигнал.
(строка)
BaseUrls -> (список)
Базовый URL для получения сегментов.
(структура)
Базовые URL-адреса для получения сегментов. Вы можете указать несколько расположений и указать приоритет и вес для использования каждого из них для использования в многоканальных рабочих процессах CDN.
Url -> (строка)
ServiceLocation -> (строка)
DvbPriority -> (целое число)
DvbWeight -> (целое число)
ProgramInformation -> (структура)
Подробная информация о контенте, который вы хотите, чтобы MediaPackage передал в манифесте воспроизводящему устройству.
Title -> (строка)
Source -> (строка)
Copyright -> (строка)
LanguageCode -> (строка)
MoreInformationUrl -> (строка)
DvbSettings -> (структура)
Только для конечных точек, использующих профиль DVB-DASH. Информация о загрузке шрифтов и об ошибках, которую вы хотите, чтобы MediaPackage передал через манифест.
FontDownload -> (структура)
Параметры шрифта субтитров.
Url -> (строка)
MimeType -> (строка)
Тип MIME ресурса, который находится по URL загрузки шрифтов.
Дополнительную информацию о типах MIME шрифтов см. в документе «MPEG-DASH Profile for Transport of ISO BMFF Based DVB Services over IP Based Networks».
FontFamily -> (строка)
ErrorMetrics -> (список)
Настройки для отчёта об ошибках воспроизводящего устройства.
(структура)
Только для профилей DVB-DASH. Настройки для отчёта об ошибках от воспроизводящего устройства, которые вы хотите, чтобы Elemental MediaPackage передал через манифест.
ReportingUrl -> (строка)
Probability -> (целое число)
Compactness -> (строка)
STANDARD указывает манифест по умолчанию, который сжат. NONE указывает полный манифест.SubtitleConfiguration -> (структура)
Конфигурация субтитров DASH.
TtmlConfiguration -> (структура)
Настройки субтитров TTML.
TtmlProfile -> (строка)
IMSC — это профиль по умолчанию. EBU-TT-D создаёт субтитры, которые соответствуют профилю TTML EBU-TT-D. MediaPackage передаёт стили субтитров в манифест. Дополнительную информацию о субтитрах EBU-TT-D см. в EBU-TT-D Subtitling Distribution Format.ForceEndpointErrorConfiguration -> (структура)
Настройки резервного копирования для конечной точки.
EndpointErrorConditions -> (список)
Условия резервного копирования для конечной точки. Доступные варианты:
-
STALE_MANIFEST- Манифест заблокирован, и нет новых сегментов или частей. -
INCOMPLETE_MANIFEST- В манифесте есть разрыв. -
MISSING_DRM_KEY- Включена ротация ключей, но мы не можем получить ключ для текущего периода ключей. -
SLATE_INPUT- Сегменты, содержащие содержимое заставки, считаются отсутствующим содержимым.
(строка)
ETag -> (строка)
Tags -> (карта)
Список значений тегов, разделенный запятыми, сопоставленных с ключом:значение, назначенными конечной точке источника.
key -> (строка)
value -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.