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 task 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

The operation that you want to perform. 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 corresponding to 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 that you use 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 that was submitted.

Examples

Sample requests

http(s)://[Endpoint]/? Action=SaveSingleTaskForModifyingDnsHost
&DnsName=dns1
&InstanceId=S123456789
&Ip.1=218.xx.xx.236
&<Common request parameters>

Sample success responses

XML format 

<SaveSingleTaskForModifyingDnsHostResponse>
  <requestId>0F1B3547-BE50-4206-8F78-9540FFB85BC1</requestId>
  <taskNo>e9b8e8b4-7334-4548-9cec-c30b6891f292</taskNo>
</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.