The SaveSingleTaskForModifyingDnsHost API submits a DNS host modification task. 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 SaveSingleTaskForModifyingDnsHost.
InstanceId String Yes  Instance ID. You can query it by using QueryDomainList API.
DnsName String Yes For example: dns1.
Ips IpListType Yes IP address list.
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.
Table 1. IpListType
Parameter Type Description
ip String IP address.

Return parameters

Parameter Type Description
RequestId String The unique request ID.
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
? Action=SaveSingleTaskForModifyingDnsHost
&Ip. 2=
&Ip. 1=
&<Public request parameters>

Response example

  • XML format
    <? xml version='1.0' encoding='UTF-8'? >
  • JSON format
      "requestId": "0F1B3547-BE50-4206-8F78-9540FFB85BC1",
      "taskNo": "e9b8e8b4-7334-4548-9cec-c30b6891f292"