指定されたDNATエントリを変更します。
使用上の注意
- ModifyForwardEntryは非同期操作です。 リクエストを行った後、リクエストIDが返されますが、指定されたDNATエントリは変更されません。 システムはバックグラウンドでDNATエントリを変更します。
DescribeForwardTableEntriesを呼び出して、DNATエントリの状態を照会できます。
- Pending: システムがDNATエントリを変更していることを示します。 DNATエントリのみを照会できますが、他の操作は実行できません。
- Available: DNATエントリが変更されたことを示します。
- ModifyForwardEntry操作を繰り返し呼び出して、指定された期間内にDNATエントリを変更することはできません。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | ModifyForwardEntry |
実行する操作です。 値をModifyForwardEntryに設定します。 |
ForwardTableId | String | 必須 | ftb-8vbx8xu2lqj9qb334 **** |
DNATエントリが属するDNATテーブルのID。 |
ForwardEntryId | String | 必須 | fwd-8vbn3bc8roygjp0gy **** |
DNATエントリのID。 |
ExternalIp | String | 任意 | 116.85.XX.XX |
|
ExternalPort | String | 任意 | 80 |
|
InternalIp | String | 任意 | 10.0.0.78 |
|
InternalPort | String | 任意 | 80 |
|
IpProtocol | String | 任意 | TCP |
プロトコル。 有効な値:
|
ForwardEntryName | String | 任意 | test |
DNATエントリの新しい名前。 名前の長さは 2 ~ 128 文字である必要があります。 名前は英字で始まる必要があります。先頭文字列は |
RegionId | String | 必須 | cn-hangzhou |
NATゲートウェイのリージョンID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
ClientToken | String | 任意 | 123e4567-e89b-12d3-a456-426655440000 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを含めることができます。 説明 このパラメーターを指定しない場合、システムはRequestIdをClientTokenとして使用します。 各APIリクエストのRequestIdの値は異なる場合があります。
|
PortBreak | Boolean | いいえ | false |
ポート範囲の制限を解除するかどうかを指定します。 有効な値:
|
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
RequestId | String | 2315DEB7-5E92-423A-91F7-4C1EC9AD97C3 |
リクエストの ID です。 |
例
リクエストの例
http(s):// [エンドポイント]/?Action=ModifyForwardEntry
&ForwardTableId=ftb-8vbx8xu2lqj9qb334 ****
&ForwardEntryId=fwd-8vbn3bc8roygjp0gy ****
&ExternalIp=116.85.XX.XX
&ExternalPort=80
&InternalIp=10.0.0.78
&InternalPort=80
&IpProtocol=TCP
&ForwardEntryName=テスト
&RegionId= cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&PortBreak=false
&共通リクエストパラメータ
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyForwardEntryResponse>
<RequestId>2315DEB7-5E92-423A-91F7-4C1EC9AD97C3</RequestId>
</ModifyForwardEntryResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}
エラーコード
HttpCode | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | ExclusiveParam.% sAnd % s | % sと % sのパラメーターは相互に排他的です。 | % sと % sを同時に設定できない場合に返されるエラーメッセージ。 |
400 | InvalidIp.NotInNatgw | 指定されたIpはnatgatewayに属していません。 | 指定されたEIPがNATゲートウェイに関連付けられていない場合に返されるエラーメッセージ。 |
400 | OperationUnsupported.ForwardEntry | 重複した宛先ipポートはサポートされていません。 | 重複する宛先IPアドレスとポートがサポートされていない場合に返されるエラーメッセージ。 |
400 | IncorrectStatus.NatIp | % s [% s] の状態が正しくありません。 | NAT IPアドレスのステータスが無効な場合に返されるエラーメッセージ。 |
400 | IncorrectStatus.ForwardEntry | % s [% s] の状態が正しくありません。 | 削除するDNATエントリが無効な状態の場合に返されるエラーメッセージ。 |
400 | InvalidExternalIp. 奇形 | 指定されたExternalIpは有効なIPアドレスではありません。 | 指定されたEIPが無効な場合に返されるエラーメッセージ。 |
400 | InvalidInternalIp。奇形 | 指定されたInternalIpは有効なIPアドレスではありません。 | 指定された宛先プライベートIPアドレスが無効な場合に返されるエラーメッセージ。 |
400 | InvalidExternalPort.Malformed | 指定されたExternalPortは有効なポートではありません。 | 指定されたパブリックポートが無効な場合に返されるエラーメッセージ。 |
400 | InvalidInternalPort.Malformed | 指定されたInternalPortは有効なポートではありません。 | 指定されたプライベートポートが無効な場合に返されるエラーメッセージ。 |
400 | Forbidden.DestnationIpOutOfVpcCIDR | 指定された宛先 IP は VPC CIDR の範囲外です。 | 指定されたプライベートIPアドレスが仮想プライベートクラウド (VPC) のCIDRブロック内にない場合に返されるエラーメッセージ。 VPCのCIDRブロック内のプライベートIPアドレスを入力します。 |
400 | InvalidProtocal.ValueNotSupported | 指定されたIpProtocolはサポートしていません。 | 指定されたプロトコルがサポートされていない場合に返されるエラーメッセージ。 |
400 | IncorretForwardEntryStatus | 一部のForward entryステータスがこの操作をブロックしました。 | 指定された操作を実行する権限がない場合に返されるエラーメッセージ。 DNATテーブルの1つ以上のDNATエントリがPendingまたはModifying状態にある場合に返されるエラーメッセージ。 |
400 | QuotaExceeded | このルートテーブルでフォワードエントリクォータを超えました。 | 同じルートテーブル内のカスタムルートエントリの数が200を超えることができない場合に返されるエラーメッセージ。 クォータの増加を要求するには、クォータ管理ページに移動します。 |
400 | Forbidden.ExternalIp.UsedInSnatTable | 指定されたExternalIpは既にSnatTableで使用されています | 指定されたEIPがSNATエントリによってすでに使用されている場合に返されるエラーメッセージ。 別のEIPを選択するか、SNATエントリを削除します。 |
400 | 禁止されていますすでに縛られています | 指定されたインスタンスは既に | 指定されたインスタンスが別のDNATエントリに関連付けられている場合に返されるエラーメッセージ。 |
400 | InvalidParameter.Name.Malformed | 指定されたNameは無効です。 | 指定された名前の形式が無効な場合に返されるエラーメッセージ。 有効な形式で名前を入力します。 |
400 | IllegalParam.AnyPortNotZero | どのポートポートもゼロでなければなりません。 | IpProtocolがAnyに設定されている場合、宛先ポートと送信元ポートを0に設定する必要がある場合に返されるエラーメッセージ。 |
400 | InvalidForwardEntryId.NotFound | 指定された転送エントリIDが存在しません | 指定されたDNATエントリが存在しない場合に返されるエラーメッセージ。 |
400 | OperationUnsupported.EipInBinding | 関連付けステータスがサポートされていないeipでsnatエントリを作成します。 | SNATエントリの作成時に関連するEIPを使用できない場合に返されるエラーメッセージ。 |
404 | ResourceNotFound.NatIp | 指定された % sのリソースが見つかりません。 | NAT IPアドレスが見つからない場合に返されるエラーメッセージ。 |
404 | InvalidRegionId.NotFound | 指定された RegionId はレコードに存在しません。 | 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。 |
404 | InvalidExternalIp.NotFound | 指定された外部IpアドレスがVRouterに見つかりません | 指定されたEIPが存在しない場合に返されるエラーメッセージ。 |
404 | InvalidForwardTableId.NotFound | 指定された転送テーブルは存在しません。 | 指定されたDNATテーブルが存在しない場合に返されるエラーメッセージ。 パラメーターを確認して、もう一度お試しください。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。