Spec-Zone.ru › AWS CLI v2

[ aws . logs ]

describe-delivery-sources

Описание

Возвращает список источников доставки, созданных в учетной записи.

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

describe-delivery-sources является постраничным запросом. Для получения всего набора результатов могут быть сделаны несколько API-вызовов. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответ с постраничным выводом аргумент --query должен извлекать данные из результатов следующих выражений запроса: deliverySources

Синтаксис

  describe-delivery-sources
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения перепишут значения, полученные из JSON. Невозможно передавать произвольные двоичные значения, используя значение, полученное из JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Маркер для указания точки начала постраничного вывода. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Чтобы продолжить постраничный вывод, укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS Command Line Interface.

--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.

Вывод

deliverySources -> (список)

Массив структур. Каждая структура содержит информацию об одном источнике доставки в учетной записи.

(структура)

Эта структура содержит информацию об одном источнике доставки в вашей учетной записи. Источник доставки — это ресурс Amazon Web Services, который отправляет журналы в целевой ресурс Amazon Web Services. Целевой ресурс может быть CloudWatch Logs, Amazon S3 или Firehose.

Только некоторые сервисы Amazon Web Services поддерживают конфигурацию в качестве источника доставки. Эти сервисы перечислены в таблице Поддерживаемые [V2 разрешения] в разделе Включение ведения журнала из сервисов Amazon Web Services.

Чтобы настроить доставку журналов между поддерживаемым сервисом Amazon Web Services и целевым ресурсом, необходимо выполнить следующие действия:

  • Создайте источник доставки, который представляет собой логический объект, представляющий ресурс, фактически отправляющий журналы. Дополнительные сведения см. в разделе PutDeliverySource .
  • Создайте целевой ресурс доставки, который представляет собой логический объект, представляющий фактический целевой ресурс. Дополнительные сведения см. в разделе PutDeliveryDestination .
  • Если вы осуществляете доставку журналов между учетными записями, необходимо использовать PutDeliveryDestinationPolicy в целевой учетной записи, чтобы назначить политику IAM целевому ресурсу. Эта политика разрешает доставку в этот целевой ресурс.
  • Создайте доставку, связав ровно один источник доставки и один целевой ресурс доставки. Дополнительные сведения см. в разделе CreateDelivery .

Вы можете настроить один источник доставки для отправки журналов в несколько целевых ресурсов, создав несколько доставок. Вы также можете создать несколько доставок, чтобы настроить несколько источников доставки для отправки журналов в один и тот же целевой ресурс.

name -> (строка)

Уникальное имя источника доставки.

arn -> (строка)

Amazon Resource Name (ARN), уникально идентифицирующий этот источник доставки.

resourceArns -> (список)

Этот массив содержит ARN ресурса Amazon Web Services, который отправляет журналы и представлен этим источником доставки. В настоящее время в массиве может быть только один ARN.

(строка)

service -> (строка)

Сервис Amazon Web Services, отправляющий журналы.

logType -> (строка)

Тип журнала, который отправляет источник. Действительные значения для этого параметра см. в документации для сервиса источника.

tags -> (карта)

Теги, назначенные этому источнику доставки.

key -> (строка)

value -> (строка)

nextToken -> (строка)

Маркер для следующего набора элементов для возврата. Маркер истекает через 24 часа.

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

Spec-Zone.ru

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