[ aws . mediatailor ]
create-prefetch-schedule
Описание
Создает расписание предварительной выборки для конфигурации воспроизведения. Расписание предварительной выборки позволяет указать MediaTailor на загрузку и подготовку определенных рекламных объявлений перед началом рекламной паузы. Более подробная информация о предварительной загрузке рекламы представлена в разделе «Использование предварительной загрузки рекламы» в руководстве пользователя MediaTailor.
См. также: Документацию API AWS
Синтаксис
create-prefetch-schedule
[--consumption <value>]
--name <value>
--playback-configuration-name <value>
[--retrieval <value>]
[--recurring-prefetch-configuration <value>]
[--schedule-type <value>]
[--stream-id <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]
Параметры
--consumption (структура)
Настройки конфигурации, определяющие, как и когда MediaTailor потребляет предварительно загруженные рекламные объявления с сервера принятия решений о рекламе для отдельных расписаний предварительной выборки. Каждая конфигурация потребления содержит конечное время и необязательное начальное время, определяющие интервал потребления. Расписания предварительной выборки автоматически истекают не ранее чем через семь дней после окончания времени.
AvailMatchingCriteria -> (список)
Если вы хотите, чтобы MediaTailor вставлял предварительно загруженные рекламные объявления только в рекламные паузы (аваилы), которые соответствуют определенным динамическим переменным, например, scte.event_id, задайте критерии соответствия аваилов.
(структура)
MediaTailor помещает (потребляет) предварительно загруженные рекламные объявления только в том случае, если рекламная пауза соответствует критериям, определенным динамическими переменными. Это предоставляет вам точный контроль над тем, в какие рекламные паузы будут помещаться предварительно загруженные рекламные объявления.
Например, предположим, что вы задали DynamicVariable значение scte.event_id и Operator значение EQUALS, а ваша конфигурация воспроизведения имеет URL-адрес ADS https://my.ads.server.com/path?&podId=[scte.avail_num]&event=[scte.event_id]&duration=[session.avail_duration_secs]. А запрос предварительной загрузки в ADS содержит эти значения https://my.ads.server.com/path?&podId=3&event=my-awesome-event&duration=30. MediaTailor вставит предварительно загруженные рекламные объявления в рекламную паузу только в том случае, если в ней есть маркер SCTE с идентификатором события my-awesome-event, так как он должен соответствовать идентификатору события, который MediaTailor использует для запроса к ADS.
Вы можете указать до пяти AvailMatchingCriteria. Если вы укажете несколько AvailMatchingCriteria, MediaTailor объединит их для сопоставления с помощью логического AND. Вы можете моделировать логические OR комбинации, создав несколько расписаний предварительной выборки.
DynamicVariable -> (строка)
Динамическая переменная(ые), которую(ые) MediaTailor должен(а) использовать в качестве критериев соответствия аваилов. MediaTailor помещает предварительно загруженные рекламные объявления в авайл только в том случае, если авайл соответствует критериям, определенным динамической переменной. Подробности о динамических переменных см. в разделе «Использование динамических рекламных переменных» в руководстве пользователя MediaTailor.
Вы можете включить до 100 динамических переменных.
Operator -> (строка)
DynamicVariable, указанного в AvailMatchingCriteria, оператор, используемый для сравнения.EndTime -> (метка времени)
DeletePrefetchSchedule.StartTime -> (метка времени)
StartTime, предварительно загруженные рекламные объявления станут доступны после того, как MediaTailor получит их с сервера принятия решений о рекламе.Сокращенный синтаксис:
AvailMatchingCriteria=[{DynamicVariable=string,Operator=string},{DynamicVariable=string,Operator=string}],EndTime=timestamp,StartTime=timestamp
Синтаксис JSON:
{
"AvailMatchingCriteria": [
{
"DynamicVariable": "string",
"Operator": "EQUALS"
}
...
],
"EndTime": timestamp,
"StartTime": timestamp
}
--name (строка)
--playback-configuration-name (строка)
--retrieval (структура)
Настройки конфигурации для извлечения предварительно загруженных рекламных объявлений с сервера принятия решений о рекламе. Только один набор предварительно загруженных рекламных объявлений будет извлечен и впоследствии использован для каждой рекламной паузы.
DynamicVariables -> (отображение)
Динамические переменные, используемые для подстановки во время запросов предварительной загрузки на сервер принятия решений о рекламе (ADS).
Вы первоначально настраиваете динамические переменные для URL-адреса ADS при настройке конфигурации воспроизведения. При указании DynamicVariables для извлечения предварительной загрузки MediaTailor включает динамические переменные в запрос к ADS.
key -> (строка)
value -> (строка)
EndTime -> (метка времени)
StartTime -> (метка времени)
TrafficShapingType -> (строка)
TrafficShapingRetrievalWindow -> (структура)
Настройки для распределения трафика ADS по заданному интервалу вместо отправки запросов ADS для всех сессий одновременно.
RetrievalWindowDurationSeconds -> (целое число)
Сокращенный синтаксис:
DynamicVariables={KeyName1=string,KeyName2=string},EndTime=timestamp,StartTime=timestamp,TrafficShapingType=string,TrafficShapingRetrievalWindow={RetrievalWindowDurationSeconds=integer}
Синтаксис JSON:
{
"DynamicVariables": {"string": "string"
...},
"EndTime": timestamp,
"StartTime": timestamp,
"TrafficShapingType": "RETRIEVAL_WINDOW",
"TrafficShapingRetrievalWindow": {
"RetrievalWindowDurationSeconds": integer
}
}
--recurring-prefetch-configuration (структура)
Настройки, определяющие, как и когда MediaTailor выполняет предварительную загрузку рекламы в прямом эфире.
StartTime -> (метка времени)
EndTime -> (метка времени)
RecurringConsumption -> (структура)
Настройки, определяющие, как и когда MediaTailor помещает предварительно загруженные рекламные объявления в будущие рекламные паузы для повторяющихся расписаний предварительной загрузки.
RetrievedAdExpirationSeconds -> (целое число)
AvailMatchingCriteria -> (список)
Настройки для динамических переменных, определяющих, в какие рекламные паузы MediaTailor вставляет предварительно загруженные рекламные объявления.
(структура)
MediaTailor помещает (потребляет) предварительно загруженные рекламные объявления только в том случае, если рекламная пауза соответствует критериям, определенным динамическими переменными. Это предоставляет вам точный контроль над тем, в какие рекламные паузы будут помещаться предварительно загруженные рекламные объявления.
Например, предположим, что вы задали DynamicVariable значение scte.event_id и Operator значение EQUALS, а ваша конфигурация воспроизведения имеет URL-адрес ADS https://my.ads.server.com/path?&podId=[scte.avail_num]&event=[scte.event_id]&duration=[session.avail_duration_secs]. А запрос предварительной загрузки в ADS содержит эти значения https://my.ads.server.com/path?&podId=3&event=my-awesome-event&duration=30. MediaTailor вставит предварительно загруженные рекламные объявления в рекламную паузу только в том случае, если в ней есть маркер SCTE с идентификатором события my-awesome-event, так как он должен соответствовать идентификатору события, который MediaTailor использует для запроса к ADS.
Вы можете указать до пяти AvailMatchingCriteria. Если вы укажете несколько AvailMatchingCriteria, MediaTailor объединит их для сопоставления с помощью логического AND. Вы можете моделировать логические OR комбинации, создав несколько расписаний предварительной выборки.
DynamicVariable -> (строка)
Динамическая переменная(ые), которую(ые) MediaTailor должен(а) использовать в качестве критериев соответствия аваилов. MediaTailor помещает предварительно загруженные рекламные объявления в авайл только в том случае, если авайл соответствует критериям, определенным динамической переменной. Подробности о динамических переменных см. в разделе «Использование динамических рекламных переменных» в руководстве пользователя MediaTailor.
Вы можете включить до 100 динамических переменных.
Operator -> (строка)
DynamicVariable, указанного в AvailMatchingCriteria, оператор, используемый для сравнения.RecurringRetrieval -> (структура)
Настройки для извлечения предварительно загруженных рекламных объявлений с ADS.
DynamicVariables -> (отображение)
Динамические переменные, используемые для подстановки во время запросов предварительной загрузки на сервер принятия решений о рекламе (ADS).
key -> (строка)
value -> (строка)
DelayAfterAvailEndSeconds -> (целое число)
TrafficShapingType -> (строка)
TrafficShapingRetrievalWindow -> (структура)
Настройки для распределения трафика ADS по заданному интервалу вместо отправки запросов ADS для всех сессий одновременно.
RetrievalWindowDurationSeconds -> (целое число)
Синтаксис JSON:
{
"StartTime": timestamp,
"EndTime": timestamp,
"RecurringConsumption": {
"RetrievedAdExpirationSeconds": integer,
"AvailMatchingCriteria": [
{
"DynamicVariable": "string",
"Operator": "EQUALS"
}
...
]
},
"RecurringRetrieval": {
"DynamicVariables": {"string": "string"
...},
"DelayAfterAvailEndSeconds": integer,
"TrafficShapingType": "RETRIEVAL_WINDOW",
"TrafficShapingRetrievalWindow": {
"RetrievalWindowDurationSeconds": integer
}
}
}
--schedule-type (строка)
Частота, с которой MediaTailor создает расписания предварительной загрузки. SINGLE указывает, что это расписание относится к одной рекламной паузе. RECURRING указывает, что MediaTailor автоматически создает расписание для каждого аваила в прямом эфире.
Дополнительную информацию о типах предварительной загрузки и о том, когда использовать каждый из них, см. в разделе «Предварительная загрузка рекламы в Elemental MediaTailor».
Возможные значения:
SINGLERECURRING
--stream-id (строка)
StreamId указано, MediaTailor возвращает все расписания предварительной загрузки с точным соответствием по StreamId. Если не указано, MediaTailor возвращает все расписания предварительной загрузки для конфигурации воспроизведения, независимо от StreamId.--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)
Переопределить адрес по умолчанию для команды заданным адресом.
--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 -> (строка)
Consumption -> (структура)
Параметры конфигурации, определяющие, как и когда MediaTailor потребляет предварительно загруженные объявления с сервера принятия решений о рекламе для отдельных расписаний предварительной загрузки. Каждая конфигурация потребления содержит конечную дату и (необязательное) начальное время, которые определяют окно потребления. Расписания предварительной загрузки автоматически истекают не ранее, чем через семь дней после окончания срока действия.
AvailMatchingCriteria -> (список)
Если вы хотите, чтобы MediaTailor вставлял предварительно загруженные объявления только в рекламные блоки (блоки объявлений), которые соответствуют определённым динамическим переменным, таким как scte.event_id, установите критерии сопоставления рекламных блоков.
(структура)
MediaTailor размещает (потребляет) предварительно загруженные объявления только в том случае, если рекламный блок соответствует критериям, определённым динамическими переменными. Это даёт вам точный контроль над тем, в какой рекламный блок будут помещены предварительно загруженные объявления.
Например, предположим, что вы установили DynamicVariable на значение scte.event_id и Operator на значение EQUALS, а ваша конфигурация воспроизведения имеет URL-адрес ADS https://my.ads.server.com/path?&podId=[scte.avail_num]&event=[scte.event_id]&duration=[session.avail_duration_secs]. А запрос на предварительную загрузку на сервере ADS содержит эти значения https://my.ads.server.com/path?&podId=3&event=my-awesome-event&duration=30. MediaTailor вставит предварительно загруженные объявления только в рекламный блок, если в нём есть маркер SCTE с идентификатором события my-awesome-event, поскольку он должен соответствовать идентификатору события, который MediaTailor использует для запроса к серверу ADS.
Вы можете указать до пяти AvailMatchingCriteria. Если вы укажете несколько AvailMatchingCriteria, MediaTailor объединит их для сопоставления с использованием логического AND. Логические OR комбинации можно смоделировать, создав несколько расписаний предварительной загрузки.
DynamicVariable -> (строка)
Динамическая переменная(ые), которую(ые) MediaTailor должен использовать в качестве критериев сопоставления рекламных блоков. MediaTailor размещает предварительно загруженные объявления только в том рекламном блоке, который соответствует критериям, определённым динамической переменной. Сведения о динамических переменных см. в разделе «Использование динамических переменных рекламы» в Руководстве пользователя MediaTailor.
Вы можете включить до 100 динамических переменных.
Operator -> (строка)
DynamicVariable, указанного в AvailMatchingCriteria, оператор, используемый для сравнения.EndTime -> (временная метка)
DeletePrefetchSchedule.StartTime -> (временная метка)
StartTime, предварительно загруженные объявления станут доступными после того, как MediaTailor получит их с сервера принятия решений о рекламе.Name -> (строка)
PlaybackConfigurationName -> (строка)
Retrieval -> (структура)
Настройки конфигурации для получения предварительно загруженных объявлений с сервера принятия решений о рекламе. Будет получен только один набор предварительно загруженных объявлений, который впоследствии будет потреблён для каждого рекламного блока.
DynamicVariables -> (отображение)
Динамические переменные, используемые для подстановки во время запросов на предварительную загрузку на сервер принятия решений о рекламе (ADS).
Изначально вы настраиваете динамические переменные для URL-адреса ADS при настройке конфигурации воспроизведения. При указании DynamicVariables для получения предварительной загрузки MediaTailor включает динамические переменные в запрос к ADS.
ключ -> (строка)
значение -> (строка)
EndTime -> (временная метка)
StartTime -> (временная метка)
TrafficShapingType -> (строка)
TrafficShapingRetrievalWindow -> (структура)
Настройка для распределения трафика ADS в течение заданного окна вместо отправки запросов ADS для всех сеансов одновременно.
RetrievalWindowDurationSeconds -> (целое число)
RecurringPrefetchConfiguration -> (структура)
Конфигурация, определяющая, как MediaTailor выполняет повторную предварительную загрузку.
StartTime -> (временная метка)
EndTime -> (временная метка)
RecurringConsumption -> (структура)
Параметры, определяющие, как и когда MediaTailor размещает предварительно загруженные объявления в будущие рекламные блоки для расписаний повторной предварительной загрузки.
RetrievedAdExpirationSeconds -> (целое число)
AvailMatchingCriteria -> (список)
Настройка для динамических переменных, определяющих, в какие рекламные блоки MediaTailor вставляет предварительно загруженные объявления.
(структура)
MediaTailor размещает (потребляет) предварительно загруженные объявления только в том случае, если рекламный блок соответствует критериям, определённым динамическими переменными. Это даёт вам точный контроль над тем, в какой рекламный блок будут помещены предварительно загруженные объявления.
Например, предположим, что вы установили DynamicVariable на значение scte.event_id и Operator на значение EQUALS, а ваша конфигурация воспроизведения имеет URL-адрес ADS https://my.ads.server.com/path?&podId=[scte.avail_num]&event=[scte.event_id]&duration=[session.avail_duration_secs]. А запрос на предварительную загрузку на сервере ADS содержит эти значения https://my.ads.server.com/path?&podId=3&event=my-awesome-event&duration=30. MediaTailor вставит предварительно загруженные объявления только в рекламный блок, если в нём есть маркер SCTE с идентификатором события my-awesome-event, поскольку он должен соответствовать идентификатору события, который MediaTailor использует для запроса к серверу ADS.
Вы можете указать до пяти AvailMatchingCriteria. Если вы укажете несколько AvailMatchingCriteria, MediaTailor объединит их для сопоставления с использованием логического AND. Логические OR комбинации можно смоделировать, создав несколько расписаний предварительной загрузки.
DynamicVariable -> (строка)
Динамическая переменная(ые), которую(ые) MediaTailor должен использовать в качестве критериев сопоставления рекламных блоков. MediaTailor размещает предварительно загруженные объявления только в том рекламном блоке, который соответствует критериям, определённым динамической переменной. Сведения о динамических переменных см. в разделе «Использование динамических переменных рекламы» в Руководстве пользователя MediaTailor.
Вы можете включить до 100 динамических переменных.
Operator -> (строка)
DynamicVariable, указанного в AvailMatchingCriteria, оператор, используемый для сравнения.RecurringRetrieval -> (структура)
Конфигурация для получения предварительно загруженных объявлений с сервера ADS.
DynamicVariables -> (отображение)
Динамические переменные, используемые для подстановки во время запросов на предварительную загрузку на сервер принятия решений о рекламе (ADS).
ключ -> (строка)
значение -> (строка)
DelayAfterAvailEndSeconds -> (целое число)
TrafficShapingType -> (строка)
TrafficShapingRetrievalWindow -> (структура)
Настройка для распределения трафика ADS в течение заданного окна вместо отправки запросов ADS для всех сеансов одновременно.
RetrievalWindowDurationSeconds -> (целое число)
ScheduleType -> (строка)
SINGLE указывает, что это расписание относится к одному рекламному блоку. RECURRING указывает, что MediaTailor автоматически создаёт расписание для каждого рекламного блока в прямом эфире.StreamId -> (строка)
StreamId указан, MediaTailor возвращает все расписания предварительной загрузки с точным соответствием по StreamId. Если не указан, MediaTailor возвращает все расписания предварительной загрузки для конфигурации воспроизведения независимо от StreamId.
© Copyright 2025, Amazon Web Services. Created using Sphinx.