DisassociateAccounts
Disassociates member accounts from your organization's management account, removing centralized automation capabilities. Once disassociated, organization rules no longer apply to the member account, and the management account (or delegated administrator) cannot create Automation rules for that account.
Note
Only the management account or a delegated administrator can perform this action.
Request Syntax
{
"accountIds": [ "string" ],
"clientToken": "string"
}Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- accountIds
-
The IDs of the member accounts to disassociate.
Type: Array of strings
Pattern:
[0-9]{12}Required: Yes
- clientToken
-
A unique identifier to ensure idempotency of the request.
Type: String
Pattern:
[a-zA-Z0-9_-]{1,64}Required: No
Response Syntax
{
"accountIds": [ "string" ],
"errors": [ "string" ]
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- accountIds
-
The IDs of the member accounts that were successfully disassociated.
Type: Array of strings
Pattern:
[0-9]{12} - errors
-
Any errors that occurred during the disassociation process.
Type: Array of strings
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You do not have sufficient permissions to perform this action.
HTTP Status Code: 400
- ForbiddenException
-
You are not authorized to perform this action.
HTTP Status Code: 400
- IdempotencyTokenInUseException
-
The specified client token is already in use.
HTTP Status Code: 400
- IdempotentParameterMismatchException
-
Exception thrown when the same client token is used with different parameters, indicating a mismatch in idempotent request parameters.
HTTP Status Code: 400
- InternalServerException
-
An internal error occurred while processing the request.
HTTP Status Code: 500
- InvalidParameterValueException
-
One or more parameter values are not valid.
HTTP Status Code: 400
- NotManagementAccountException
-
The operation can only be performed by a management account.
HTTP Status Code: 400
- OptInRequiredException
-
The account must be opted in to Compute Optimizer Automation before performing this action.
HTTP Status Code: 400
- ServiceUnavailableException
-
The service is temporarily unavailable.
HTTP Status Code: 500
- ThrottlingException
-
The request was denied due to request throttling.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
