调用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. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |
访问错误中心查看更多错误码。
文档内容是否对您有帮助?