Spec-Zone.ru › AWS CLI v2

[ aws . cloudfront ]

get-streaming-distribution

Описание

Получает информацию о заданном распределении RTMP, включая конфигурацию распределения.

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

Синтаксис

  get-streaming-distribution
--id <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]

Параметры

--id (строка)

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

--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 (строка)

Регион для использования. Переопределяет настройки config/env.

--version (строка)

Отображение версии этого инструмента.

--color (строка)

Включение/выключение цветного вывода.

  • on
  • off
  • auto

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот параметр указан.

--ca-bundle (строка)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки config/env.

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

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

ETag -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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