调用DescribeGatewayDNS获取网关上配置的DNS服务器信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeGatewayDNS |
系统规定参数。取值:DescribeGatewayDNS。 |
GatewayId | String | 是 | gw-000eg44nmxbsfwbvq*** |
网关ID |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 89398CFB-4EB6-4C7E-BB3C-EF213AC8FA50 |
请求ID。 |
Success | Boolean | true |
请求是否成功。 |
Code | String | 200 |
状态码。状态码为200表示请求成功。 |
Message | String | successful |
请求结果描述。 |
DnsServer | String | 100.100.2.136,100.100.2.188 |
DNS服务IP列表。IP之间用逗号分隔。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeGatewayDNS
&GatewayId=gw-000eg44nmxbsfwbvq***
&<公共请求参数>
正常返回示例
XML
格式
<DescribeGatewayDNSResponse>
<RequestId>ACB4BBBB-9046-4D46-BA93-0737DE78B735</RequestId>
<Message>successful</Message>
<Code>200</Code>
<Success>true</Success>
<DnsServer>100.100.2.136,100.100.2.188</DnsServer>
</DescribeGatewayDNSResponse>
JSON
格式
{
"RequestId":"ACB4BBBB-9046-4D46-BA93-0737DE78B735",
"Message":"successful",
"Code":"200",
"Success":true,
"DnsServer":"100.100.2.136,100.100.2.188"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | GatewayInUpgrading | The gateway is upgrading. Try again later. | 网关正在升级中,请稍后再试。 |
400 | GatewayNotExist | The specified gateway does not exist. You must specify a valid parameter. | 网关不存在,请确认输入参数是否正确。 |
400 | GatewayInOperation | The gateway is processing requests . Try again later. | 网关正在进行操作中,请稍后再试。 |
400 | GatewayStatusRunningRequired | The gateway is not in the Running state. Try again later. | 需要网关为启动状态,请稍后再试。 |
400 | EmptyGatewayId | You must enter a valid ID for the gateway. | 网关ID不能为空。 |
访问错误中心查看更多错误码。