All Products
Document Center


Last Updated: Apr 18, 2018


The SaveSingleTaskForSynchronizingDnsHost API submits a DNS host synchronization task. This API can be used to handle problems of missing and inconsistent DNS hosts. 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 SaveSingleTaskForSynchronizingDnsHost.
InstanceId String Yes Instance ID.
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. &InstanceId=ST2017120814571100001303
  3. &<Public request parameters>

Response example

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