put-delivery-destination

Описание

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

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

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

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

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

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

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

Синтаксис

  put-delivery-destination
--name <value>
[--output-format <value>]
--delivery-destination-configuration <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 (строка)

--output-format (строка)

--delivery-destination-configuration (структура)

Сокращённый синтаксис:

destinationResourceArn=string

Синтаксис JSON:

{
  "destinationResourceArn": "string"
}

--tags (карта)

Сокращённый синтаксис:

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
• text
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из вашего файла ключей.

--region (строка)

Используемый регион. Переопределяет настройки конфигурации/окружения.

--version (строка)

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

--color (строка)

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

• on
• off
• auto

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

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматический запрос параметров ввода CLI.

Вывод

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