Deletes an access configuration.

Prerequisites

The access configuration that you want to delete is de-provisioned from the accounts in your resource directory. For more information, see DeprovisionAccessConfiguration.

Usage notes

This topic provides an example on how to delete the access configuration whose ID is ac-001j9mcm3k7335bc****.

Limits

You can call this operation up to 100 times per second per account. This operation is globally limited to 100 times per second across all accounts. If the number of the calls per second exceeds a limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limits when you call this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteAccessConfiguration

The operation that you want to perform. Set the value to DeleteAccessConfiguration.

AccessConfigurationId String Yes ac-001j9mcm3k7335bc****

The ID of the access configuration.

DirectoryId String Yes d-00fc2p61****

The ID of the directory.

ForceRemovePermissionPolicies Boolean No false

Specifies whether to forcibly remove system policies and inline policies. Valid values:

  • true: When you delete the access configuration, the associated system policies and inline policies are forcibly removed.
  • false: When you delete the access configuration, the associated system policies and inline policies are not forcibly removed. This is the default value. If these policies exist in the access configuration, the deletion fails. Before you delete the access configuration, you must remove the system policies and inline policies. For more information, see RemovePermissionPolicyFromAccessConfiguration.

For more information about common request parameters, see Common parameters.

Response parameters

Parameter Type Example Description
RequestId String 9B13E4EE-3853-5852-9165-597C32AD8FB7

The ID of the request.

Examples

Sample requests

https://[Endpoint]/?Action=DeleteAccessConfiguration
&AccessConfigurationId=ac-001j9mcm3k7335bc****
&DirectoryId=d-00fc2p61****
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteAccessConfigurationResponse>
    <RequestId>9B13E4EE-3853-5852-9165-597C32AD8FB7</RequestId>
</DeleteAccessConfigurationResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "9B13E4EE-3853-5852-9165-597C32AD8FB7"
}

Error codes

For a list of error codes, visit the API Error Center.