[ 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 -> (строка)
OriginAccessIdentity -> (строка)
Идентификатор доступа к источнику CloudFront, который необходимо связать с распределением. Используйте идентификатор доступа к источнику для настройки распределения таким образом, чтобы конечные пользователи могли получить доступ к объектам в Amazon S3-бакете только через CloudFront.
Если вы хотите, чтобы конечные пользователи могли получить доступ к объектам как через URL CloudFront, так и через URL Amazon S3, укажите пустой элемент OriginAccessIdentity.
Чтобы удалить идентификатор доступа к источнику из существующего распределения, обновите конфигурацию распределения и включите пустой элемент OriginAccessIdentity.
Чтобы заменить идентификатор доступа к источнику, обновите конфигурацию распределения и укажите новый идентификатор доступа к источнику.
Дополнительную информацию см. в разделе Использование идентификатора доступа к источнику для ограничения доступа к вашему содержимому Amazon S3 в Руководстве разработчика Amazon CloudFront.
Aliases -> (структура)
Сложный тип, содержащий информацию о CNAME (альтернативных доменных именах), если таковые имеются, для этого распределения потоковой передачи.
Quantity -> (целое число)
Items -> (список)
Сложный тип, содержащий CNAME-псевдонимы, если таковые имеются, которые вы хотите связать с этим распределением.
(строка)
Comment -> (строка)
Logging -> (структура)
Сложный тип, контролирующий, записываются ли журналы доступа для распределения потоковой передачи.
Enabled -> (булево)
false для Enabled и укажите элементы empty Bucket и Prefix. Если вы укажете false для Enabled, но укажете значения для Bucket и Prefix, эти значения будут автоматически удалены.Bucket -> (строка)
amzn-s3-demo-bucket.s3.amazonaws.com.Prefix -> (строка)
myprefix/. Если вы хотите включить ведение журнала, но не хотите указывать префикс, вы все равно должны включить пустой элемент Prefix в элементе Logging.TrustedSigners -> (структура)
Сложный тип, определяющий любые учетные записи Amazon Web Services, которые вы хотите разрешить для создания подписанных URL-адресов для контента. Если вы хотите, чтобы распределение использовало подписанные URL-адреса, включите этот элемент; если вы хотите, чтобы распределение использовало публичные URL-адреса, удалите этот элемент. Дополнительную информацию см. в разделе Обслуживание закрытого контента через CloudFront в Руководстве разработчика Amazon CloudFront.
Enabled -> (булево)
true, если какие-либо из учетных записей Amazon Web Services в списке настроены как доверенные подписывающие агенты. В противном случае это поле false.Quantity -> (целое число)
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 -> (строка)
EGTXBD79EXAMPLE .ARN -> (строка)
arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5 , где 123456789012 — ваш идентификатор учетной записи Amazon Web Services.Статус -> (строка)
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 -> (целое число)
Items -> (список)
Список учетных записей Amazon Web Services и идентификаторов активных пар ключей CloudFront в каждой учетной записи, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и подписанных файлов cookie.
(структура)
Список учетных записей Amazon Web Services и активных пар ключей CloudFront в каждой учетной записи, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и подписанных файлов cookie.
AwsAccountNumber -> (строка)
self.KeyPairIds -> (структура)
Список идентификаторов пар ключей CloudFront.
Quantity -> (целое число)
Items -> (список)
Список идентификаторов пар ключей CloudFront.
(строка)
StreamingDistributionConfig -> (структура)
Текущая конфигурационная информация для RTMP-распределения.
CallerReference -> (строка)
Уникальное значение (например, временная метка), которое гарантирует, что запрос не может быть повторен.
Если значение CallerReference новое (независимо от содержимого объекта StreamingDistributionConfig), CloudFront создает новое распределение.
Если CallerReference — это значение, которое вы уже отправляли в предыдущем запросе на создание распределения, CloudFront возвращает ошибку DistributionAlreadyExists.
S3Origin -> (структура)
Сложный тип, содержащий информацию об Amazon S3-бакете, из которого вы хотите, чтобы CloudFront получал ваши медиафайлы для распределения.
DomainName -> (строка)
OriginAccessIdentity -> (строка)
Идентификатор источника доступа CloudFront, который нужно связать с распределением. Используйте идентификатор источника доступа для настройки распределения таким образом, чтобы конечные пользователи могли получать доступ к объектам в Amazon S3-бакете только через CloudFront.
Если вы хотите, чтобы конечные пользователи могли получать доступ к объектам, используя либо URL-адрес CloudFront, либо URL-адрес Amazon S3, укажите пустой элемент OriginAccessIdentity.
Чтобы удалить идентификатор источника доступа из существующего распределения, обновите конфигурацию распределения и включите пустой элемент OriginAccessIdentity.
Чтобы заменить идентификатор источника доступа, обновите конфигурацию распределения и укажите новый идентификатор источника доступа.
Дополнительную информацию см. в разделе "Использование идентификатора источника доступа для ограничения доступа к вашему контенту Amazon S3" в Руководстве разработчика Amazon CloudFront.
Aliases -> (структура)
Сложный тип, содержащий информацию о CNAME (альтернативных именах домена), если таковые имеются, для этого потокового распределения.
Quantity -> (целое число)
Items -> (список)
Сложный тип, содержащий CNAME-алиасы, если таковые имеются, которые вы хотите связать с этим распределением.
(строка)
Comment -> (строка)
Logging -> (структура)
Сложный тип, управляющий записью журналов доступа для потокового распределения.
Enabled -> (логическое значение)
false для Enabled и укажите элементы empty Bucket и Prefix. Если вы укажете false для Enabled, но укажете значения для Bucket и Prefix, эти значения будут автоматически удалены.Bucket -> (строка)
amzn-s3-demo-bucket.s3.amazonaws.com.Prefix -> (строка)
myprefix/. Если вы хотите включить ведение журнала, но не хотите указывать префикс, вы все равно должны включить пустой элемент Prefix в элемент Logging.TrustedSigners -> (структура)
Сложный тип, указывающий учетные записи Amazon Web Services, которые вы хотите разрешить создавать подписанные URL-адреса для контента с ограниченным доступом. Если вы хотите, чтобы распределение использовало подписанные URL-адреса, включите этот элемент; если вы хотите, чтобы распределение использовало общедоступные URL-адреса, удалите этот элемент. Дополнительную информацию см. в разделе "Оказание доступа к закрытому контенту через CloudFront" в Руководстве разработчика Amazon CloudFront.
Enabled -> (логическое значение)
true, если хотя бы одна из учетных записей Amazon Web Services в списке настроена как доверенное подписывающее лицо. В противном случае это поле равно false.Quantity -> (целое число)
Items -> (список)
Список идентификаторов учетных записей Amazon Web Services.
(строка)
PriceClass -> (строка)
Enabled -> (логическое значение)
ETag -> (строка)
E2QWRUHAPOMQZL.
© Copyright 2025, Amazon Web Services. Created using Sphinx.