DeleteAccelerator
Delete an accelerator. Before you can delete an accelerator, you must disable it and remove all dependent resources
(listeners and endpoint groups). To disable the accelerator, update the accelerator to set Enabled
to false.
Important
When you create an accelerator, by default, Global Accelerator provides you with a set of two static IP addresses. Alternatively, you can bring your own IP address ranges to Global Accelerator and assign IP addresses from those ranges.
The IP addresses are assigned to your accelerator for as long as it exists, even if you disable the accelerator and it no longer accepts or routes traffic. However, when you delete an accelerator, you lose the static IP addresses that are assigned to the accelerator, so you can no longer route traffic by using them. As a best practice, ensure that you have permissions in place to avoid inadvertently deleting accelerators. You can use IAM policies with Global Accelerator to limit the users who have permissions to delete an accelerator. For more information, see Identity and access management in the AWS Global Accelerator Developer Guide.
Request Syntax
{
"AcceleratorArn": "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.
- AcceleratorArn
-
The Amazon Resource Name (ARN) of an accelerator.
Type: String
Length Constraints: Maximum length of 255.
Required: Yes
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.
- AcceleratorNotDisabledException
-
The accelerator that you specified could not be disabled.
HTTP Status Code: 400
- AcceleratorNotFoundException
-
The accelerator that you specified doesn't exist.
HTTP Status Code: 400
- AssociatedListenerFoundException
-
The accelerator that you specified has a listener associated with it. You must remove all dependent resources from an accelerator before you can delete it.
HTTP Status Code: 400
- InternalServiceErrorException
-
There was an internal error for AWS Global Accelerator.
HTTP Status Code: 400
- InvalidArgumentException
-
An argument that you specified is invalid.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: