edit-icon download-icon

Deleting Domain Names

Last Updated: May 27, 2016

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"
}
Thank you! We've received your feedback.