链接复制成功!
修改解析器转发规则
功能介绍
修改解析器转发规则。
调用方法
请参见如何调用API。
URI
PUT /v2.1/resolverrules/{resolverrule_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
resolverrule_id |
是 |
String |
转发规则ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
否 |
String |
规则名称。 取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)。 |
ipaddresses |
否 |
Array of IpInfo objects |
规则的目标IP地址。 |
响应参数
状态码:202
参数 |
参数类型 |
描述 |
---|---|---|
resolver_rule |
ResolverRuleParam object |
解析器转发规则。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
转发规则ID。 |
name |
String |
规则名称。 |
domain_name |
String |
域名。 |
endpoint_id |
String |
当前规则所属的终端节点ID。 |
status |
String |
资源状态。 取值范围:PENDING_CREATE, ACTIVE, PENDING_DELETE, ERROR。 |
rule_type |
String |
规则类型。 预留字段,当前默认为FORWARD。 |
ipaddress_count |
Integer |
当前规则下的IP地址数量。 |
create_time |
String |
创建时间。 格式:yyyy-MM-dd'T'HH:mm:ss.SSS。 |
update_time |
String |
更新时间。 格式:yyyy-MM-dd'T'HH:mm:ss.SSS。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
错误码。 |
message |
String |
错误描述。 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
错误码。 |
message |
String |
错误描述。 |
请求示例
修改解析器转发规则的目标IP地址为"1.1.1.1"、"2.2.2.2"。
PUT https://{endpoint}/v2.1/resolverrules/{resolverrule_id}
{
"name" : "rule-xxx",
"ipaddresses" : [ {
"ip" : "1.1.1.1"
}, {
"ip" : "2.2.2.2"
} ]
}
响应示例
状态码:202
修改解析器转发规则响应。
{
"resolver_rule" : {
"id" : "8a36f60a753badb401753bade3400002",
"name" : "rule-xxx",
"domain_name" : "www.example.com",
"endpoint_id" : "8a36f60a753badb401753bade3400001",
"status" : "ACTIVE",
"rule_type" : "FORWARD",
"ipaddress_count" : 0,
"create_time" : "2020-10-18T12:27:31.448",
"update_time" : "2020-10-18T12:27:31.448"
}
}
状态码
状态码 |
描述 |
---|---|
202 |
修改解析器转发规则响应。 |
400 |
接口错误响应。 |
500 |
接口错误响应。 |
错误码
请参见错误码。