Submits a task for creating a domain name system (DNS) server.
Description
You can call the QueryTaskDetailListoperation to query the running result of the task.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | SaveSingleTaskForCreatingDnsHost |
The operation that you want to perform. Set the value to SaveSingleTaskForCreatingDnsHost. |
DnsName | String | Yes | dns1 |
The name of the DNS server. |
InstanceId | String | Yes | S1234567890 |
The instance ID of the domain name. You can call the QueryDomainListoperation to query the instance ID. |
Ip.N | RepeatList | Yes | 218.xx.xx.236 |
The IP addresses of the DNS servers. You can specify a maximum of 13 IP addresses. If you want to specify multiple IP addresses, specify this parameter by using an IP address list. |
Lang | String | No | en |
The language of the error message returned. Valid values:
Default value: en. |
UserClientIp | String | No | 127.0.0.1 |
The IP address of the client that is used to submit the task. Set the value to 127.0.0.1. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 0F1B3547-BE50-4206-8F78-9540FFB85BC1 |
The ID of the request. |
TaskNo | String | e9b8e8b4-7334-4548-9cec-c30b6891f292 |
The ID of the task that was submitted. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=SaveSingleTaskForCreatingDnsHost
&DnsName=dns1
&InstanceId=S1234567890
&Ip.1=218.xx.xx.236
&<Common request parameters>
Sample success responses
XML
format
<SaveSingleTaskForCreatingDnsHostResponse>
<TaskNo>e9b8e8b4-7334-4548-9cec-c30b6891f292</TaskNo>
<RequestId>0F1B3547-BE50-4206-8F78-9540FFB85BC1</RequestId>
</SaveSingleTaskForCreatingDnsHostResponse>
JSON
format
{
"requestId": "0F1B3547-BE50-4206-8F78-9540FFB85BC1",
"taskNo": "e9b8e8b4-7334-4548-9cec-c30b6891f292"
}
Error codes
For a list of error codes, visit the API Error Center.