指定されたDNATエントリを変更します。
操作説明
-
ModifyForwardEntryは非同期操作です。リクエストを送信すると、システムはリクエストIDを返しますが、DNATエントリはまだ変更されていません。変更タスクはバックグラウンドで実行されます。 DescribeForwardTableEntries を呼び出して、DNATエントリのステータスを照会できます:
-
DNATエントリがPending 状態の場合、DNATエントリは変更中です。この状態では、照会操作のみ実行できます。
-
DNATエントリがAvailable 状態の場合、DNATエントリは変更完了です。
-
-
ModifyForwardEntryは、同じDNATテーブル内のDNATエントリの同時変更をサポートしていません。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
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 |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには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 |
例
成功レスポンス
JSONJSON
{
"RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 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. | 定義できるルートエントリは 48 までです。 |
| 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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。