Spec-Zone.ru › AWS CLI v2

[ aws . cloudfront ]

create-streaming-distribution-with-tags

Описание

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

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

Синтаксис

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

Параметры

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

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

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

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

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 -> (булево значение)

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

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

Сложная структура, содержащая ноль или более элементов Tag.

Items -> (список)

Сложная структура, содержащая элементы Tag.

(структура)

Сложная структура, содержащая ключ Tag и значение Tag.

Key -> (строка)

Строка, содержащая ключ Tag.

Длина строки должна быть от 1 до 128 символов. Допустимые символы включают a-z, A-Z, 0-9, пробел и специальные символы _ - . : / = + @.

Value -> (строка)

Строка, содержащая необязательное значение Tag.

Длина строки должна быть от 0 до 256 символов. Допустимые символы включают a-z, A-Z, 0-9, пробел и специальные символы _ - . : / = + @.

Синтаксис JSON:

{
  "StreamingDistributionConfig": {
    "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
  },
  "Tags": {
    "Items": [
      {
        "Key": "string",
        "Value": "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
  • 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.

Вывод

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

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

Id -> (строка)

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

ARN -> (строка)

ARN (имя ресурса Amazon) для распределения. Например: 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.

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

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

Items -> (список)

Список учетных записей 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.

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

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

Items -> (список)

Список идентификаторов пар ключей 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.

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

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

Location -> (строка)

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

ETag -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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