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

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

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
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. 内部错误,请重试。如果多次尝试失败,请提交工单。

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