華為云計(jì)算 云知識 更新DNAT規(guī)則UpdateNatGatewayDnatRule
更新DNAT規(guī)則UpdateNatGatewayDnatRule

 

接口說明

更新指定的DNAT規(guī)則。

約束說明

更新操作時(shí),要求DNAT規(guī)則狀態(tài)status = ACTIVE,要求網(wǎng)關(guān)管理員狀態(tài)admin_state_up = True。port_id和private_ip不能同時(shí)生效。對于all port類型的規(guī)則,要求internal_service_port = 0,external_service_port = 0,protocol = ANY。 更新操作涉及以下字段更新時(shí),要求這些字段必須一起更新。包括:port_id、private_ip、internal_service_port、external_service_port、floating_ip_id、protocol、internal_service_port_range、external_service_port_range。

URL
PUT  https://nat.cn-north-4.myhuaweicloud.com/v2/{project_id}/dnat_rules/{dnat_rule_id} 
請求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token。 用戶Token也就是調(diào)用獲取用戶Token獲取請求認(rèn)證接口的響應(yīng)值,該接口是唯一不需要認(rèn)證的接口。 請求響應(yīng)成功后在響應(yīng)消息頭中包含的“X-Subject-Token”的值即為Token值。

project_id
 
string path

項(xiàng)目的ID。

dnat_rule_id
 
string path

DNAT規(guī)則的ID。

Body參數(shù)
名稱 類型 必選 描述
dnat_rule
 
UpdateNatGatewayDnatRuleOption object

更新DNAT規(guī)則的請求體。

參數(shù):
dnat_rule
名稱 類型 必選 描述
nat_gateway_id
 
string

NAT網(wǎng)關(guān) 的id。

description
 
string

DNAT規(guī)則的描述,長度限制為255。

port_id
 
string

虛擬機(jī)或者裸機(jī)的Port ID,對應(yīng) 虛擬私有云 場景,與private_ip參數(shù)二選一。

private_ip
 
string

用戶私有IP地址,對應(yīng)專線、 云連接 場景,與port_id參數(shù)二選一。

protocol
 
string

協(xié)議類型,目前支持TCP/tcp、UDP/udp、ANY/any。 對應(yīng)協(xié)議號6、17、0。

floating_ip_id
 
string

彈性公網(wǎng)IP 的id。

internal_service_port
 
integer

虛擬機(jī)或者裸機(jī)對外提供服務(wù)的協(xié)議端口號。 取值范圍:0~65535。

external_service_port
 
integer

Floatingip對外提供服務(wù)的端口號。 取值范圍:0~65535。

internal_service_port_range
 
string

虛擬機(jī)或者裸機(jī)對外提供服務(wù)的協(xié)議端口號范圍。 功能說明:該端口范圍與external _service_port_range按順序?qū)崿F(xiàn)1:1映射。 取值范圍:1~65535。 約束:只能以’-’字符連接端口范圍。

external_service_port_range
 
string

Floatingip對外提供服務(wù)的端口號范圍。 功能說明:該端口范圍與internal _service_port_range按順序?qū)崿F(xiàn)1:1映射。 取值范圍:1~65535。 約束:只能以’-’字符連接端口范圍。

返回參數(shù)
返回碼: 200

更新DNAT規(guī)則成功。

名稱 類型 必選 描述
dnat_rule
 
NatGatewayDnatRuleResponseBody object

DNAT規(guī)則的響應(yīng)體。

200 dnat_rule
名稱 類型 必選 描述
id
 
string

DNAT規(guī)則的ID。

tenant_id
 
string

項(xiàng)目的ID。

description
 
string

DNAT規(guī)則的描述。長度限制為255。

port_id
 
string

虛擬機(jī)或者裸機(jī)的Port ID,對應(yīng)虛擬 私有云 場景,與private_ip參數(shù)二選一。

private_ip
 
string

用戶私有IP地址,對應(yīng)專線、云連接場景,與port_id參數(shù)二選一。

internal_service_port
 
integer

虛擬機(jī)或者裸機(jī)對外提供服務(wù)的協(xié)議端口號。 取值范圍:0~65535。

nat_gateway_id
 
string

公網(wǎng)NAT網(wǎng)關(guān)實(shí)例的ID。

floating_ip_id
 
string

彈性 公網(wǎng)IP 的id。

floating_ip_address
 
string

彈性公網(wǎng)IP的IP地址。

external_service_port
 
integer

Floatingip對外提供服務(wù)的端口號。 取值范圍:0~65535。

status
 
string

功能說明:DNAT規(guī)則的狀態(tài)。

admin_state_up
 
boolean

解凍/凍結(jié)狀態(tài)。 取值范圍: ? “true”: 解凍 ? “false”: 凍結(jié)

internal_service_port_range
 
string

虛擬機(jī)或者裸機(jī)對外提供服務(wù)的協(xié)議端口號范圍。 功能說明:該端口范圍與external _service_port_range按順序?qū)崿F(xiàn)1:1映射。 取值范圍:1~65535。 約束:只能以’-’字符連接端口范圍。

external_service_port_range
 
string

Floatingip對外提供服務(wù)的端口號范圍。 功能說明:該端口范圍與internal _service_port_range按順序?qū)崿F(xiàn)1:1映射。 取值范圍:1~65535。 約束:只能以’-’字符連接端口范圍

protocol
 
string

協(xié)議類型,目前支持TCP/tcp、UDP/udp、ANY/any。 對應(yīng)協(xié)議號6、17、0。

created_at
 
string

DNAT規(guī)則的創(chuàng)建時(shí)間,格式是yyyy-mm-dd hh:mm:ss.SSSSSS。

請求示例
示例 1
 
"PUT https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/dnat_rules/79195d50-0271-41f1-bded-4c089b2502ff"
 
{ "dnat_rule": { "description": "my dnat-rules" } }
返回示例
返回碼:200

更新DNAT規(guī)則成功。

示例 1
 
{
"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"
}
}
SDK
點(diǎn)擊 NAT網(wǎng)關(guān) (NAT) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對應(yīng)語言類型的【使用】目錄下。
錯(cuò)誤碼
請參考 錯(cuò)誤碼說明。