[ 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 -> (строка)
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 -> (булево значение)
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 -> (строка)
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 -> (булево)
Location -> (строка)
ETag -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.