Spec-Zone.ru › AWS CLI v2

[ aws . fms ]

put-resource-set

Описание

Создаёт набор ресурсов.

Набор ресурсов Firewall Manager определяет ресурсы, которые нужно импортировать в политику Firewall Manager из другой службы Amazon Web Services.

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

Синтаксис

  put-resource-set
--resource-set <value>
[--tag-list <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]

Параметры

--resource-set (структура)

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

Id -> (строка)

Уникальный идентификатор набора ресурсов. Этот идентификатор возвращается в ответах команд create и list. Вы используете его для операций update и delete.

Name -> (строка)

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

Description -> (строка)

Описание набора ресурсов.

UpdateToken -> (строка)

Необязательный маркер, который можно использовать для оптимистической блокировки. Firewall Manager возвращает маркер в ваших запросах, которые обращаются к набору ресурсов. Маркер отмечает состояние ресурса набора ресурсов на момент запроса. Маркеры обновления не допускаются при создании набора ресурсов. После создания каждый последующий вызов update для набора ресурсов требует маркер обновления.

Чтобы произвести безусловное изменение набора ресурсов, опустите маркер в запросе обновления. Без маркера Firewall Manager выполняет ваши обновления независимо от того, изменился ли набор ресурсов с момента вашего последнего получения.

Чтобы произвести условное изменение набора ресурсов, укажите маркер в запросе обновления. Firewall Manager использует маркер для проверки того, не изменился ли набор ресурсов с момента вашего последнего получения. Если он изменился, операция завершится ошибкой InvalidTokenException. В этом случае получите набор ресурсов снова, чтобы получить актуальную копию с новым маркером. Примените необходимые изменения, затем повторите операцию с использованием нового маркера.

ResourceTypeList -> (список)

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

(строка)

LastUpdateTime -> (временная метка)

Последнее время изменения набора ресурсов.

ResourceSetStatus -> (строка)

Указывает, находится ли набор ресурсов в пределах области управления администратора в регионе.

  • ACTIVE - Администратор может управлять набором ресурсов и удалять его.
  • OUT_OF_ADMIN_SCOPE - Администратор может просмотреть набор ресурсов, но не может его редактировать или удалять. Действующие средства защиты остаются в силе. Любые новые ресурсы, которые попадают в сферу действия набора ресурсов, не будут защищены.

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

Id=string,Name=string,Description=string,UpdateToken=string,ResourceTypeList=string,string,LastUpdateTime=timestamp,ResourceSetStatus=string

Синтаксис JSON:

{
  "Id": "string",
  "Name": "string",
  "Description": "string",
  "UpdateToken": "string",
  "ResourceTypeList": ["string", ...],
  "LastUpdateTime": timestamp,
  "ResourceSetStatus": "ACTIVE"|"OUT_OF_ADMIN_SCOPE"
}

--tag-list (список)

Получает теги, связанные с указанным набором ресурсов. Теги — это пары ключ:значение, которые вы можете использовать для категоризации и управления вашими ресурсами, например, для выставления счетов. Например, вы можете установить ключ тега на «клиент», а значение на имя или идентификатор клиента. Вы можете указать один или несколько тегов для добавления к каждому ресурсу Amazon Web Services, до 50 тегов на ресурс.

(структура)

Коллекция пар ключ:значение, связанных с ресурсом Amazon Web Services. Пара ключ:значение может быть любой, которую вы определите. Обычно ключ тега представляет категорию (например, «среда»), а значение тега представляет конкретное значение в этой категории (например, «тест», «разработка» или «производство»). Вы можете добавить до 50 тегов к каждому ресурсу Amazon Web Services.

Key -> (строка)

Часть пары ключ:значение, которая определяет тег. Вы можете использовать ключ тега для описания категории информации, например, «клиент». Ключи тегов чувствительны к регистру.

Value -> (строка)

Часть пары ключ:значение, которая определяет тег. Вы можете использовать значение тега для описания конкретного значения в категории, например, «companyA» или «companyB». Значения тегов чувствительны к регистру.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "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
  • таблица
  • 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.

Вывод

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

Подробная информация о наборе ресурсов.

Id -> (строка)

Уникальный идентификатор набора ресурсов. Этот идентификатор возвращается в ответах команд create и list. Вы используете его для операций update и delete.

Name -> (строка)

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

Description -> (строка)

Описание набора ресурсов.

UpdateToken -> (строка)

Необязательный маркер, который можно использовать для оптимистической блокировки. Firewall Manager возвращает маркер в ваших запросах, которые обращаются к набору ресурсов. Маркер отмечает состояние ресурса набора ресурсов на момент запроса. Маркеры обновления не допускаются при создании набора ресурсов. После создания каждый последующий вызов update для набора ресурсов требует маркер обновления.

Чтобы произвести безусловное изменение набора ресурсов, опустите маркер в запросе обновления. Без маркера Firewall Manager выполняет ваши обновления независимо от того, изменился ли набор ресурсов с момента вашего последнего получения.

Чтобы произвести условное изменение набора ресурсов, укажите маркер в запросе обновления. Firewall Manager использует маркер для проверки того, не изменился ли набор ресурсов с момента вашего последнего получения. Если он изменился, операция завершится ошибкой InvalidTokenException. В этом случае получите набор ресурсов снова, чтобы получить актуальную копию с новым маркером. Примените необходимые изменения, затем повторите операцию с использованием нового маркера.

ResourceTypeList -> (список)

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

(строка)

LastUpdateTime -> (временная метка)

Последнее время изменения набора ресурсов.

ResourceSetStatus -> (строка)

Указывает, находится ли набор ресурсов в пределах области управления администратора в регионе.

  • ACTIVE - Администратор может управлять набором ресурсов и удалять его.
  • OUT_OF_ADMIN_SCOPE - Администратор может просмотреть набор ресурсов, но не может его редактировать или удалять. Действующие средства защиты остаются в силе. Любые новые ресурсы, которые попадают в сферу действия набора ресурсов, не будут защищены.

ResourceSetArn -> (строка)

Amazon Resource Name (ARN) набора ресурсов.

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

Spec-Zone.ru

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