Spec-Zone.ru › AWS CLI v2

[ aws . mediatailor ]

создать-местоположение-источника

Описание

Создаёт местоположение источника. Местоположение источника — это контейнер для источников. Дополнительную информацию о местоположениях источников см. в руководстве пользователя MediaTailor в разделе «Работа с местоположениями источников».

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

Синтаксис

  create-source-location
[--access-configuration <value>]
[--default-segment-delivery-configuration <value>]
--http-configuration <value>
[--segment-delivery-configurations <value>]
--source-location-name <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]

Параметры

--access-configuration (структура)

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

AccessType -> (строка)

Тип аутентификации, используемый для доступа к содержимому из HttpConfiguration::BaseUrl в вашем местоположении источника.

S3_SIGV4 - аутентификация AWS Signature Version 4 для виртуального доступа к Amazon S3. Если базовый URL-адрес вашего местоположения источника является ведром Amazon S3, MediaTailor может использовать аутентификацию AWS Signature Version 4 (SigV4) для доступа к ведру, где хранится ваше исходное содержимое. Базовый URL-адрес вашего местоположения источника MediaTailor должен соответствовать формату URL-адреса виртуального размещения запросов S3. Например, https://имя-ведрa.s3.Регион.amazonaws.com/имя-ключа.

Прежде чем вы сможете использовать S3_SIGV4, необходимо выполнить следующие требования:

  • Вы должны разрешить MediaTailor доступ к вашему ведру S3, предоставив доступы сервисному принципалу mediatailor.amazonaws.com в IAM. Подробную информацию о настройке доступа в IAM см. в руководстве пользователя IAM в разделе «Управление доступом».
  • Сервисный принцип mediatailor.amazonaws.com должен иметь разрешения на чтение всех манифестов верхнего уровня, на которые ссылаются конфигурации пакета VodSource.
  • Вызывающий API должен иметь разрешения IAM s3:GetObject для чтения всех манифестов верхнего уровня, на которые ссылаются ваши конфигурации пакета MediaTailor VodSource.
AUTODETECT_SIGV4 - аутентификация AWS Signature Version 4 для набора поддерживаемых сервисов: MediaPackage Version 2 и виртуального доступа к Amazon S3. Если базовый URL-адрес вашего местоположения источника является конечной точкой MediaPackage Version 2 или ведром Amazon S3, MediaTailor может использовать аутентификацию AWS Signature Version 4 (SigV4) для доступа к ресурсу, где хранится ваше исходное содержимое.

Прежде чем вы сможете использовать AUTODETECT_SIGV4 с конечной точкой MediaPackage Version 2, необходимо выполнить следующие требования:

  • Вы должны предоставить MediaTailor доступ к вашей конечной точке MediaPackage, предоставив разрешения сервисному принципалу mediatailor.amazonaws.com в политике доступа к источнику на конечной точке.
  • Базовый URL-адрес вашего местоположения источника MediaTailor должен быть конечной точкой MediaPackage V2.
  • Вызывающий API должен иметь разрешения IAM mediapackagev2:GetObject для чтения всех манифестов верхнего уровня, на которые ссылаются конфигурации пакета источника MediaTailor.

Прежде чем вы сможете использовать AUTODETECT_SIGV4 с ведром Amazon S3, необходимо выполнить следующие требования:

  • Вы должны предоставить MediaTailor доступ к вашему ведру S3, предоставив разрешения сервисному принципалу mediatailor.amazonaws.com в IAM. Более подробную информацию о настройке доступа в IAM см. в руководстве пользователя IAM в разделе «Управление доступом».
  • Сервисный принцип mediatailor.amazonaws.com должен иметь разрешения на чтение всех манифестов верхнего уровня, на которые ссылаются конфигурации пакета VodSource.
  • Вызывающий API должен иметь разрешения IAM s3:GetObject для чтения всех манифестов верхнего уровня, на которые ссылаются ваши конфигурации пакета MediaTailor VodSource.

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

Параметры конфигурации токена доступа AWS Secrets Manager.

HeaderName -> (строка)

Имя HTTP-заголовка, используемого для передачи токена доступа в запросах к местоположению источника.

SecretArn -> (строка)

Amazon Resource Name (ARN) секрета AWS Secrets Manager, содержащего токен доступа.

SecretStringKey -> (строка)

Ключ SecretString AWS Secrets Manager, связанный с токеном доступа. MediaTailor использует ключ для поиска пары ключ-значение SecretString, содержащей токен доступа.

Упрощённый синтаксис:

AccessType=string,SecretsManagerAccessTokenConfiguration={HeaderName=string,SecretArn=string,SecretStringKey=string}

Синтаксис JSON:

{
  "AccessType": "S3_SIGV4"|"SECRETS_MANAGER_ACCESS_TOKEN"|"AUTODETECT_SIGV4",
  "SecretsManagerAccessTokenConfiguration": {
    "HeaderName": "string",
    "SecretArn": "string",
    "SecretStringKey": "string"
  }
}

--default-segment-delivery-configuration (структура)

Необязательная конфигурация сервера, предоставляющего сегменты.

BaseUrl -> (строка)

Имя хоста сервера, который будет использоваться для предоставления сегментов. Эта строка должна включать протокол, например, https:// .

Упрощённый синтаксис:

BaseUrl=string

Синтаксис JSON:

{
  "BaseUrl": "string"
}

--http-configuration (структура)

Конфигурации пакета HTTP источника.

BaseUrl -> (строка)

Базовый URL-адрес хост-сервера местоположения источника. Эта строка должна включать протокол, например, https:// .

Упрощённый синтаксис:

BaseUrl=string

Синтаксис JSON:

{
  "BaseUrl": "string"
}

--segment-delivery-configurations (список)

Список конфигураций доставки сегментов, связанных с этим ресурсом.

(структура)

Настройки конфигурации доставки сегментов.

BaseUrl -> (строка)

Базовый URL-адрес хоста или пути сервера доставки сегментов, который вы используете для предоставления сегментов. Обычно это сеть доставки контента (CDN). URL-адрес может быть абсолютным или относительным. Для использования абсолютного URL-адреса необходимо указать протокол, например, https://example.com/some/path . Для использования относительного URL-адреса укажите относительный путь, например, /some/path* .

Name -> (строка)

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

Упрощённый синтаксис:

BaseUrl=string,Name=string ...

Синтаксис JSON:

[
  {
    "BaseUrl": "string",
    "Name": "string"
  }
  ...
]

--source-location-name (строка)

Имя, связанное с местоположением источника.

--tags (карта)

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

key -> (строка)

value -> (строка)

Упрощённый синтаксис:

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 (булево)

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

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

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

--no-verify-ssl (булево)

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

--no-paginate (булево)

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

--output (строка)

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

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • автоматически

--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.

``` END_OF_DOCUMENT_MARKER

Вывод

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

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

AccessType -> (строка)

Тип аутентификации, используемой для доступа к содержимому из HttpConfiguration::BaseUrl вашего расположения источника.

S3_SIGV4 - Аутентификация AWS Signature Version 4 для виртуального доступа к Amazon S3. Если базовый URL вашего расположения источника является ведром Amazon S3, MediaTailor может использовать аутентификацию AWS Signature Version 4 (SigV4) для доступа к ведру, где хранится ваше исходное содержимое. Ваш базовый URL расположения источника MediaTailor должен соответствовать формату URL-запроса S3 с виртуальным размещением. Например, https://имя-ведрa.s3.Регион.amazonaws.com/имя-ключа.

Прежде чем вы сможете использовать S3_SIGV4, необходимо выполнить следующие требования:

  • Вы должны разрешить MediaTailor доступ к вашему ведру S3, предоставив принципалу mediatailor.amazonaws.com права доступа в IAM. Дополнительную информацию о настройке доступа в IAM см. в руководстве пользователя IAM по управлению доступом.
  • Сервисный принцип mediatailor.amazonaws.com должен иметь разрешения на чтение всех основных манифестов, на которые ссылаются конфигурации упаковки VodSource.
  • Вызывающий API должен иметь разрешения IAM s3:GetObject для чтения всех основных манифестов, на которые ссылаются ваши конфигурации упаковки MediaTailor VodSource.
AUTODETECT_SIGV4 - Аутентификация AWS Signature Version 4 для набора поддерживаемых служб: MediaPackage Version 2 и виртуальный доступ к Amazon S3. Если базовый URL вашего расположения источника является конечной точкой MediaPackage Version 2 или ведром Amazon S3, MediaTailor может использовать аутентификацию AWS Signature Version 4 (SigV4) для доступа к ресурсу, где хранится ваше исходное содержимое.

Прежде чем вы сможете использовать AUTODETECT_SIGV4 с конечной точкой MediaPackage Version 2, необходимо выполнить следующие требования:

  • Вы должны предоставить MediaTailor доступ к вашей конечной точке MediaPackage, предоставив принципалу mediatailor.amazonaws.com права доступа в политике Origin Access на конечной точке.
  • Базовый URL вашего расположения источника MediaTailor должен быть конечной точкой MediaPackage V2.
  • Вызывающий API должен иметь mediapackagev2:GetObject разрешения IAM для чтения всех основных манифестов, на которые ссылаются конфигурации упаковки источника MediaTailor.

Прежде чем вы сможете использовать AUTODETECT_SIGV4 с ведром Amazon S3, необходимо выполнить следующие требования:

  • Вы должны предоставить MediaTailor доступ к вашему ведру S3, предоставив принципалу mediatailor.amazonaws.com права доступа в IAM. Дополнительную информацию о настройке доступа в IAM см. в руководстве по управлению доступом в *IAM*.
  • Сервисный принцип mediatailor.amazonaws.com должен иметь разрешения на чтение всех основных манифестов, на которые ссылаются конфигурации упаковки VodSource.
  • Вызывающий API должен иметь s3:GetObject разрешения IAM для чтения всех основных манифестов, на которые ссылаются ваши конфигурации упаковки MediaTailor VodSource.

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

Параметры конфигурации маркера доступа AWS Secrets Manager.

HeaderName -> (строка)

Имя HTTP-заголовка, используемого для передачи маркера доступа в запросах к расположению источника.

SecretArn -> (строка)

Amazon Resource Name (ARN) секрета AWS Secrets Manager, содержащего маркер доступа.

SecretStringKey -> (строка)

Ключ SecretString AWS Secrets Manager, связанный с маркером доступа. MediaTailor использует ключ для поиска пары ключ-значение SecretString, содержащей маркер доступа.

Arn -> (строка)

ARN, который нужно назначить расположению источника.

CreationTime -> (метка времени)

Время создания расположения источника.

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

Необязательная конфигурация сервера, предоставляющего сегменты.

BaseUrl -> (строка)

Имя хоста сервера, который будет использоваться для предоставления сегментов. Эта строка должна включать протокол, например, https:// .

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

Конфигурации пакета HTTP источника.

BaseUrl -> (строка)

Базовый URL хост-сервера расположения источника. Эта строка должна включать протокол, например, https:// .

LastModifiedTime -> (метка времени)

Время последнего изменения расположения источника.

SegmentDeliveryConfigurations -> (список)

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

(структура)

Настройки конфигурации доставки сегментов.

BaseUrl -> (строка)

Базовый URL хоста или пути сервера доставки сегментов, который вы используете для предоставления сегментов. Обычно это сеть доставки контента (CDN). URL может быть абсолютным или относительным. Для использования абсолютного URL необходимо указать протокол, например, https://example.com/some/path . Для использования относительного URL укажите относительный путь, например, /some/path* .

Name -> (строка)

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

SourceLocationName -> (строка)

Имя, которое нужно назначить расположению источника.

Tags -> (карта)

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

key -> (строка)

value -> (строка)

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

Spec-Zone.ru

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