调用ViewSmartAccessGatewayDnsForwards查询DNS转发列表_智能接入网关(SAG)-阿里云帮助中心

查询DNS转发列表，适用于设备类型为SCG5000或SCG5000-5G的智能接入网关实例，且设备版本为3.4.2及以上。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
smartag:ViewSmartAccessGatewayDnsForwards	Read	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
SagInsId	string	是	网关实例 id	sag-v9un1ccz22owd76lf8
SagSn	string	是	设备 SN	sagf4dkqh78
RegionId	string	是	智能接入网关实例所属的地域 ID	cn-shanghai

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	E223E535-AE11-4158-B00F-DC107887A909
Success	boolean	是否成功	true
Code	string	响应码	200
Message	string	返回信息	Successful
HttpStatusCode	integer	HTTP 状态码	200
Count	integer	总条数。	1914
Data	object []	DNS 转发实例列表
InstanceId	string	实例 ID。	sagv3dnsforward-nc7qabskj17werc7su
Domain	string	域名	www.baidu.com
MasterIp	string	主 DNS	172.16.58.20
SlaveIp	string	备 DNS	172.16.0.14
Mode	string	转发模式说明无效字段，不用关注。	first
OutboundPortType	string	出接口类型枚举值： Tunnel：Tunnel。 PhysicalPort：PhysicalPort。 None：None。	PhysicalPort
OutboundPortIndex	integer	出接口序号枚举值： 0：0。 2：2。	0
OutboundPortName	string	出接口枚举值： eth0：eth0。 lte：lte。	eth0

示例

正常返回示例

JSON格式

{
  "RequestId": "E223E535-AE11-4158-B00F-DC107887A909",
  "Success": true,
  "Code": "200",
  "Message": "Successful",
  "HttpStatusCode": 200,
  "Count": 1914,
  "Data": [
    {
      "InstanceId": "sagv3dnsforward-nc7qabskj17werc7su",
      "Domain": "www.baidu.com",
      "MasterIp": "172.16.58.20",
      "SlaveIp": "172.16.0.14",
      "Mode": "first",
      "OutboundPortType": "PhysicalPort",
      "OutboundPortIndex": 0,
      "OutboundPortName": "eth0"
    }
  ]
}

错误码

访问错误中心查看更多错误码。