You can call this operation to submit a task for modifying a domain name system (DNS) host.

You can call the QueryTaskDetailList operation to query the execution result.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes SaveSingleTaskForModifyingDnsHost

[DO NOT TRANSLATE] Set the value to SaveSingleTaskForModifyingDnsHost.

DnsName String Yes dns1

The name of the DNS server corresponding to the DNS host that you want to modify.

InstanceId String Yes S123456789

The instance ID of the domain name for which you want to modify the DNS host. You can call the QueryDomainList operation to query the instance ID.

Ip.N RepeatList Yes 218.xx.xx.236

The list of IP addresses.

Lang String No en

The language of the error message to return. Valid values:

  • zh: Chinese
  • en: English

Default value: en

UserClientIp String No 127.0.0.1

The IP address of the client used by the user to submit the task.

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.

Examples

Sample requests


http://domain.aliyuncs.com/?Action=SaveSingleTaskForModifyingDnsHost
&DnsName=ns3
&Ip.2=185.xx.xx.201
&Ip.1=218.xx.xx.236
&<Common request parameters>

Sample success responses

XML format

<SaveSingleTaskForModifyingDnsHostResponse>
  <TaskNo>e9b8e8b4-7334-4548-9cec-c30b6891f292</TaskNo>
  <RequestId>0F1B3547-BE50-4206-8F78-9540FFB85BC1</RequestId>
</SaveSingleTaskForModifyingDnsHostResponse>

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.