Skip to content

CloudFront  >  Operations  >  associate_distribution_web_acl

associate_distribution_web_acl

Operation

associate_distribution_web_acl async

associate_distribution_web_acl(input: AssociateDistributionWebACLInput, plugins: list[Plugin] | None = None) -> AssociateDistributionWebACLOutput

Associates the WAF web ACL with a distribution.

Parameters:

Name Type Description Default
input AssociateDistributionWebACLInput

An instance of AssociateDistributionWebACLInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
AssociateDistributionWebACLOutput

An instance of AssociateDistributionWebACLOutput.

Input

AssociateDistributionWebACLInput dataclass

Bases: _SerdeShape

Dataclass for AssociateDistributionWebACLInput structure.

Attributes

id class-attribute instance-attribute
id: str | None = ...

The ID of the distribution.

if_match class-attribute instance-attribute
if_match: str | None = ...

The value of the ETag header that you received when retrieving the distribution that you're associating with the WAF web ACL.

web_acl_arn class-attribute instance-attribute
web_acl_arn: str | None = ...

The Amazon Resource Name (ARN) of the WAF web ACL to associate.

Output

AssociateDistributionWebACLOutput dataclass

Bases: _SerdeShape

Dataclass for AssociateDistributionWebACLOutput structure.

Attributes

e_tag class-attribute instance-attribute
e_tag: str | None = ...

The current version of the distribution.

id class-attribute instance-attribute
id: str | None = ...

The ID of the distribution.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

web_acl_arn class-attribute instance-attribute
web_acl_arn: str | None = ...

The ARN of the WAF web ACL that you associated with the distribution.