Spec-Zone.ru › AWS CLI v2

[ aws . logs ]

put-delivery-source

Описание

Создает или обновляет логическую источников доставки. Источник доставки представляет ресурс Amazon Web Services, который отправляет журналы в пункт назначения доставки журналов. Пункт назначения может быть CloudWatch Logs, Amazon S3 или Firehose.

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

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

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

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

Если вы используете эту операцию для обновления существующего источника доставки, все текущие параметры источника доставки перезаписываются новыми значениями параметров, которые вы указали.

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

Синтаксис

  put-delivery-source
--name <value>
--resource-arn <value>
--log-type <value>
[--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]

Параметры

--name (строка)

Имя этого источника доставки. Это имя должно быть уникальным для всех источников доставки в вашей учетной записи.

--resource-arn (строка)

ARN ресурса Amazon Web Services, который генерирует и отправляет журналы. Например, arn:aws:workmail:us-east-1:123456789012:organization/m-1234EXAMPLEabcd1234abcd1234abcd1234

--log-type (строка)

Определяет тип журнала, который отправляет источник.

  • Для Amazon Bedrock допустимое значение является APPLICATION_LOGS.
  • Для CloudFront допустимое значение является ACCESS_LOGS.
  • Для Amazon CodeWhisperer допустимое значение является EVENT_LOGS.
  • Для Elemental MediaPackage допустимые значения являются EGRESS_ACCESS_LOGS и INGRESS_ACCESS_LOGS.
  • Для Elemental MediaTailor допустимые значения являются AD_DECISION_SERVER_LOGS, MANIFEST_SERVICE_LOGS и TRANSCODE_LOGS.
  • Для IAM Identity Center допустимое значение является ERROR_LOGS.
  • Для Amazon Q допустимое значение является EVENT_LOGS.
  • Для Amazon SES mail manager допустимое значение является APPLICATION_LOG.
  • Для Amazon WorkMail допустимые значения являются ACCESS_CONTROL_LOGS, AUTHENTICATION_LOGS, WORKMAIL_AVAILABILITY_PROVIDER_LOGS, WORKMAIL_MAILBOX_ACCESS_LOGS и WORKMAIL_PERSONAL_ACCESS_TOKEN_LOGS.

--tags (карта)

Необязательный список пар ключ-значение для ассоциации с ресурсом.

Дополнительную информацию о тегах см. в разделе Тегирование ресурсов Amazon Web Services

ключ -> (строка)

значение -> (строка)

Упрощенный синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "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
  • текст
  • таблица
  • 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.

Вывод

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

Структура, содержащая информацию об источнике доставки, который был только что создан или обновлен.

name -> (строка)

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

arn -> (строка)

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

resourceArns -> (список)

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

(строка)

service -> (строка)

Служба Amazon Web Services, которая отправляет журналы.

logType -> (строка)

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

tags -> (карта)

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

ключ -> (строка)

значение -> (строка)

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

Spec-Zone.ru

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