All Products
Document Center


Last Updated: Apr 18, 2018


The SaveSingleTaskForCreatingDnsHost API submits a task of creating a DNS host. You can use the QueryTaskDetailList API to query the task execution result.

Request parameters

For more information about public request parameters, see Public parameters.

Parameter Type Required Description
Action String Yes API of the action, system required parameter. Set this parameter to SaveSingleTaskForCreatingDnsHost.
InstanceId String Yes Instance ID
DnsName String Yes For example, “dns1”
Ips IpListType Yes List of IP addresses
Lang String No Language of the error message returned from the API. The enumerated values include zh (Chinese) and en (English). The default value is en.

Response parameters

Parameter Type Description
RequestId String Unique request identifier
TaskNo String Task ID

Error codes

Error code Description HTTP status code Semantics
ParameterIllegal Parameter illegal. 400 Parameter error
NetworkIOError Network IO Error. 400 Network I/O exception
TaskIsBeingProcessed An operation is being processed. Please try again later. 400 An action is being processed for the domain name. Try again later


Request example

  2. &DnsName=ns3
  3. &Ip.2=
  4. &Ip.1=
  5. &<Public request parameters>

Response example

  • XML format
  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <SaveSingleTaskForCreatingDnsHostResponse>
  3. <TaskNo>e9b8e8b4-7334-4548-9cec-c30b6891f292</TaskNo>
  4. <RequestId>0F1B3547-BE50-4206-8F78-9540FFB85BC1</RequestId>
  5. </SaveSingleTaskForCreatingDnsHostResponse>
  • JSON format
  1. {
  2. "requestId": "0F1B3547-BE50-4206-8F78-9540FFB85BC1",
  3. "taskNo": "e9b8e8b4-7334-4548-9cec-c30b6891f292"
  4. }