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

DeleteConfigurationProfile

Deletes a configuration profile.

To prevent users from unintentionally deleting actively-used configuration profiles, enable deletion protection.

Request Syntax


DELETE /applications/ApplicationId/configurationprofiles/ConfigurationProfileId HTTP/1.1
x-amzn-deletion-protection-check: DeletionProtectionCheck

URI Request Parameters

The request uses the following URI parameters.

ApplicationId

The application ID that includes the configuration profile you want to delete.

Pattern: [a-z0-9]{4,7}

Required: Yes

ConfigurationProfileId

The ID of the configuration profile you want to delete.

Pattern: [a-z0-9]{4,7}

Required: Yes

DeletionProtectionCheck

A parameter to configure deletion protection. If enabled, deletion protection prevents a user from deleting a configuration profile if your application has called either GetLatestConfiguration or GetConfiguration for the configuration profile during the specified interval.

This parameter supports the following values:

BYPASS: Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it.
APPLY: Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. APPLY also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks.
ACCOUNT_DEFAULT: The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the UpdateAccountSettings API.

Valid Values: ACCOUNT_DEFAULT | APPLY | BYPASS

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.

BadRequestException

The input fails to satisfy the constraints specified by an AWS service.

HTTP Status Code: 400

ConflictException

The request could not be processed because of conflict in the current state of the resource.

HTTP Status Code: 409

InternalServerException

There was an internal failure in the AWS AppConfig service.

HTTP Status Code: 500

ResourceNotFoundException

The requested resource could not be found.

HTTP Status Code: 404

Examples

Example

This example illustrates one usage of DeleteConfigurationProfile.

Sample Request


DELETE /applications/339ohji/configurationprofiles/ur8hx2f HTTP/1.1
Host: appconfig.us-east-1.amazonaws.com
Accept-Encoding: identity
User-Agent: aws-cli/2.2.4 Python/3.8.8 Linux/5.4.134-73.228.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/off command/appconfig.delete-configuration-profile
X-Amz-Date: 20210920T221708Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20210920/us-east-1/appconfig/aws4_request, SignedHeaders=host;x-amz-date, Signature=39c3b3042cd2aEXAMPLE
Content-Length: 0

Sample Response

{}