Spec-Zone.ru › AWS CLI v2

[ aws . cloudfront ]

обновить-распределение-потоковой-передачи

Описание

Обновить распределение потоковой передачи.

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

Синтаксис

  update-streaming-distribution
--streaming-distribution-config <value>
--id <value>
[--if-match <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
}

--id (строка)

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

--if-match (строка)

Значение заголовка ETag, полученного при получении конфигурации распределения потоковой передачи. Например: E2QWRUHAPOMQZL.

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

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

ETag -> (строка)

Текущая версия конфигурации. Например: E2QWRUHAPOMQZL.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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