[ 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 -> (строка)
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
}
--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 -> (строка)
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.Количество -> (целое число)
Элементы -> (список)
Список учетных записей Amazon Web Services и идентификаторов активных пар ключей CloudFront в каждой учетной записи, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и подписанных файлов cookie.
(структура)
Список учетных записей Amazon Web Services и активных пар ключей CloudFront в каждой учетной записи, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и подписанных файлов cookie.
AwsAccountNumber -> (строка)
self.KeyPairIds -> (структура)
Список идентификаторов пар ключей CloudFront.
Количество -> (целое число)
Элементы -> (список)
Список идентификаторов пар ключей 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.
Псевдонимы -> (структура)
Сложный тип, содержащий информацию о CNAME (альтернативных именах домена), если таковые имеются, для этого потокового распределения.
Количество -> (целое число)
Элементы -> (список)
Сложный тип, содержащий псевдонимы CNAME, если таковые имеются, которые вы хотите связать с этим распределением.
(строка)
Комментарий -> (строка)
Ведение журнала -> (структура)
Сложный тип, который управляет записью журналов доступа для потокового распределения.
Enabled -> (булево)
false для Enabled и укажите элементы empty Bucket и Prefix. Если вы укажете false для Enabled, но укажете значения для Bucket и Prefix, эти значения автоматически будут удалены.Ведро -> (строка)
amzn-s3-demo-bucket.s3.amazonaws.com .Префикс -> (строка)
myprefix/ . Если вы хотите включить ведение журнала, но не хотите указывать префикс, вы по-прежнему должны включить пустой элемент Prefix в элементе Logging.TrustedSigners -> (структура)
Сложный тип, который указывает любые учетные записи Amazon Web Services, которым вы хотите разрешить создавать подписанные URL-адреса для контента. Если вы хотите, чтобы распределение использовало подписанные URL-адреса, включите этот элемент; если вы хотите, чтобы распределение использовало общедоступные URL-адреса, удалите этот элемент. Дополнительную информацию см. в разделе Служение частным содержимым через CloudFront в руководстве разработчика Amazon CloudFront.
Enabled -> (булево)
true, если какая-либо из учетных записей Amazon Web Services в списке настроена как доверенное подписывающее лицо. В противном случае это поле равно false.Количество -> (целое число)
Элементы -> (список)
Список идентификаторов учетных записей Amazon Web Services.
(строка)
PriceClass -> (строка)
Enabled -> (булево)
Расположение -> (строка)
ETag -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.