Skip to content

WAFV2Client#

Index > WAFV2 > WAFV2Client

Auto-generated documentation for WAFV2 type annotations stubs module mypy-boto3-wafv2.

WAFV2Client#

Type annotations and code completion for boto3.client("wafv2"). boto3 documentation

# WAFV2Client usage example

from boto3.session import Session
from mypy_boto3_wafv2.client import WAFV2Client

def get_wafv2_client() -> WAFV2Client:
    return Session().client("wafv2")

Exceptions#

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("wafv2").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("wafv2")

try:
    do_something(client)
except (
    client.exceptions.ClientError,
    client.exceptions.WAFAssociatedItemException,
    client.exceptions.WAFConfigurationWarningException,
    client.exceptions.WAFDuplicateItemException,
    client.exceptions.WAFExpiredManagedRuleGroupVersionException,
    client.exceptions.WAFInternalErrorException,
    client.exceptions.WAFInvalidOperationException,
    client.exceptions.WAFInvalidParameterException,
    client.exceptions.WAFInvalidPermissionPolicyException,
    client.exceptions.WAFInvalidResourceException,
    client.exceptions.WAFLimitsExceededException,
    client.exceptions.WAFLogDestinationPermissionIssueException,
    client.exceptions.WAFNonexistentItemException,
    client.exceptions.WAFOptimisticLockException,
    client.exceptions.WAFServiceLinkedRoleErrorException,
    client.exceptions.WAFSubscriptionNotFoundException,
    client.exceptions.WAFTagOperationException,
    client.exceptions.WAFTagOperationInternalErrorException,
    client.exceptions.WAFUnavailableEntityException,
    client.exceptions.WAFUnsupportedAggregateKeyTypeException,
) as e:
    print(e)
# Exceptions.exceptions type checking example

from mypy_boto3_wafv2.client import Exceptions

def handle_error(exc: Exceptions.ClientError) -> None:
    ...

Methods#

associate_web_acl#

Associates a web ACL with a regional application resource, to protect the resource.

Type annotations and code completion for boto3.client("wafv2").associate_web_acl method. boto3 documentation

# associate_web_acl method definition

def associate_web_acl(
    self,
    *,
    WebACLArn: str,
    ResourceArn: str,
) -> Dict[str, Any]:
    ...
# associate_web_acl method usage example with argument unpacking

kwargs: AssociateWebACLRequestRequestTypeDef = {  # (1)
    "WebACLArn": ...,
    "ResourceArn": ...,
}

parent.associate_web_acl(**kwargs)
  1. See AssociateWebACLRequestRequestTypeDef

can_paginate#

Check if an operation can be paginated.

Type annotations and code completion for boto3.client("wafv2").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

check_capacity#

Returns the web ACL capacity unit (WCU) requirements for a specified scope and set of rules.

Type annotations and code completion for boto3.client("wafv2").check_capacity method. boto3 documentation

# check_capacity method definition

def check_capacity(
    self,
    *,
    Scope: ScopeType,  # (1)
    Rules: Sequence[RuleTypeDef],  # (2)
) -> CheckCapacityResponseTypeDef:  # (3)
    ...
  1. See ScopeType
  2. See RuleTypeDef
  3. See CheckCapacityResponseTypeDef
# check_capacity method usage example with argument unpacking

kwargs: CheckCapacityRequestRequestTypeDef = {  # (1)
    "Scope": ...,
    "Rules": ...,
}

parent.check_capacity(**kwargs)
  1. See CheckCapacityRequestRequestTypeDef

close#

Closes underlying endpoint connections.

Type annotations and code completion for boto3.client("wafv2").close method. boto3 documentation

# close method definition

def close(
    self,
) -> None:
    ...

create_api_key#

Creates an API key that contains a set of token domains.

Type annotations and code completion for boto3.client("wafv2").create_api_key method. boto3 documentation

# create_api_key method definition

def create_api_key(
    self,
    *,
    Scope: ScopeType,  # (1)
    TokenDomains: Sequence[str],
) -> CreateAPIKeyResponseTypeDef:  # (2)
    ...
  1. See ScopeType
  2. See CreateAPIKeyResponseTypeDef
# create_api_key method usage example with argument unpacking

kwargs: CreateAPIKeyRequestRequestTypeDef = {  # (1)
    "Scope": ...,
    "TokenDomains": ...,
}

parent.create_api_key(**kwargs)
  1. See CreateAPIKeyRequestRequestTypeDef

create_ip_set#

Creates an IPSet, which you use to identify web requests that originate from specific IP addresses or ranges of IP addresses.

Type annotations and code completion for boto3.client("wafv2").create_ip_set method. boto3 documentation

# create_ip_set method definition

def create_ip_set(
    self,
    *,
    Name: str,
    Scope: ScopeType,  # (1)
    IPAddressVersion: IPAddressVersionType,  # (2)
    Addresses: Sequence[str],
    Description: str = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (3)
) -> CreateIPSetResponseTypeDef:  # (4)
    ...
  1. See ScopeType
  2. See IPAddressVersionType
  3. See TagTypeDef
  4. See CreateIPSetResponseTypeDef
# create_ip_set method usage example with argument unpacking

kwargs: CreateIPSetRequestRequestTypeDef = {  # (1)
    "Name": ...,
    "Scope": ...,
    "IPAddressVersion": ...,
    "Addresses": ...,
}

parent.create_ip_set(**kwargs)
  1. See CreateIPSetRequestRequestTypeDef

create_regex_pattern_set#

Creates a RegexPatternSet, which you reference in a RegexPatternSetReferenceStatement, to have WAF inspect a web request component for the specified patterns.

Type annotations and code completion for boto3.client("wafv2").create_regex_pattern_set method. boto3 documentation

# create_regex_pattern_set method definition

def create_regex_pattern_set(
    self,
    *,
    Name: str,
    Scope: ScopeType,  # (1)
    RegularExpressionList: Sequence[RegexTypeDef],  # (2)
    Description: str = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (3)
) -> CreateRegexPatternSetResponseTypeDef:  # (4)
    ...
  1. See ScopeType
  2. See RegexTypeDef
  3. See TagTypeDef
  4. See CreateRegexPatternSetResponseTypeDef
# create_regex_pattern_set method usage example with argument unpacking

kwargs: CreateRegexPatternSetRequestRequestTypeDef = {  # (1)
    "Name": ...,
    "Scope": ...,
    "RegularExpressionList": ...,
}

parent.create_regex_pattern_set(**kwargs)
  1. See CreateRegexPatternSetRequestRequestTypeDef

create_rule_group#

Creates a RuleGroup per the specifications provided.

Type annotations and code completion for boto3.client("wafv2").create_rule_group method. boto3 documentation

# create_rule_group method definition

def create_rule_group(
    self,
    *,
    Name: str,
    Scope: ScopeType,  # (1)
    Capacity: int,
    VisibilityConfig: VisibilityConfigTypeDef,  # (2)
    Description: str = ...,
    Rules: Sequence[RuleTypeDef] = ...,  # (3)
    Tags: Sequence[TagTypeDef] = ...,  # (4)
    CustomResponseBodies: Mapping[str, CustomResponseBodyTypeDef] = ...,  # (5)
) -> CreateRuleGroupResponseTypeDef:  # (6)
    ...
  1. See ScopeType
  2. See VisibilityConfigTypeDef
  3. See RuleTypeDef
  4. See TagTypeDef
  5. See CustomResponseBodyTypeDef
  6. See CreateRuleGroupResponseTypeDef
# create_rule_group method usage example with argument unpacking

kwargs: CreateRuleGroupRequestRequestTypeDef = {  # (1)
    "Name": ...,
    "Scope": ...,
    "Capacity": ...,
    "VisibilityConfig": ...,
}

parent.create_rule_group(**kwargs)
  1. See CreateRuleGroupRequestRequestTypeDef

create_web_acl#

Creates a WebACL per the specifications provided.

Type annotations and code completion for boto3.client("wafv2").create_web_acl method. boto3 documentation

# create_web_acl method definition

def create_web_acl(
    self,
    *,
    Name: str,
    Scope: ScopeType,  # (1)
    DefaultAction: DefaultActionTypeDef,  # (2)
    VisibilityConfig: VisibilityConfigTypeDef,  # (3)
    Description: str = ...,
    Rules: Sequence[RuleTypeDef] = ...,  # (4)
    Tags: Sequence[TagTypeDef] = ...,  # (5)
    CustomResponseBodies: Mapping[str, CustomResponseBodyTypeDef] = ...,  # (6)
    CaptchaConfig: CaptchaConfigTypeDef = ...,  # (7)
    ChallengeConfig: ChallengeConfigTypeDef = ...,  # (8)
    TokenDomains: Sequence[str] = ...,
    AssociationConfig: AssociationConfigTypeDef = ...,  # (9)
) -> CreateWebACLResponseTypeDef:  # (10)
    ...
  1. See ScopeType
  2. See DefaultActionTypeDef
  3. See VisibilityConfigTypeDef
  4. See RuleTypeDef
  5. See TagTypeDef
  6. See CustomResponseBodyTypeDef
  7. See CaptchaConfigTypeDef
  8. See ChallengeConfigTypeDef
  9. See AssociationConfigTypeDef
  10. See CreateWebACLResponseTypeDef
# create_web_acl method usage example with argument unpacking

kwargs: CreateWebACLRequestRequestTypeDef = {  # (1)
    "Name": ...,
    "Scope": ...,
    "DefaultAction": ...,
    "VisibilityConfig": ...,
}

parent.create_web_acl(**kwargs)
  1. See CreateWebACLRequestRequestTypeDef

delete_api_key#

Deletes the specified API key.

Type annotations and code completion for boto3.client("wafv2").delete_api_key method.