華為云計算 云知識 更新SNAT規(guī)則UpdateNatGatewaySnatRule
更新SNAT規(guī)則UpdateNatGatewaySnatRule

 

接口說明

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

約束說明

更新 彈性公網IP 的id時,要求SNAT規(guī)則狀態(tài)status = ACTIVE,要求網關管理員狀態(tài)admin_state_up = True。 更新描述時,要求SNAT規(guī)則狀態(tài)status = ACTIVE,要求網關管理員狀態(tài)admin_state_up = True。

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

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

project_id
 
string path

項目的ID。

snat_rule_id
 
string path

SNAT規(guī)則的ID。

Body參數
名稱 類型 必選 描述
snat_rule
 
UpdateNatGatewaySnatRuleOption object  
參數:
snat_rule
名稱 類型 必選 描述
nat_gateway_id
 
string

公網 NAT網關 的id。

public_ip_address
 
string

功能說明:彈性 公網IP ,多個彈性公網IP使用逗號分隔。 取值范圍:最大長度1024字節(jié)。 約束:彈性公網IP的id個數不能超過20個

description
 
string

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

返回參數
返回碼: 200

PUT操作正常返回。

名稱 類型 必選 描述
snat_rule
 
NatGatewayUpdateSnatRuleResponseBody object

更新SNAT規(guī)則的響應體。

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

SNAT規(guī)則的ID。

tenant_id
 
string

項目的ID。

nat_gateway_id
 
string

公網NAT網關實例的ID。

source_type
 
integer

0:VPC側,可以指定network_id 或者cidr 1:專線側,只能指定cidr 不輸入默認為0(VPC)

cidr
 
string

cidr,可以是網段或者主機格式,與network_id參數二選一。 Source_type=0時,cidr必須是vpc 子網網段的子集(不能相等); Source_type=1時,cidr必須指定專線側網段。

floating_ip_id
 
string

功能說明:彈性公網IP的id,多個彈性公網IP使用逗號分隔。 取值范圍:最大長度4096字節(jié)。

description
 
string

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

status
 
string

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

created_at
 
string

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

network_id
 
string

規(guī)則使用的網絡id。與cidr參數二選一。

admin_state_up
 
boolean

解凍/凍結狀態(tài)。 取值范圍:

  • "true":解凍
  • "false":凍結
floating_ip_address
 
string

功能說明:彈性公網IP,多個彈性公網IP使用逗號分隔。 取值范圍:最大長度1024字節(jié)。

public_ip_address
 
string

功能說明:彈性公網IP,多個彈性公網IP使用逗號分隔。 取值范圍:最大長度1024字節(jié)。

請求示例
示例 1

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

 
"PUT https://{Endpoint}/v2/27e25061336f4af590faeabeb7fcd9a3/snat_rules/5b95c675-69c2-4656-ba06-58ff72e1d338 "
 
{ "snat_rule": { "description": "my_snat_rule_update", "nat_gateway_id": "bbe7c2e7-3bad-445b-a067-b30acce66053" } }
返回示例
返回碼:200

PUT操作正常返回。

示例 1
 
{
"snat_rule": {
"floating_ip_id": " bdc10a4c-d81a-41ec-adf7-de857f7c812a,7a094014-9657-463f-972b-e84d56b931a0",
"status": "PENDING_CREATE",
"nat_gateway_id": "bbe7c2e7-3bad-445b-a067-b30acce66053",
"admin_state_up": true,
"network_id": "eaad9cd6-2372-4be1-9535-9bd37210ae7b",
"source_type": 0,
"tenant_id": "27e25061336f4af590faeabeb7fcd9a3",
"created_at": "2017-11-18 07:54:21.665430",
"id": "5b95c675-69c2-4656-ba06-58ff72e1d338",
"public_ip_address": "10.15.10.11,10.15.10.12",
"floating_ip_address": "10.15.10.11,10.15.10.12",
"description": "my_snat_rule_update"
}
}
SDK
點擊 NAT網關 (NAT) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認證方式等在SDK文檔中對應語言類型的【使用】目錄下。
錯誤碼
請參考 錯誤碼說明。