更新指定的DNAT规则。
更新操作时,要求DNAT规则状态status = ACTIVE,要求网关管理员状态admin_state_up = True。port_id和private_ip不能同时生效。对于all port类型的规则,要求internal_service_port = 0,external_service_port = 0,protocol = ANY。 更新操作涉及以下字段更新时,要求这些字段必须一起更新。包括:port_id、private_ip、internal_service_port、external_service_port、floating_ip_id、protocol、internal_service_port_range、external_service_port_range。
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 |
|
project_id
|
string | path | 是 |
项目的ID。 |
|
dnat_rule_id
|
string | path | 是 |
DNAT规则的ID。 |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
dnat_rule
|
UpdateNatGatewayDnatRuleOption object | 是 |
更新DNAT规则的请求体。 |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
nat_gateway_id
|
string | 是 |
NAT网关 的id。 |
|
description
|
string | 否 |
DNAT规则的描述,长度限制为255。 |
|
port_id
|
string | 否 |
虚拟机或者裸机的Port ID,对应 虚拟私有云 场景,与private_ip参数二选一。 |
|
private_ip
|
string | 否 |
用户私有IP地址,对应专线、 云连接 场景,与port_id参数二选一。 |
|
protocol
|
string | 否 |
协议类型,目前支持TCP/tcp、UDP/udp、ANY/any。 对应协议号6、17、0。 |
|
floating_ip_id
|
string | 否 |
弹性公网IP 的id。 |
|
internal_service_port
|
integer | 否 |
虚拟机或者裸机对外提供服务的协议端口号。 取值范围:0~65535。 |
|
external_service_port
|
integer | 否 |
Floatingip对外提供服务的端口号。 取值范围:0~65535。 |
|
internal_service_port_range
|
string | 否 |
虚拟机或者裸机对外提供服务的协议端口号范围。 功能说明:该端口范围与external _service_port_range按顺序实现1:1映射。 取值范围:1~65535。 约束:只能以’-’字符连接端口范围。 |
|
external_service_port_range
|
string | 否 |
Floatingip对外提供服务的端口号范围。 功能说明:该端口范围与internal _service_port_range按顺序实现1:1映射。 取值范围:1~65535。 约束:只能以’-’字符连接端口范围。 |
更新DNAT规则成功。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
dnat_rule
|
NatGatewayDnatRuleResponseBody object | 是 |
DNAT规则的响应体。 |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
id
|
string | 是 |
DNAT规则的ID。 |
|
tenant_id
|
string | 是 |
项目的ID。 |
|
description
|
string | 是 |
DNAT规则的描述。长度限制为255。 |
|
port_id
|
string | 否 |
虚拟机或者裸机的Port ID,对应虚拟 私有云 场景,与private_ip参数二选一。 |
|
private_ip
|
string | 否 |
用户私有IP地址,对应专线、云连接场景,与port_id参数二选一。 |
|
internal_service_port
|
integer | 是 |
虚拟机或者裸机对外提供服务的协议端口号。 取值范围:0~65535。 |
|
nat_gateway_id
|
string | 是 |
公网NAT网关实例的ID。 |
|
floating_ip_id
|
string | 是 |
弹性 公网IP 的id。 |
|
floating_ip_address
|
string | 是 |
弹性公网IP的IP地址。 |
|
external_service_port
|
integer | 是 |
Floatingip对外提供服务的端口号。 取值范围:0~65535。 |
|
status
|
string | 是 |
功能说明:DNAT规则的状态。 |
|
admin_state_up
|
boolean | 是 |
解冻/冻结状态。 取值范围: − “true”: 解冻 − “false”: 冻结 |
|
internal_service_port_range
|
string | 否 |
虚拟机或者裸机对外提供服务的协议端口号范围。 功能说明:该端口范围与external _service_port_range按顺序实现1:1映射。 取值范围:1~65535。 约束:只能以’-’字符连接端口范围。 |
|
external_service_port_range
|
string | 否 |
Floatingip对外提供服务的端口号范围。 功能说明:该端口范围与internal _service_port_range按顺序实现1:1映射。 取值范围:1~65535。 约束:只能以’-’字符连接端口范围 |
|
protocol
|
string | 是 |
协议类型,目前支持TCP/tcp、UDP/udp、ANY/any。 对应协议号6、17、0。 |
|
created_at
|
string | 是 |
DNAT规则的创建时间,格式是yyyy-mm-dd hh:mm:ss.SSSSSS。 |
更新DNAT规则成功。
"dnat_rule": {
"status": "ACTIVE",
"nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8",
"admin_state_up": true,
"port_id": "9a469561-daac-4c94-88f5-39366e5ea193",
"internal_service_port": 993,
"protocol": "tcp",
"tenant_id": "d199ba7e0ba64899b2e81518104b1526",
"floating_ip_id": "cf99c679-9f41-4dac-8513-9c9228e713e1",
"created_at": "2017-11-15 15:44:42.595173",
"id": "79195d50-0271-41f1-bded-4c089b2502ff",
"floating_ip_address": "5.21.11.226",
"external_service_port": 242,
"description": "my dnat rule"
}
}
