All Products
Search
Document Center

Smart Access Gateway:UpdateSmartAccessGatewayDns

Last Updated:Mar 29, 2024

Modifies the DNS configuration of an SCG5000 or SCG5000-5G device whose version is 3.4.2 or later.

Operation description

You can modify the DNS configuration only of SCG5000 and SCG5000-5G devices whose version is 3.4.2 or later.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
SagInsIdstringYes

The ID of the Smart Access Gateway (SAG) instance.

sag-3manef62evrfr6****
SagSnstringYes

The serial number of the SAG device.

sagf4ea****
RegionIdstringYes

The region ID of the SAG instance.

You can call the DescribeRegions operation to query the most recent region list.

cn-shanghai
MasterDnsstringNo

The IP address of the primary DNS server.

10.10.XX.XX
SlaveDnsstringNo

The IP address of the secondary DNS server.

10.10.XX.XX
CrossAccountbooleanNo

Specifies whether to query only the SAG instances that belong to another Alibaba Cloud account. Valid values:

  • false (default)
  • true
false
ResourceUidstringNo

The ID of the Alibaba Cloud account to which the SAG instance belongs.

147304382796****

Response parameters

ParameterTypeDescriptionExample
object
Codestring

The error code. A value of 200 indicates that the task is successful.

200
Successboolean

Indicates whether the call is successful. Valid values:

  • true
  • false
true
RequestIdstring

The request ID.

AE9B6C13-86D3-5E56-8C05-BBE58C2BE671
Messagestring

The response message. A value of Successful indicates that the task is successful.

Successful

Examples

Sample success responses

JSONformat

{
  "Code": "200",
  "Success": true,
  "RequestId": "AE9B6C13-86D3-5E56-8C05-BBE58C2BE671",
  "Message": "Successful"
}

Error codes

HTTP status codeError codeError messageDescription
400GATEWAY.InvalidSNThe specified gateway serial number does not exist.-
400InternalErrorInternal server error-
400SAG.InstanceNoFoundThe specified SAG instance does not exist.The specified SAG instance does not exist.
400SAG.SoftwareNotSupportThe specified software instance does not support ACL.-
400SmartAccessGatewayNotActivatedThe specified Smart Access Gateway has not been activated.The specified SAG instance is inactive. You must activate the instance first.
400DeviceNotExistThe specified device does not exist-
400MissParameter.GatewayIdThe input parameter GatewayId that is mandatory for processing this model is not supplied.-
400InvalidParameter.MasterDnsThe input parameter MasterDns is illegal, please check your input.-
400InvalidParameter.SlaveDnsThe input parameter SlaveDns is illegal, please check your input.-
400InvalidSpec.FeatureNotSupportThe current edition of the cloudbranch does not support this feature.-
400FeatureNotSupportThe current edition of the smart access gateway does not support this feature.The current version of Smart Access Gateway does not support this feature.

For a list of error codes, visit the Service error codes.