DeleteConfigurationPolicy
Deletes a configuration policy. Only the AWS Security Hub delegated administrator can invoke this operation
from the home Region. For the deletion to succeed, you must first disassociate a configuration policy from target accounts,
organizational units, or the root by invoking the StartConfigurationPolicyDisassociation operation.
Request Syntax
DELETE /configurationPolicy/Identifier HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- Identifier
-
The Amazon Resource Name (ARN) or universally unique identifier (UUID) of the configuration policy.
Pattern:
.*\S.*Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You don't have permission to perform the action specified in the request.
HTTP Status Code: 403
- InternalException
-
Internal server error.
HTTP Status Code: 500
- InvalidAccessException
-
The account doesn't have permission to perform this action.
HTTP Status Code: 401
- InvalidInputException
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
HTTP Status Code: 400
- LimitExceededException
-
The request was rejected because it attempted to create resources beyond the current AWS account or throttling limits. The error code describes the limit exceeded.
HTTP Status Code: 429
- ResourceConflictException
-
The resource specified in the request conflicts with an existing resource.
HTTP Status Code: 409
- ResourceNotFoundException
-
The request was rejected because we can't find the specified resource.
HTTP Status Code: 404
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
