Description
Deletes the domain name based on input parameters. Given its unique nature, you are not allowed to delete the HiChina domain name in the DNS API. Non-existent domain names include unregistered domain names, domain names non-existent under an account, or malformed domain names in the request parameters.
Request Parameters
| Name | Type | Required? | Description |
|---|---|---|---|
| Action | String | Yes | Operator interface name, required parameter, value:DeleteDomain |
| DomainName | String | Yes | Domain name |
Return Parameters
Public return parameters. For details, see Public Return Parameters
| Name | Type | Description |
|---|---|---|
| RequestId | String | The unique request identifier |
| DomainName | String | Domain name |
Error Codes
For errors common to all interfaces, please refer to the Error Code Table.
| Error Code | Description | HTTP Status Code | Meaning |
|---|---|---|---|
| IncorrectDomainUser | The domain name does not belong to this user. | 400 | The domain name does not exist under this account |
| Forbidden.DomainType | The domain is forbidden to operate because it is a hichina domain. | 400 | The domain name is an HiChina domain name and cannot be deleted |
| Fobidden.RecordLocked | The domain is forbidden to delete because there are some records have been locked. | 400 | Locked resolution records exist for the domain name |
| RecordFobidden.BlackHole | The action could not be completed because there are some recrods have been into black hole. | 400 | DNS Protection is in the black hole mode |
| RecordForbidden.DNSChange | The action could not be completed because DNS is changing. | 400 | This operation is forbidden due to DNS migration |
Example
Request Example
http://dns.aliyuncs.com/?Action=DeleteDomain
&DomainName=example.com
&<Public Request Parameters>
Return Example
XML Format
<DeleteDomainResponse>
<RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
<DomainName>example.com</DomainName>
</DeleteDomainResponse>
JSON Example
{
"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
"DomainName": "example.com"
}