文档

SetGatewayDNS

更新时间:

调用SetGatewayDNS接口可以给云存储网关添加NDS服务器信息。

调用该接口时,您需要注意:

  • 如果云储存网关原来配置有DNS服务器信息,那么该信息会传入的DNS服务器信息覆盖。
  • 请确认您传入的DNS服务器信息有效。

请求参数

名称 类型 是否必选 示例值 描述
Action String SetGatewayDNS

系统规定参数。取值为SetGatewayDNS。

GatewayId String gw-000c6hshwukkbryp****

网关ID。

DnsServer String 100.100.XX.XX,100.100.XX.XX

DNS服务器的IP列表。如果有多个DNS服务IP,请用逗号分隔。

返回数据

名称 类型 示例值 描述
TaskId String t-000czaedx5koz578****

任务ID。

Message String successful

请求结果描述。

RequestId String 89398CFB-4EB6-4C7E-BB3C-EF213AC8FA**

请求ID。

Code String 200

状态码。状态码为200表示请求成功。

Success Boolean true

请求是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=SetGatewayDNS
&DnsServer=100.100.XX.XX,100.100.XX.XX
&GatewayId=gw-000c6hshwukkbryp****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SetGatewayDNSResponse>
    <TaskId>t-000czaedx5koz578****</TaskId>
    <RequestId>C5A78764-05A4-4E57-87E6-70C6657698**</RequestId>
    <Message>successful</Message>
    <Code>200</Code>
    <Success>true</Success>
</SetGatewayDNSResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TaskId" : "t-000czaedx5koz578****",
  "RequestId" : "C5A78764-05A4-4E57-87E6-70C6657698**",
  "Message" : "successful",
  "Code" : 200,
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidDNS The specified parameter includes one or more invalid IP addresses. You must specify a valid parameter. 参数中有一个或多个IP无效,请修正。
400 EmptyGatewayId You must enter a valid ID for the gateway. 网关ID不能为空。
400 GatewayNotExist The specified gateway does not exist. You must specify a valid parameter. 网关不存在,请确认输入参数是否正确。
400 GatewayInOperation The gateway is processing requests. Try again later. 网关正在进行操作中,请稍后再试。
500 InternalError Unexpected error. Try again later. If the error persists after several tries, we recommend that you submit a ticket. 内部错误,请重试。如果多次尝试失败,请提交工单。

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