DeleteResponseHeadersPolicy
Deletes a response headers policy.
You cannot delete a response headers policy if it's attached to a cache behavior. First update your distributions to remove the response headers policy from all cache behaviors, then delete the response headers policy.
To delete a response headers policy, you must provide the policy's identifier and
version. To get these values, you can use ListResponseHeadersPolicies or
GetResponseHeadersPolicy.
Request Syntax
DELETE /2020-05-31/response-headers-policy/Id HTTP/1.1
If-Match: IfMatch
URI Request Parameters
The request uses the following URI parameters.
- Id
-
The identifier for the response headers policy that you are deleting.
To get the identifier, you can use
ListResponseHeadersPolicies.Required: Yes
- If-Match
-
The version of the response headers policy that you are deleting.
The version is the response headers policy's
ETagvalue, which you can get usingListResponseHeadersPolicies,GetResponseHeadersPolicy, orGetResponseHeadersPolicyConfig.
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 204
Response Elements
If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDenied
-
Access denied.
HTTP Status Code: 403
- IllegalDelete
-
Deletion is not allowed for this entity.
HTTP Status Code: 400
- InvalidIfMatchVersion
-
The
If-Matchversion is missing or not valid.HTTP Status Code: 400
- NoSuchResponseHeadersPolicy
-
The response headers policy does not exist.
HTTP Status Code: 404
- PreconditionFailed
-
The precondition in one or more of the request fields evaluated to
false.HTTP Status Code: 412
- ResponseHeadersPolicyInUse
-
Cannot delete the response headers policy because it is attached to one or more cache behaviors in a CloudFront distribution.
HTTP Status Code: 409
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
