DeleteDomain
This operation deletes the specified domain. This action is permanent. For more information, see Deleting a domain name registration.
To transfer the domain registration to another registrar, use the transfer process that’s provided by the registrar to which you want to transfer the registration. Otherwise, the following apply:
-
You can’t get a refund for the cost of a deleted domain registration.
-
The registry for the top-level domain might hold the domain name for a brief time before releasing it for other users to register (varies by registry).
-
When the registration has been deleted, we'll send you a confirmation to the registrant contact. The email will come from
noreply@domainnameverification.net
ornoreply@registrar.amazon.com
.
Request Syntax
{
"DomainName": "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.
- DomainName
-
Name of the domain to be deleted.
Type: String
Length Constraints: Maximum length of 255.
Required: Yes
Response Syntax
{
"OperationId": "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.
- OperationId
-
Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.
Type: String
Length Constraints: Maximum length of 255.
Errors
For information about the errors that are common to all actions, see Common Errors.
- DuplicateRequest
-
The request is already in progress for the domain.
HTTP Status Code: 400
- InvalidInput
-
The requested item is not acceptable. For example, for APIs that accept a domain name, the request might specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.HTTP Status Code: 400
- TLDRulesViolation
-
The top-level domain does not support this operation.
HTTP Status Code: 400
- UnsupportedTLD
-
Amazon Route 53 does not support this top-level domain (TLD).
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: