Spec-Zone.ru › AWS CLI v2

[ aws . cloudfront ]

create-streaming-distribution

Описание

Этот API устарел. Amazon CloudFront прекращает поддержку распределений протокола реального времени (RTMP) 31 декабря 2020 года. Для получения дополнительной информации ознакомьтесь с объявлением на форуме обсуждений Amazon CloudFront.

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

Синтаксис

  create-streaming-distribution
--streaming-distribution-config <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]

Параметры

--streaming-distribution-config (структура)

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

CallerReference -> (строка)

Уникальное значение (например, метка даты и времени), гарантирующее, что запрос нельзя повторно воспроизвести.

Если значение CallerReference новое (независимо от содержимого объекта StreamingDistributionConfig), CloudFront создаёт новое распределение.

Если CallerReference является значением, которое вы уже отправляли в предыдущем запросе на создание распределения, CloudFront возвращает ошибку DistributionAlreadyExists.

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

Сложная структура, содержащая информацию об Amazon S3-хранилище, из которого CloudFront должен получать ваши медиафайлы для распределения.

DomainName -> (строка)

Имя DNS источника Amazon S3.

OriginAccessIdentity -> (строка)

Идентификатор доступа к источнику CloudFront, который необходимо связать с распределением. Используйте идентификатор доступа к источнику, чтобы настроить распределение таким образом, чтобы конечные пользователи могли получить доступ к объектам в Amazon S3-хранилище только через CloudFront.

Если вы хотите, чтобы конечные пользователи могли получать доступ к объектам, используя либо URL CloudFront, либо URL Amazon S3, укажите пустой элемент OriginAccessIdentity.

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

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

Для получения дополнительной информации см. Использование идентификатора доступа к источнику для ограничения доступа к вашему содержимому Amazon S3 в руководстве разработчика Amazon CloudFront.

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

Сложная структура, содержащая информацию о CNAME (альтернативных доменных именах), если таковые имеются, для этого распределения потоковой передачи.

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

Количество CNAME-алиасов, если таковые имеются, которые вы хотите связать с этим распределением.

Items -> (список)

Сложная структура, содержащая CNAME-алиасы, если таковые имеются, которые вы хотите связать с этим распределением.

(строка)

Comment -> (строка)

Любые комментарии, которые вы хотите включить в отношении распределения потоковой передачи.

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

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

Enabled -> (булево)

Указывает, хотите ли вы, чтобы CloudFront сохранял журналы доступа в Amazon S3-хранилище. Если вы не хотите включать ведение журнала при создании распределения потоковой передачи или хотите отключить ведение журнала для существующего распределения потоковой передачи, укажите false для Enabled и укажите элементы empty Bucket и Prefix. Если вы укажете false для Enabled, но укажете значения для Bucket и Prefix, значения автоматически удалятся.

Bucket -> (строка)

Amazon S3-хранилище для хранения журналов доступа, например, amzn-s3-demo-bucket.s3.amazonaws.com.

Prefix -> (строка)

Необязательная строка, которую вы хотите, чтобы CloudFront добавлял в качестве префикса к именам файлов журналов доступа для этого распределения потоковой передачи, например, myprefix/. Если вы хотите включить ведение журнала, но не хотите указывать префикс, вы все равно должны включить пустой элемент Prefix в элементе Logging.

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

Сложная структура, указывающая любые учётные записи Amazon Web Services, которые вы хотите разрешить создавать подписанные URL-адреса для закрытого содержимого. Если вы хотите, чтобы распределение использовало подписанные URL-адреса, включите этот элемент; если вы хотите, чтобы распределение использовало публичные URL-адреса, удалите этот элемент. Для получения дополнительной информации см. Обслуживание конфиденциального содержимого через CloudFront в руководстве разработчика Amazon CloudFront.

Enabled -> (булево)

Это поле true, если какие-либо учётные записи Amazon Web Services в списке настроены как доверенные подписывающие лица. В противном случае это поле false.

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

Количество учётных записей Amazon Web Services в списке.

Items -> (список)

Список идентификаторов учётных записей Amazon Web Services.

(строка)

PriceClass -> (строка)

Сложная структура, содержащая информацию о ценовом классе для этого распределения потоковой передачи.

Enabled -> (булево)

Включено ли распределение потоковой передачи для обработки запросов пользователей на содержимое.

Синтаксис краткого ввода:

CallerReference=string,S3Origin={DomainName=string,OriginAccessIdentity=string},Aliases={Quantity=integer,Items=[string,string]},Comment=string,Logging={Enabled=boolean,Bucket=string,Prefix=string},TrustedSigners={Enabled=boolean,Quantity=integer,Items=[string,string]},PriceClass=string,Enabled=boolean

Синтаксис JSON:

{
  "CallerReference": "string",
  "S3Origin": {
    "DomainName": "string",
    "OriginAccessIdentity": "string"
  },
  "Aliases": {
    "Quantity": integer,
    "Items": ["string", ...]
  },
  "Comment": "string",
  "Logging": {
    "Enabled": true|false,
    "Bucket": "string",
    "Prefix": "string"
  },
  "TrustedSigners": {
    "Enabled": true|false,
    "Quantity": integer,
    "Items": ["string", ...]
  },
  "PriceClass": "PriceClass_100"|"PriceClass_200"|"PriceClass_All"|"None",
  "Enabled": true|false
}

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

Вывод

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

Информация о потоковой передаче.

Id -> (строка)

Идентификатор RTMP-распределения. Например: EGTXBD79EXAMPLE .

ARN -> (строка)

ARN (Amazon Resource Name) для распределения. Например: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5 , где 123456789012 — ваш идентификатор учетной записи Amazon Web Services.

Статус -> (строка)

Текущий статус RTMP-распределения. Когда статус равен Deployed , информация о распределении распространяется на все расположения кэша CloudFront.

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

Дата и время последнего изменения распределения.

DomainName -> (строка)

Имя домена, соответствующее потоковому распределению, например, s5c39gqb8ow64r.cloudfront.net .

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

Сложный тип, который перечисляет учетные записи Amazon Web Services, если таковые имеются, которые вы включили в TrustedSigners сложный тип для данного распределения. Это учетные записи, которым вы хотите разрешить создавать подписанные URL-адреса для частного контента.

В сложный тип Signer включен номер учетной записи Amazon Web Services доверенного подписывающего лица или self, если подписывающим лицом является учетная запись Amazon Web Services, создавшая распределение. Элемент Signer также включает идентификаторы любых активных пар ключей CloudFront, связанных с учетной записью Amazon Web Services доверенного подписывающего лица. Если для Signer отсутствует элемент KeyPairId, это подписывающее лицо не может создавать подписанные URL-адреса.

Дополнительную информацию см. в разделе Служение частным содержимым через CloudFront в руководстве разработчика Amazon CloudFront.

Enabled -> (булево)

Это поле равно true, если какая-либо из учетных записей Amazon Web Services в списке настроена как доверенное подписывающее лицо. В противном случае это поле равно false.

Количество -> (целое число)

Количество учетных записей Amazon Web Services в списке.

Элементы -> (список)

Список учетных записей Amazon Web Services и идентификаторов активных пар ключей CloudFront в каждой учетной записи, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и подписанных файлов cookie.

(структура)

Список учетных записей Amazon Web Services и активных пар ключей CloudFront в каждой учетной записи, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и подписанных файлов cookie.

AwsAccountNumber -> (строка)

Номер учетной записи Amazon Web Services, содержащей активные пары ключей CloudFront, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и подписанных файлов cookie. Если учетная запись Amazon Web Services, владеющая парами ключей, совпадает с учетной записью, владеющей распределением CloudFront, значение этого поля равно self.

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

Список идентификаторов пар ключей CloudFront.

Количество -> (целое число)

Количество идентификаторов пар ключей в списке.

Элементы -> (список)

Список идентификаторов пар ключей CloudFront.

(строка)

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

Текущая конфигурация информации для RTMP-распределения.

CallerReference -> (строка)

Уникальное значение (например, отметка времени), гарантирующее, что запрос не может быть повторно отправлен.

Если значение CallerReference новое (независимо от содержимого объекта StreamingDistributionConfig), CloudFront создает новое распределение.

Если CallerReference — это значение, которое вы уже отправляли в предыдущем запросе для создания распределения, CloudFront возвращает ошибку DistributionAlreadyExists.

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

Сложный тип, содержащий информацию об Amazon S3-ведре, из которого вы хотите, чтобы CloudFront получал файлы мультимедиа для распределения.

DomainName -> (строка)

Имя DNS источника Amazon S3.

OriginAccessIdentity -> (строка)

Идентификатор доступа к источнику CloudFront для связывания с распределением. Используйте идентификатор доступа к источнику для настройки распределения таким образом, чтобы конечные пользователи могли получать доступ к объектам в Amazon S3-ведре только через CloudFront.

Если вы хотите, чтобы конечные пользователи могли получать доступ к объектам с помощью URL-адреса CloudFront или URL-адреса Amazon S3, укажите пустой элемент OriginAccessIdentity.

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

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

Дополнительную информацию см. в разделе Использование идентификатора доступа к источнику для ограничения доступа к вашему содержимому Amazon S3 в руководстве разработчика Amazon CloudFront.

Псевдонимы -> (структура)

Сложный тип, содержащий информацию о CNAME (альтернативных именах домена), если таковые имеются, для этого потокового распределения.

Количество -> (целое число)

Количество псевдонимов CNAME, которые вы хотите связать с этим распределением.

Элементы -> (список)

Сложный тип, содержащий псевдонимы CNAME, если таковые имеются, которые вы хотите связать с этим распределением.

(строка)

Комментарий -> (строка)

Любые комментарии, которые вы хотите включить о потоковом распределении.

Ведение журнала -> (структура)

Сложный тип, который управляет записью журналов доступа для потокового распределения.

Enabled -> (булево)

Указывает, хотите ли вы, чтобы CloudFront сохранял журналы доступа в ведре Amazon S3. Если вы не хотите включить ведение журнала при создании потокового распределения или если вы хотите отключить ведение журнала для существующего потокового распределения, укажите false для Enabled и укажите элементы empty Bucket и Prefix. Если вы укажете false для Enabled, но укажете значения для Bucket и Prefix, эти значения автоматически будут удалены.

Ведро -> (строка)

Ведро Amazon S3 для хранения журналов доступа, например, amzn-s3-demo-bucket.s3.amazonaws.com .

Префикс -> (строка)

Необязательная строка, которую вы хотите, чтобы CloudFront добавлял в качестве префикса к именам файлов журналов доступа для этого потокового распределения, например, myprefix/ . Если вы хотите включить ведение журнала, но не хотите указывать префикс, вы по-прежнему должны включить пустой элемент Prefix в элементе Logging.

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

Сложный тип, который указывает любые учетные записи Amazon Web Services, которым вы хотите разрешить создавать подписанные URL-адреса для контента. Если вы хотите, чтобы распределение использовало подписанные URL-адреса, включите этот элемент; если вы хотите, чтобы распределение использовало общедоступные URL-адреса, удалите этот элемент. Дополнительную информацию см. в разделе Служение частным содержимым через CloudFront в руководстве разработчика Amazon CloudFront.

Enabled -> (булево)

Это поле равно true, если какая-либо из учетных записей Amazon Web Services в списке настроена как доверенное подписывающее лицо. В противном случае это поле равно false.

Количество -> (целое число)

Количество учетных записей Amazon Web Services в списке.

Элементы -> (список)

Список идентификаторов учетных записей Amazon Web Services.

(строка)

PriceClass -> (строка)

Сложный тип, содержащий информацию о ценовом классе для данного потокового распределения.

Enabled -> (булево)

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

Расположение -> (строка)

Полный URI нового ресурса потокового распределения, который только что был создан.

ETag -> (строка)

Текущая версия созданного потокового распределения.

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

Spec-Zone.ru

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