[ aws . mediapackagev2 ]
обновить-точку-доступа-источника
Описание
Обновить указанную точку доступа источника. Измените параметры упаковки в точке доступа для оптимизации просмотра. Вы не можете изменить имя точки доступа.
Любые внесенные изменения, влияющие на выходной видеопоток, могут не отразиться в течение нескольких минут.
См. также: Документация API AWS
Синтаксис
update-origin-endpoint
--channel-group-name <value>
--channel-name <value>
--origin-endpoint-name <value>
--container-type <value>
[--segment <value>]
[--description <value>]
[--startover-window-seconds <value>]
[--hls-manifests <value>]
[--low-latency-hls-manifests <value>]
[--dash-manifests <value>]
[--force-endpoint-error-configuration <value>]
[--e-tag <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-шлюза прокси, который вы настроили для взаимодействия с сервером ключей. API-шлюз прокси должен находиться в том же 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"
}
}
}
--description (строка)
--startover-window-seconds (целое число)
--hls-manifests (список)
Настройка манифеста потокового видео в формате HLS (HTTP).
(структура)
Создать настройку манифеста потокового видео в формате HLS (HTTP).
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 Live Streaming (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-адреса для получения сегментов. Вы можете указать несколько местоположений и указать приоритет и вес, когда следует использовать каждое из них, для использования в многоканальных рабочиx процессах CDN.
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 Subtitling Distribution.ErrorMetrics -> (список)
Настройки отчётов об ошибках воспроизведения устройства.
(структура)
Только для профилей DVB-DASH. Настройки для отчетов об ошибках от воспроизводящего устройства, которые вы хотите, чтобы Elemental MediaPackage передавал в манифест.
ReportingUrl -> (строка)
Probability -> (целое число)
Compactness -> (строка)
Макет манифеста DASH, который MediaPackage создает. STANDARD указывает на стандартный манифест, который сжат. NONE указывает на полный манифест.
Дополнительную информацию о компактности см. в руководстве пользователя AWS Elemental MediaPackage v2.
SubtitleConfiguration -> (структура)
Настройка для субтитров DASH.
TtmlConfiguration -> (структура)
Настройки для субтитров TTML.
TtmlProfile -> (строка)
IMSC - это стандартный профиль. EBU-TT-D генерирует субтитры, совместимые с профилем EBU-TT-D TTML. MediaPackage передает стили субтитров в манифест. Дополнительную информацию о субтитрах EBU-TT-D см. в формате EBU-TT-D Subtitling Distribution.Синтаксис 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", ...]
}
--e-tag (строка)
--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-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 Версии 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 -> (список)
Настройка макета потокового воспроизведения в формате HTTP Live Streaming (HLS).
(структура)
Получение настроек макета потокового воспроизведения в формате HTTP Live Streaming (HLS).
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 -> (структура)
Настройка фильтра включает параметры для фильтрации макета, начального и конечного времени и задержки времени, которые применяются ко всем вашим запросам egress для данного макета.
ManifestFilter -> (строка)
Start -> (временная метка)
End -> (временная метка)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (временная метка)
StartTag -> (структура)
Чтобы вставить тег EXT-X-START в вашу HLS-плейлист, укажите объект конфигурации StartTag со значением TimeOffset. При этом вы также можете указать, нужно ли включать значение PRECISE в тег EXT-X-START.
TimeOffset -> (число с плавающей точкой)
Precise -> (булево)
UrlEncodeChildManifest -> (булево)
LowLatencyHlsManifests -> (список)
Настройка макета потокового воспроизведения HLS с низкой задержкой.
(структура)
Получение настроек макета потокового воспроизведения в формате HTTP Live Streaming (HLS) с низкой задержкой.
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 -> (структура)
Настройка фильтра включает параметры для фильтрации макета, начального и конечного времени и задержки времени, которые применяются ко всем вашим запросам egress для данного макета.
ManifestFilter -> (строка)
Start -> (временная метка)
End -> (временная метка)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (временная метка)
StartTag -> (структура)
Чтобы вставить тег EXT-X-START в вашу HLS-плейлист, укажите объект конфигурации StartTag со значением TimeOffset. При этом вы также можете указать, нужно ли включать значение PRECISE в тег EXT-X-START.
TimeOffset -> (число с плавающей точкой)
Precise -> (булево)
UrlEncodeChildManifest -> (булево)
ForceEndpointErrorConfiguration -> (структура)
Настройки переключения для конечной точки.
EndpointErrorConditions -> (список)
Условия переключения для конечной точки. Варианты:
-
STALE_MANIFEST- Макет заблокирован, и нет новых сегментов или частей. -
INCOMPLETE_MANIFEST- В макете есть пробел. -
MISSING_DRM_KEY- Включено обновление ключей, но мы не можем получить ключ для текущего периода ключей. -
SLATE_INPUT- Сегменты, содержащие контент слайда, считаются отсутствующим контентом.
(строка)
ETag -> (строка)
Tags -> (карта)
Список пар ключ:значение тегов, разделённых запятыми, назначенных конечной точке происхождения.
key -> (строка)
value -> (строка)
DashManifests -> (список)
Конфигурация манифеста DASH.
(структура)
Получение конфигурации манифеста DASH.
ManifestName -> (строка)
Url -> (строка)
ManifestWindowSeconds -> (целое число)
FilterConfiguration -> (структура)
Конфигурация фильтра включает настройки для фильтрации манифеста, начала и окончания времени, а также задержки времени, которые применяются ко всем запросам к этой конечной точке для данного манифеста.
ManifestFilter -> (строка)
Start -> (метка времени)
End -> (метка времени)
TimeDelaySeconds -> (целое число)
ClipStartTime -> (метка времени)
MinUpdatePeriodSeconds -> (целое число)
MinBufferTimeSeconds -> (целое число)
SuggestedPresentationDelaySeconds -> (целое число)
SegmentTemplateFormat -> (строка)
Определяет тип переменной, используемой в media URL тега SegmentTemplate в манифесте. Также указывает, включена ли информация о временной шкале сегментов в SegmentTimeline или SegmentTemplate.
Описание значения:
-
NUMBER_WITH_TIMELINE- Переменная$Number$используется вmediaURL. Значение этой переменной — порядковый номер сегмента. Полный объектSegmentTimelineпредставлен в каждомSegmentTemplate.
PeriodTriggers -> (список)
Список триггеров, контролирующих, когда AWS Elemental MediaPackage разделяет манифест MPEG-DASH на несколько периодов. Оставьте это значение пустым, чтобы указать, что весь манифест содержится в одном периоде. Дополнительную информацию о периодах в манифесте DASH см. в разделе Многопериодный DASH в AWS Elemental MediaPackage.
(строка)
ScteDash -> (структура)
Конфигурация SCTE.
AdMarkerDash -> (строка)
Выберите, как встраивать метки рекламы в упакованное содержимое. Если вы включаете метки рекламы в поток содержимого в своих потоковых кодерах, вам необходимо указать MediaPackage, что делать с метками рекламы на выходе.
Описание значения:
-
Binary- Метка SCTE-35 выражается как шестнадцатеричная строка (строка Base64), а не в полном XML формате. -
XML- Метка SCTE выражается полностью в формате XML.
DrmSignaling -> (строка)
UtcTiming -> (структура)
Определяет тип UTC-времени, включенного в DASH Media Presentation Description (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 -> (строка)
mimeType ресурса по URL загрузки шрифтов.
Дополнительную информацию о типах MIME шрифтов см. в документе «MPEG-DASH Profile for Transport of ISO BMFF Based DVB Services over IP Based Networks».
FontFamily -> (строка)
fontFamily для субтитров, как описано в EBU-TT-D Subtitling Distribution Format.ErrorMetrics -> (список)
Настройки отчётов об ошибках устройства воспроизведения.
(структура)
Только для профилей DVB-DASH. Настройки отчётов об ошибках устройства воспроизведения, которые Elemental MediaPackage передаёт в манифест.
ReportingUrl -> (строка)
Probability -> (целое число)
Compactness -> (строка)
STANDARD указывает манифест по умолчанию, который сжат. NONE указывает полный манифест.SubtitleConfiguration -> (структура)
Конфигурация субтитров DASH.
TtmlConfiguration -> (структура)
Настройки субтитров TTML.
TtmlProfile -> (строка)
IMSC — это профиль по умолчанию. EBU-TT-D создаёт субтитры, соответствующие профилю EBU-TT-D TTML. MediaPackage передаёт стили субтитров в манифест. Дополнительную информацию о субтитрах EBU-TT-D см. в EBU-TT-D Subtitling Distribution Format.
© Copyright 2025, Amazon Web Services. Created using Sphinx.