AWS::WAFRegional::WebACLAssociation
Note
This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide.
For the latest version of AWS WAF , use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.
The AWS::WAFRegional::WebACLAssociation resource associates an AWS WAF Regional web access control group (ACL) with a resource.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "Type" : "AWS::WAFRegional::WebACLAssociation", "Properties" : { "ResourceArn" :
String
, "WebACLId" :String
} }
YAML
Type: AWS::WAFRegional::WebACLAssociation Properties: ResourceArn:
String
WebACLId:String
Properties
ResourceArn
-
The Amazon Resource Name (ARN) of the resource to protect with the web ACL.
Required: Yes
Type: String
Update requires: Replacement
WebACLId
-
A unique identifier (ID) for the web ACL.
Required: Yes
Type: String
Update requires: Replacement
Return values
Fn::GetAtt
Examples
Associate an Application Load Balancer resource with a web ACL
The following example associates an Application Load Balancer resource with a web ACL.
JSON
"MyWebACLAssociation": { "Type": "AWS::WAFRegional::WebACLAssociation", "Properties": { "ResourceArn": { "Ref": "MyLoadBalancer" }, "WebACLId": { "Ref": "MyWebACL" } } }
YAML
MyWebACLAssociation: Type: "AWS::WAFRegional::WebACLAssociation" Properties: ResourceArn: Ref: MyLoadBalancer WebACLId: Ref: MyWebACL