Spec-Zone.ru › AWS CLI v2

[ aws . mediatailor ]

get-playback-configuration

Описание

Извлекает конфигурацию воспроизведения. Сведения о конфигурациях MediaTailor см. в разделе Работа с конфигурациями в AWS Elemental MediaTailor.

См. также: Документация API AWS

Синтаксис

  get-playback-configuration
--name <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]

Параметры

--name (строка)

Идентификатор конфигурации воспроизведения.

--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 (логическое значение)

Включить отладочную регистрацию.

--endpoint-url (строка)

Переопределить значение URL по умолчанию команды указанным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого подключения SSL AWS CLI проверит сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования выходных данных команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/окружения.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл с набором сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/окружения.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — 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 (логическое значение)

Отключить пагинатор cli для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запрошение параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительные сведения см. в руководстве по началу работы с AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной программы. См. Использование кавычек со строками в руководстве пользователя AWS CLI.

Для описания конфигурации

Следующий get-playback-configuration отображает все данные конфигурации с именем west_campaign.

aws mediatailor get-playback-configuration \
    --name west_campaign

Вывод:

{
     "AdDecisionServerUrl": "http://your.ads.url",
     "CdnConfiguration": {},
     "DashConfiguration": {
         "ManifestEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/dash/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/",
         "MpdLocation": "EMT_DEFAULT",
         "OriginManifestType": "MULTI_PERIOD"
     },
     "HlsConfiguration": {
         "ManifestEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/master/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/"
     },
     "Name": "west_campaign",
     "PlaybackConfigurationArn": "arn:aws:mediatailor:us-west-2:123456789012:playbackConfiguration/west_campaign",
     "PlaybackEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com",
     "SessionInitializationEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/session/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/",
     "Tags": {},
     "VideoContentSourceUrl": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/683f0f2ff7cd43a48902e6dcd5e16dcf/index.m3u8"
}

Дополнительные сведения см. в разделе Просмотр конфигурации в руководстве пользователя AWS Elemental MediaTailor.

Вывод

AdDecisionServerUrl -> (строка)

URL сервера принятия решений по рекламе (ADS). Он включает в себя указание статических параметров и заглушек для динамических параметров. AWS Elemental MediaTailor подставляет параметры, специфичные для плеера и сессии, по мере необходимости при вызове ADS. В качестве альтернативы для тестирования можно указать статический URL VAST. Максимальная длина составляет 25 000 символов.

AvailSuppression -> (структура)

Настройка подавления доступности, также известной как подавление рекламы. Дополнительную информацию о подавлении рекламы см. в разделе Подавление рекламы.

Mode -> (строка)

Устанавливает режим подавления рекламы. По умолчанию подавление рекламы выключено, и все рекламные блоки заполняются рекламой или заглушкой. Когда Mode установлен в значение BEHIND_LIVE_EDGE, подавление рекламы включено, и MediaTailor не будет заполнять рекламные блоки до или после времени подавления Value в окне просмотра макета. Когда Mode установлен в значение AFTER_LIVE_EDGE, подавление рекламы включено, и MediaTailor не будет заполнять рекламные блоки, которые находятся в пределах живого края плюс значение подавления доступности.

Value -> (строка)

Время смещения живого края в формате ЧЧ:ММ:СС. MediaTailor не будет заполнять рекламные блоки до или после этого времени в окне просмотра макета. Если Value установлено в 00:00:00, оно синхронизировано с живым краем, и MediaTailor не будет заполнять любые рекламные блоки до или после живого края. Если вы установите время Value, MediaTailor не будет заполнять рекламные блоки до или после этого времени в окне просмотра макета. Например, если вы установите 00:45:00, то MediaTailor будет заполнять рекламные блоки, которые появляются в течение 45 минут за живым краем, но не будет заполнять рекламные блоки в течение или после 45 минут за живым краем.

FillPolicy -> (строка)

Определяет политику, которую следует применять к режиму подавления доступности. BEHIND_LIVE_EDGE всегда будет использовать полную политику подавления доступности. Режим AFTER_LIVE_EDGE может быть использован для вызова частичного заполнения рекламных блоков, когда сеанс запускается в середине блока.

Bumper -> (структура)

Настройка буферов. Буферы — это короткие аудио- или видеоклипы, которые воспроизводятся в начале или перед концом рекламного блока. Более подробную информацию о буферах см. в разделе Буферы.

EndUrl -> (строка)

URL конечного буфера.

StartUrl -> (строка)

URL начального буфера.

CdnConfiguration -> (структура)

Настройка использования сети доставки контента (CDN), например Amazon CloudFront, для управления сегментами контента и рекламы.

AdSegmentUrlPrefix -> (строка)

Нестандартная сеть доставки контента (CDN) для предоставления рекламных сегментов. По умолчанию AWS Elemental MediaTailor использует Amazon CloudFront с настройками кэша по умолчанию в качестве своей CDN для рекламных сегментов. Для настройки альтернативной CDN создайте правило в вашей CDN для источника рекламы ads.mediatailor.*<region>* .amazonaws.com. Затем укажите имя правила в этой AdSegmentUrlPrefix. Когда AWS Elemental MediaTailor предоставляет макет, он указывает вашу CDN в качестве источника рекламных сегментов.

ContentSegmentUrlPrefix -> (строка)

Сеть доставки контента (CDN) для кэширования сегментов контента, чтобы запросы контента не всегда направлялись на сервер источника. Сначала создайте правило в вашей CDN для сервера источника сегментов контента. Затем укажите имя правила в этой ContentSegmentUrlPrefix. Когда AWS Elemental MediaTailor предоставляет макет, он указывает вашу CDN в качестве источника сегментов контента.

ConfigurationAliases -> (карта)

Параметры плеера и псевдонимы, используемые в качестве динамических переменных во время инициализации сеанса. Дополнительную информацию см. в разделе Доменные переменные.

key -> (строка)

Динамическая переменная, имеющая псевдонимы.

value -> (карта)

Карта псевдонимов со значением, которое будет использоваться во время запроса.

key -> (строка)

value -> (строка)

DashConfiguration -> (структура)

Настройка контента DASH.

ManifestEndpointPrefix -> (строка)

URL, созданный MediaTailor для инициирования сеанса воспроизведения. Сеанс использует отчетность на стороне сервера. Это значение игнорируется в операциях PUT.

MpdLocation -> (строка)

Настройка, которая определяет, включает ли MediaTailor тег Location в макеты DASH. MediaTailor заполняет тег Location URL для запросов обновления макета, чтобы их могли использовать плееры, которые не поддерживают «привязанные» перенаправления. Отключите эту опцию, если у вас настроены правила маршрутизации CDN для доступа к макетам MediaTailor, и вы используете отчетность на стороне клиента или ваши плееры поддерживают «привязанные» HTTP-перенаправления. Допустимые значения — DISABLED и EMT_DEFAULT. Значение EMT_DEFAULT включает включение тега и является значением по умолчанию.

OriginManifestType -> (строка)

Настройка, которая определяет, обрабатывает ли MediaTailor макеты с сервера происхождения как макеты с несколькими периодами или макеты с одним периодом. Если ваш сервер происхождения создает макеты с одним периодом, установите это значение в SINGLE_PERIOD. Значение по умолчанию — MULTI_PERIOD. Для многопериодных макетов опустите эту настройку или установите её в значение MULTI_PERIOD.

HlsConfiguration -> (структура)

Настройка контента HLS.

ManifestEndpointPrefix -> (строка)

URL, используемый для инициирования сеанса воспроизведения для устройств, поддерживающих Apple HLS. Сеанс использует отчетность на стороне сервера.

InsertionMode -> (строка)

Настройка, которая определяет, могут ли плееры использовать склеенные или направленные вставки рекламы. По умолчанию, STITCHED_ONLY, принуждает все сеансы плееров использовать склеенные (на стороне сервера) вставки рекламы. Выбор PLAYER_SELECT позволяет плеерам выбрать либо склеенные, либо направленные вставки рекламы во время инициализации сеанса. По умолчанию для плееров, не указывающих режим вставки, используется склеенный режим.

LivePreRollConfiguration -> (структура)

Настройка вставки предварительной рекламы.

AdDecisionServerUrl -> (строка)

URL сервера принятия решений по рекламе (ADS) для предварительной рекламы. Он включает в себя указание статических параметров и заглушек для динамических параметров. AWS Elemental MediaTailor подставляет параметры, специфичные для плеера и сессии, по мере необходимости при вызове ADS. В качестве альтернативы для тестирования можно указать статический URL VAST. Максимальная длина составляет 25 000 символов.

MaxDurationSeconds -> (целое число)

Максимальная разрешенная продолжительность доступности предварительной рекламы. AWS Elemental MediaTailor не будет воспроизводить предварительную рекламу, превышающую эту продолжительность, независимо от общей продолжительности рекламы, возвращаемой ADS.

LogConfiguration -> (структура)

Настройка, определяющая, куда AWS Elemental MediaTailor отправляет журналы для конфигурации воспроизведения.

PercentEnabled -> (целое число)

Процент журналов сеансов, которые MediaTailor отправляет в указанное место назначения журналов. Например, если ваша конфигурация воспроизведения имеет 1000 сеансов, и percentEnabled установлено в значение 60, MediaTailor отправит журналы для 600 сеансов в CloudWatch Logs. MediaTailor случайным образом выбирает, журналы каких сеансов конфигурации воспроизведения отправлять. Если вы хотите просмотреть журналы определенного сеанса, вы можете использовать режим отладки журналов.

Допустимые значения: 0 — 100

EnabledLoggingStrategies -> (список)

Метод сбора журналов от AWS Elemental MediaTailor. LEGACY_CLOUDWATCH указывает, что MediaTailor отправляет журналы непосредственно в Amazon CloudWatch Logs. VENDED_LOGS указывает, что MediaTailor отправляет журналы в CloudWatch, который затем передает журналы в выбранное вами место назначения. Поддерживаемые места назначения — группа журналов CloudWatch Logs, ведро Amazon S3 и поток Amazon Data Firehose.

(строка)

AdsInteractionLog -> (структура)

Настройки для настройки событий, включаемых в журналы взаимодействий с сервером принятия решений по рекламе (ADS).

PublishOptInEventTypes -> (список)

Указывает, что MediaTailor генерирует RAW_ADS_RESPONSE журналы для сеансов воспроизведения, которые инициализированы с этой конфигурацией.

(строка)

ExcludeEventTypes -> (список)

Указывает, что MediaTailor не будет генерировать указанные события в журналах для сеансов воспроизведения, которые инициализированы с этой конфигурацией.

(строка)

ManifestServiceInteractionLog -> (структура)

Настройки для настройки событий, включаемых в журналы взаимодействий с сервером источника.

ExcludeEventTypes -> (список)

Указывает, что MediaTailor не будет генерировать указанные события в журналах для сеансов воспроизведения, которые инициализированы с этой конфигурацией.

(строка)

ManifestProcessingRules -> (структура)

Настройка правил обработки макетов. Правила обработки макетов позволяют настроить персонализированные макеты, созданные MediaTailor.

AdMarkerPassthrough -> (структура)

Для HLS, при установке в значение true, MediaTailor передает EXT-X-CUE-IN, EXT-X-CUE-OUT и EXT-X-SPLICEPOINT-SCTE35 метки рекламы из исходного макета в персонализированный макет MediaTailor.

Никакая логика к этим меткам рекламы не применяется. Например, если EXT-X-CUE-OUT имеет значение 60, но для этого рекламного блока нет заполненной рекламы, MediaTailor не установит значение в 0.

Enabled -> (булево значение)

Включает пропуск меток рекламы для вашей конфигурации.

Name -> (строка)

Идентификатор конфигурации воспроизведения.

PersonalizationThresholdSeconds -> (целое число)

Определяет максимальную продолжительность незаполненного рекламного времени (в секундах) в рекламном блоке. Если продолжительность незаполненного рекламного времени превышает порог персонализации, персонализация рекламного блока отменяется, и отображается основной контент. Эта функция применяется к _замене рекламы_ в потоках в реальном времени и VOD, а не к вставке рекламы, поскольку она опирается на основной поток контента. Дополнительную информацию о поведении рекламных блоков, включая замену и вставку рекламы, см. в разделе Поведение рекламы в AWS Elemental MediaTailor.

PlaybackConfigurationArn -> (строка)

Amazon Resource Name (ARN) для конфигурации воспроизведения.

PlaybackEndpointPrefix -> (строка)

URL, к которому плеер обращается для получения макета от AWS Elemental MediaTailor. Этот сеанс будет использовать отчетность на стороне сервера.

SessionInitializationEndpointPrefix -> (строка)

URL, который плеер использует для инициализации сеанса с использованием отчетности на стороне клиента.

SlateAdUrl -> (строка)

URL видеоактива с высоким качеством, который необходимо транскодировать и использовать для заполнения времени, не занятого рекламой. AWS Elemental MediaTailor показывает заглушку для заполнения пробелов в медиаконтенте. Настройка заглушки необязательна для конфигураций воспроизведения без VPAID. Для VPAID заглушка необходима, поскольку MediaTailor предоставляет её в слотах, предназначенных для динамического рекламного контента. Заглушка должна быть активом высокого качества, содержащим как аудио, так и видео.

Tags -> (карта)

Теги, назначенные для конфигурации воспроизведения. Теги — пары ключ-значение, которые вы можете связать с ресурсами Amazon для организации, управления доступом и отслеживания затрат. Для получения дополнительной информации см. Тегирование ресурсов AWS Elemental MediaTailor.

key -> (строка)

value -> (строка)

TranscodeProfileName -> (строка)

Имя, используемое для сопоставления этой конфигурации воспроизведения с пользовательским профилем транскодирования. Это переопределяет динамические значения по умолчанию для транскодирования MediaTailor. Используйте это только в том случае, если вы уже настроили пользовательские профили с помощью службы поддержки AWS.

VideoContentSourceUrl -> (строка)

Префикс URL-адреса родительского манифеста для потока минус идентификатор ресурса. Максимальная длина — 512 символов.

AdConditioningConfiguration -> (структура)

Параметр, указывающий, какие действия по обработке MediaTailor выполнит для рекламных объявлений, возвращаемых сервером принятия решений по рекламе (ADS), и какой приоритет MediaTailor использует при вставке рекламы.

StreamingMediaFileConditioning -> (строка)

Для рекламы, содержащей медиафайлы с потоковой передачей и поддерживаемыми расширениями файлов, указывает, какое действие транскодирования выполнит MediaTailor при первом получении этих объявлений от сервера ADS. TRANSCODE указывает, что MediaTailor должен транскодировать объявления. NONE указывает, что вы уже транскодировали объявления вне MediaTailor и не нуждаетесь в их транскодировании в рамках процесса вставки рекламы. Дополнительную информацию об обработке рекламы см. в руководстве пользователя Elemental MediaTailor в разделе «Использование предварительно обработанной рекламы».

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API