呼叫ModifyForwardEntry介面修改指定的DNAT條目。
介面說明
-
ModifyForwardEntry 介面屬於異步介面,即系統會先返回一個請求 ID,但 DNAT 條目並未修改完成,系統後台的修改任務仍在進行。您可以呼叫 DescribeForwardTableEntries 查詢 DNAT 條目的狀態:
-
當 DNAT 條目處於 Pending 狀態時,表示 DNAT 條目正在修改中,在該狀態下,您只能執行查詢操作,不能執行其他操作。
-
當 DNAT 條目處於 Available 狀態時,表示 DNAT 條目修改完成。
-
-
ModifyForwardEntry 介面在同一個 DNAT 條目下不支援並發修改指定的 DNAT 條目。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vpc:ModifyForwardEntry |
update |
*ForwardTable
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ForwardTableId |
string |
是 |
DNAT 條目所屬的 DNAT 列表的 ID。 |
ftb-8vbx8xu2lqj9qb334**** |
| ForwardEntryId |
string |
是 |
要修改的 DNAT 條目的 ID。 |
fwd-8vbn3bc8roygjp0gy**** |
| ExternalIp |
string |
否 |
|
116.85.XX.XX |
| ExternalPort |
string |
否 |
|
80 |
| InternalIp |
string |
否 |
|
10.0.0.78 |
| InternalPort |
string |
否 |
|
80 |
| IpProtocol |
string |
否 |
協議類型,取值:
|
TCP |
| ForwardEntryName |
string |
否 |
修改後的 DNAT 條目名稱。 長度為 2~128 個字元,必須以字母或中文開頭,但不能以 |
test |
| RegionId |
string |
是 |
NAT 閘道所在的地域 ID。 您可以透過呼叫 DescribeRegions 介面取得地域 ID。 |
cn-hangzhou |
| ClientToken |
string |
否 |
用戶端 Token,用於保證請求的冪等性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。 |
123e4567-e89b-12d3-a456-426655440000 |
| PortBreak |
boolean |
否 |
是否開啟連接埠突破,取值:
|
false |
| DryRun |
boolean |
否 |
是否只預檢此次請求。取值:
|
false |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
請求 ID。 |
||
| RequestId |
string |
請求 ID。 |
2315DEB7-5E92-423A-91F7-4C1EC9AD97C3 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | UnsupportedFeature.PortSegment | The feature of PortSegment is not supported. | |
| 400 | ExclusiveParam.%sAnd%s | The param of %s and %s are mutually exclusive. | |
| 400 | InvalidIp.NotInNatgw | The specified Ip not belong to natgateway. | |
| 400 | DuplicatedParam.InternalPort | The param of %s is duplicated. | |
| 400 | DuplicatedParam.ExternalPort | The param of %s is duplicated. | |
| 400 | OperationFailed.AnyPortConfig | Operation failed because any port correspondence any protocol | |
| 400 | OperationUnsupported.ForwardEntry | Duplicated destination ip port is unsupported. | |
| 400 | IncorrectStatus.NatIp | The status of %s [%s] is incorrect. | |
| 400 | Forbidden.IpHasBeenUsedInSnat | The source ip can't be used. Because it has been used in snat. | |
| 400 | IncorrectStatus.ForwardEntry | The status of %s [%s] is incorrect. | |
| 400 | InvalidExternalIp.Malformed | The specified ExternalIp is not a valid IP address. | |
| 400 | InvalidInternalIp.Malformed | The specified InternalIp is not a valid IP address. | |
| 400 | InvalidExternalPort.Malformed | The specified ExternalPort is not a valid port. | |
| 400 | InvalidInternalPort.Malformed | The specified InternalPort is not a valid port. | |
| 400 | Forbidden.DestnationIpOutOfVpcCIDR | The specified Destination Ip is Out of VPC CIDR. | |
| 400 | InvalidProtocal.ValueNotSupported | The specified IpProtocol does not support. | |
| 400 | IncorretForwardEntryStatus | Some Forward entry status blocked this operation.. | |
| 400 | QuotaExceeded | Forward entry quota exceeded in this route table. | |
| 400 | ForwardEntry.Duplicated | The specified ExternalIp, IpProtocol, ExternalPort,InternalIp, InternalPort is duplicated | |
| 400 | Forbidden.ExternalIp.UsedInSnatTable | The specified ExternalIp is already used in SnatTable | |
| 400 | Forbidden.Already.Bounded | The specified instance already bounded | |
| 400 | InvalidIp.NotFound | The specified ip does not exist. | |
| 400 | InvalidParameter.Name.Malformed | The specified Name is not valid. | |
| 400 | IncorretStatus.ForwardEntry | The Specified forwardEntry is not stable status, can not operation | |
| 400 | IllegalParam.AnyPortNotZero | Any port port must be zero. | |
| 400 | Duplicated.DestinationPort | The specified param DestinationPort is duplicated. | |
| 400 | InvalidForwardEntryId.NotFound | Specified forward entry ID does not exist | |
| 400 | OperationUnsupported.EipInBinding | Create snat entry with eip in associating status is unsupported. | |
| 400 | QuotaExceeded.ForwardEntrySessionManytoOne | The dnat session quota is exceed. | |
| 400 | OperationFailed.ForwardEntryNotAllowSrcIpEqualDstIp | The source IP of forward entry is not allowed to equal destination IP. | |
| 404 | ResourceNotFound.NatIp | The specified resource of %s is not found. | |
| 404 | ResourceNotFound.ForwardEntry | The specified resource of %s is not found. | |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | |
| 404 | InvalidForwardEntryId.NotFound | Specified forward entry ID does not exist | |
| 404 | InvalidExternalIp.NotFound | Specified External Ip address does not found on the VRouter | |
| 404 | InvalidForwardTableId.NotFound | Specified forward table does not exist. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。