Spec-Zone.ru › AWS CLI v2

[ aws . route53resolver ]

associate-firewall-rule-group

Описание

Связывает FirewallRuleGroup с VPC для предоставления фильтрации DNS для VPC.

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

Синтаксис

  associate-firewall-rule-group
[--creator-request-id <value>]
--firewall-rule-group-id <value>
--vpc-id <value>
--priority <value>
--name <value>
[--mutation-protection <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]

Параметры

--creator-request-id (строка)

Уникальная строка, которая идентифицирует запрос и позволяет повторно выполнить не удавшиеся запросы без риска выполнения операции дважды. CreatorRequestId может быть любой уникальной строкой, например, меткой даты/времени.

--firewall-rule-group-id (строка)

Уникальный идентификатор группы правил брандмауэра.

--vpc-id (строка)

Уникальный идентификатор VPC, который вы хотите связать с группой правил.

--priority (целое число)

Настройка, определяющая порядок обработки группы правил среди групп правил, которые вы связываете со специфицированным VPC. DNS Firewall фильтрует трафик VPC, начиная с группы правил с наименьшим числовым значением приоритета.

Вы должны указать уникальный приоритет для каждой группы правил, которую вы связываете с одним VPC. Чтобы упростить вставку групп правил позже, оставьте пробел между числами, например, используйте 101, 200 и так далее. Вы можете изменить настройку приоритета для ассоциации группы правил после её создания.

Допустимые значения для Priority находятся в диапазоне от 100 до 9900.

--name (строка)

Имя, позволяющее идентифицировать ассоциацию для управления и использования.

--mutation-protection (строка)

Если включено, эта настройка запрещает изменение или удаление ассоциации, чтобы предотвратить случайное изменение настроек защиты DNS-брандмауэра. При создании ассоциации значение по умолчанию — DISABLED.

Возможные значения:

  • ENABLED
  • DISABLED

--tags (список)

Список ключей и значений тегов, которые вы хотите связать с ассоциацией группы правил.

(структура)

Один тег, который вы хотите добавить к указанному ресурсу. Тег состоит из Key (имя тега) и Value (значение тега).

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

Имя тега. Например, если вы хотите связать ресурсы Resolver с идентификаторами учётных записей ваших клиентов в целях выставления счетов, значение Key может быть account-id.

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

Значение тега. Например, если Key равно account-id, то Value может быть идентификатором учётной записи клиента, для которого вы создаёте ресурс.

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

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в Руководстве пользователя AWS CLI.

За исключением случаев, когда указано иное, во всех примерах используются правила цитирования, характерные для Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. использование кавычек со строками в Руководстве пользователя AWS CLI.

Для связывания группы правил брандмауэра с VPC

Следующий associate-firewall-rule-group пример связывает группу правил DNS Firewall с Amazon VPC.

aws route53resolver associate-firewall-rule-group \
    --name test-association \
    --firewall-rule-group-id rslvr-frg-47f93271fexample \
    --vpc-id vpc-31e92222 \
    --priority 101

Вывод:

{
    "FirewallRuleGroupAssociation": {
        "Id": "rslvr-frgassoc-57e8873d7example",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group-association/rslvr-frgassoc-57e8873d7example",
        "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
        "VpcId": "vpc-31e92222",
        "Name": "test-association",
        "Priority": 101,
        "MutationProtection": "DISABLED",
        "Status": "UPDATING",
        "StatusMessage": "Creating Firewall Rule Group Association",
        "CreatorRequestId": "2ca1a304-32b3-4f5f-bc4c-EXAMPLE11111",
        "CreationTime": "2021-05-25T21:47:48.755768Z",
        "ModificationTime": "2021-05-25T21:47:48.755768Z"
    }
}

Дополнительную информацию см. в разделе Управление ассоциациями между вашей VPC и группой правил брандмауэра Route 53 Resolver DNS в Руководстве разработчика Amazon Route 53.

Вывод

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

Созданная ассоциация. У ассоциации есть ID, который можно использовать для её идентификации в других запросах, таких как обновление и удаление.

Id -> (строка)

Идентификатор ассоциации.

Arn -> (строка)

Amazon Resource Name (ARN) ассоциации группы правил брандмауэра.

FirewallRuleGroupId -> (строка)

Уникальный идентификатор группы правил брандмауэра.

VpcId -> (строка)

Уникальный идентификатор VPC, связанный с группой правил.

Имя -> (строка)

Имя ассоциации.

Приоритет -> (целое число)

Настройка, определяющая порядок обработки группы правил среди групп правил, связанных с одним VPC. DNS Firewall фильтрует трафик VPC, начиная с группы правил с наименьшим числовым значением приоритета.

Защита от изменений -> (строка)

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

Имя управляющего владельца -> (строка)

Владелец ассоциации, используемый только для ассоциаций, которыми вы не управляете. Если вы используете Firewall Manager для управления вашими DNS Firewall, то это указывает на Firewall Manager как управляющего владельца.

Статус -> (строка)

Текущий статус ассоциации.

Сообщение о статусе -> (строка)

Дополнительная информация о статусе ответа, если доступна.

CreatorRequestId -> (строка)

Уникальная строка, определённая вами для идентификации запроса. Это позволяет повторно выполнять не удавшиеся запросы без риска выполнения операции дважды. Это может быть любая уникальная строка, например, метка времени.

Время создания -> (строка)

Дата и время создания ассоциации в формате Unix-времени и координированном всемирном времени (UTC).

Время последнего изменения -> (строка)

Дата и время последнего изменения ассоциации в формате Unix-времени и координированном всемирном времени (UTC).

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

Spec-Zone.ru

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