Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

AssociateDistributionWebACL

Associates the Amazon WAF web ACL with a distribution.

Request Syntax


PUT /2020-05-31/distribution/Id/associate-web-acl HTTP/1.1
If-Match: IfMatch
<?xml version="1.0" encoding="UTF-8"?>
<AssociateDistributionWebACLRequest xmlns="http://cloudfront.amazonaws.com/doc/2020-05-31/">
   <WebACLArn>string</WebACLArn>
</AssociateDistributionWebACLRequest>

URI Request Parameters

The request uses the following URI parameters.

Id

The ID of the distribution.

Required: Yes

If-Match

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

Request Body

The request accepts the following data in XML format.

AssociateDistributionWebACLRequest

Root level tag for the AssociateDistributionWebACLRequest parameters.

Required: Yes

WebACLArn

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

Type: String

Required: Yes

Response Syntax


HTTP/1.1 200
ETag: ETag
<?xml version="1.0" encoding="UTF-8"?>
<AssociateDistributionWebACLResult>
   <Id>string</Id>
   <WebACLArn>string</WebACLArn>
</AssociateDistributionWebACLResult>

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The response returns the following HTTP headers.

ETag: The current version of the distribution.

The following data is returned in XML format by the service.

AssociateDistributionWebACLResult

Root level tag for the AssociateDistributionWebACLResult parameters.

Required: Yes

Id

The ID of the distribution.

Type: String

WebACLArn

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

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDenied

Access denied.

HTTP Status Code: 403

EntityNotFound

The entity was not found.

HTTP Status Code: 404

InvalidArgument

An argument is invalid.

HTTP Status Code: 400

InvalidIfMatchVersion

The If-Match version is missing or not valid.

HTTP Status Code: 400

PreconditionFailed

The precondition in one or more of the request fields evaluated to false.

HTTP Status Code: 412