Spec-Zone.ru › AWS CLI v2

[ aws . cloudfront ]

получение-конфигурации-потоковой-дистрибуции

Описание

Получение информации о конфигурации потоковой дистрибуции.

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

Синтаксис

  get-streaming-distribution-config
--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
  • текст
  • таблица
  • 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.

Вывод

StreamingDistributionConfig -> (структура)

Информация о конфигурации потоковой дистрибуции.

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 в руководстве по разработке CloudFront Amazon.

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 в руководстве по разработке CloudFront Amazon.

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.

Spec-Zone.ru

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