Spec-Zone.ru › AWS CLI v2

[ aws . logs ]

put-destination

Описание

Создаёт или обновляет пункт назначения. Данная операция используется только для создания пунктов назначения для подписок между учётными записями.

Пункт назначения представляет собой физический ресурс (например, Amazon Kinesis stream). С помощью пункта назначения можно подписаться на потоковое событие журналов в реальном времени для другой учётной записи, введённое с помощью PutLogEvents.

Пункт назначения контролирует, что записывается в него, с помощью политики доступа. По умолчанию PutDestination не устанавливает никакой политики доступа вместе с пунктом назначения, что означает, что пользователь другой учётной записи не может вызвать PutSubscriptionFilter для этого пункта назначения. Чтобы включить это, владелец пункта назначения должен вызвать PutDestinationPolicy после PutDestination.

Чтобы выполнить операцию PutDestination, вам также необходимо иметь разрешение iam:PassRole.

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

Синтаксис

  put-destination
--destination-name <value>
--target-arn <value>
--role-arn <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]

Параметры

--destination-name (строка)

Имя пункта назначения.

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

ARN потока Amazon Kinesis, в который нужно отправлять соответствующие события журналов.

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

ARN роли IAM, которая предоставляет CloudWatch Logs разрешения на вызов операции Amazon Kinesis PutRecord в потоке пункта назначения.

--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-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

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

Пункт назначения.

destinationName -> (строка)

Имя пункта назначения.

targetArn -> (строка)

Amazon Resource Name (ARN) физической цели, в которую доставляются события журналов (например, поток Kinesis).

roleArn -> (строка)

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

accessPolicy -> (строка)

Документ политики IAM, определяющий, какие учётные записи Amazon Web Services могут создавать фильтры подписки для данного пункта назначения.

arn -> (строка)

ARN данного пункта назначения.

creationTime -> (длинное число)

Время создания пункта назначения, выраженное в миллисекундах после 00:00:00 UTC 1 января 1970 года.

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

Spec-Zone.ru

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