associate-web-acl

Описание

Связывает веб-ACL с ресурсом для защиты ресурса.

Используйте этот метод для всех типов ресурсов, кроме распределений Amazon CloudFront. Для Amazon CloudFront вызывайте UpdateDistribution для распределения и предоставьте Amazon Resource Name (ARN) веб-ACL в идентификаторе веб-ACL. Дополнительную информацию см. в разделе UpdateDistribution в Руководстве разработчика Amazon CloudFront.

Требуемые разрешения для управляемых клиентом политиках IAM

Для этого вызова требуются разрешения, специфичные для типа защищаемого ресурса. Подробности см. в разделе Разрешения для AssociateWebACL в Руководстве разработчика WAF.

Временные несоответствия при обновлениях

При создании или изменении веб-ACL или других ресурсов WAF изменения распространяются на все области хранения ресурсов с некоторым временным лагом. Время распространения может составлять от нескольких секунд до нескольких минут.

Ниже приведены примеры временных несоответствий, которые могут наблюдаться во время распространения изменений:

После создания веб-ACL, если вы попытаетесь связать его с ресурсом, вы можете получить исключение, указывающее, что веб-ACL недоступен.
После добавления группы правил в веб-ACL, новые правила группы правил могут применяться в одной области, где используется веб-ACL, и не в другой.
После изменения параметра действия правила вы можете увидеть старое действие в одних местах и новое действие в других.
После добавления IP-адреса в набор IP, который используется в правиле блокировки, новый адрес может быть заблокирован в одной области, в то время как он по-прежнему разрешен в другой.

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

Синтаксис

  associate-web-acl
--web-acl-arn <value>
--resource-arn <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]

Параметры

--web-acl-arn (строка)

Amazon Resource Name (ARN) веб-ACL, который вы хотите связать с ресурсом.

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

Amazon Resource Name (ARN) ресурса, который нужно связать с веб-ACL.

ARN должен иметь один из следующих форматов:

Для балансировщика нагрузки приложения: ``arn:partition :elasticloadbalancing:region :account-id :loadbalancer/app/load-balancer-name /load-balancer-id ``
Для REST API Amazon API Gateway: ``arn:partition :apigateway:region ::/restapis/api-id /stages/stage-name ``
Для GraphQL API AppSync: ``arn:partition :appsync:region :account-id :apis/GraphQLApiId ``
Для пользовательского пула Amazon Cognito: ``arn:partition :cognito-idp:region :account-id :userpool/user-pool-id ``
Для сервиса App Runner: ``arn:partition :apprunner:region :account-id :service/apprunner-service-name /apprunner-service-id ``
Для экземпляра Amazon Web Services Verified Access: ``arn:partition :ec2:region :account-id :verified-access-instance/instance-id ``
Для приложения Amplify: ``arn:partition :amplify:region :account-id :apps/app-id ``

--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 (строка)

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

включено
выключено
автоматически

--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.

Примеры

Примечание

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

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

Связывание веб-ACL с региональным ресурсом AWS

В следующем associate-web-acl примере связывается указанный веб-ACL с балансировщиком нагрузки приложения.

aws wafv2 associate-web-acl \
    --web-acl-arn arn:aws:wafv2:us-west-2:123456789012:regional/webacl/test-cli/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --resource-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/waf-cli-alb/1ea17125f8b25a2a \
    --region us-west-2

Эта команда не выводит никаких данных.

Дополнительную информацию см. в разделе Связывание или Отключение веб-ACL с ресурсом AWS в Руководстве разработчика AWS WAF, AWS Firewall Manager и AWS Shield Advanced.

Вывод

Нет