You can call this operation to modify the DNS settings of a Smart Access Gateway (SAG) instance associated with SAG APP.


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 No ModifyClientUserDNS

The operation that you want to perform.

Set the value to ModifyClientUserDNS.

RegionId String Yes cn-shanghai

The ID of the region where the SAG instance associated with SAG APP is deployed.

SmartAGId String Yes sag-9uyg53s6juhpxv****

The ID of the SAG instance that is associated with SAG APP.

AppDNS.N RepeatList No 100.XX.XX.100

The active and standby DNS servers that the SAG instance uses to connect to the private network.

  • If PrivateZone is used to connect the private network to Alibaba Cloud, set the DNS server addresses to and
  • For Android and macOS operating systems, you must use SAG APP 2.1.1 and later to configure DNS settings.
  • This parameter is optional. If you do not specify the DNS server addresses, the system does not set this parameter and clears the existing value.
RecoveredDNS.N RepeatList No 100.XX.XX.110

The active and standby DNS servers that the SAG instance uses to disconnect from the private network.

Note This feature will be available soon.

Response parameters

Parameter Type Example Description
RequestId String BFE2D0C0-B69F-422D-A8A3-928AD511B471

The ID of the request.


Sample requests

http(s)://[Endpoint]/? Action=ModifyClientUserDNS
&<Common request parameters>

Sample success responses

XML format


JSON format

    "RequestId": "BFE2D0C0-B69F-422D-A8A3-928AD511B471"

Error codes

HttpCode Error code Error message Description
400 InvalidParam.Ip The specified IP address is invalid. The error message returned because the specified IP address is invalid.

For a list of error codes, visit the API Error Center.