[ 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 (строка)
--priority (целое число)
Настройка, определяющая порядок обработки группы правил среди групп правил, которые вы связываете со специфицированным VPC. DNS Firewall фильтрует трафик VPC, начиная с группы правил с наименьшим числовым значением приоритета.
Вы должны указать уникальный приоритет для каждой группы правил, которую вы связываете с одним VPC. Чтобы упростить вставку групп правил позже, оставьте пробел между числами, например, используйте 101, 200 и так далее. Вы можете изменить настройку приоритета для ассоциации группы правил после её создания.
Допустимые значения для Priority находятся в диапазоне от 100 до 9900.
--name (строка)
--mutation-protection (строка)
Если включено, эта настройка запрещает изменение или удаление ассоциации, чтобы предотвратить случайное изменение настроек защиты DNS-брандмауэра. При создании ассоциации значение по умолчанию — DISABLED.
Возможные значения:
ENABLEDDISABLED
--tags (список)
Список ключей и значений тегов, которые вы хотите связать с ассоциацией группы правил.
(структура)
Один тег, который вы хотите добавить к указанному ресурсу. Тег состоит из Key (имя тега) и Value (значение тега).
Ключ -> (строка)
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 -> (строка)
FirewallRuleGroupId -> (строка)
VpcId -> (строка)
Имя -> (строка)
Приоритет -> (целое число)
Защита от изменений -> (строка)
Имя управляющего владельца -> (строка)
Статус -> (строка)
Сообщение о статусе -> (строка)
CreatorRequestId -> (строка)
Время создания -> (строка)
Время последнего изменения -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.