指定されたDNATエントリを変更します。

使用上の注意

  • ModifyForwardEntryは非同期操作です。 リクエストを行った後、リクエストIDが返されますが、指定されたDNATエントリは変更されません。 システムはバックグラウンドでDNATエントリを変更します。 DescribeForwardTableEntriesを呼び出して、DNATエントリの状態を照会できます。
    • Pending: システムがDNATエントリを変更していることを示します。 DNATエントリのみを照会できますが、他の操作は実行できません。
    • Available: DNATエントリが変更されたことを示します。
  • ModifyForwardEntry操作を繰り返し呼び出して、指定された期間内にDNATエントリを変更することはできません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 ModifyForwardEntry

実行する操作です。 値をModifyForwardEntryに設定します。

ForwardTableId String 必須 ftb-8vbx8xu2lqj9qb334 ****

DNATエントリが属するDNATテーブルのID。

ForwardEntryId String 必須 fwd-8vbn3bc8roygjp0gy ****

DNATエントリのID。

ExternalIp String 任意 116.85.XX.XX
  • インターネットNATゲートウェイのDNATエントリを変更する場合、このパラメータには、インターネットへのアクセスに使用されるelastic IPアドレス (EIP) を指定します。
  • Virtual Private Cloud (VPC) NAT GatewayのDNATエントリを変更する場合、このパラメーターには外部ネットワークからアクセスされるNAT IPアドレスを指定します。
ExternalPort String 任意 80
  • インターネットNATゲートウェイのDNATエントリを変更するときにトラフィックを転送するために使用される外部ポート。
    • 有効な値: 1〜65535。
    • ポート範囲を変更する場合は、ポート番号をスラッシュ (/) で区切ります (10/20など) 。
    • ExternalPortとInternalPortを同時に変更し、ExternalPortをポート範囲に設定する場合は、InternalPortもポート範囲に設定する必要があります。 たとえば、ExternalPortを10/20に設定し、InternalPorを80/90に設定できます。
  • VPC NAT GatewayのDNATエントリを変更したときに外部ネットワークからアクセスされるポート。 有効な値: 1〜65535。
InternalIp String 任意 10.0.0.78
  • インターネットNATゲートウェイのDNATエントリを変更するときに、DNATエントリを使用してインターネットと通信するECSインスタンスのプライベートIPアドレス。
  • VPC NAT GatewayのDNATエントリを変更するときにDNATエントリを使用するプライベートIPアドレス。
InternalPort String 任意 80
  • インターネットNATゲートウェイのDNATエントリを変更するときにトラフィックを転送するために使用される内部ポートまたはポート範囲。 有効な値: 1〜65535。
  • VPC NAT GatewayのDNATエントリを照会するときにマッピングされる宛先ECSインスタンスのポート。 有効な値: 1〜65535。
IpProtocol String 任意 TCP

プロトコル。 有効な値：

  • TCP: NATゲートウェイはTCPパケットを転送します。
  • UDP: NATゲートウェイはUDPパケットを転送します。
  • 任意: NATゲートウェイは、すべてのプロトコルのパケットを転送します。
ForwardEntryName String 任意 test

DNATエントリの新しい名前。

名前の長さは 2 ~ 128 文字である必要があります。 名前は英字で始まる必要があります。先頭文字列は http:// または https:// にすることはできません。

RegionId String 必須 cn-hangzhou

NATゲートウェイのリージョンID。

DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

ClientToken String 任意 123e4567-e89b-12d3-a456-426655440000

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを含めることができます。

説明 このパラメーターを指定しない場合、システムはRequestIdをClientTokenとして使用します。 各APIリクエストのRequestIdの値は異なる場合があります。
PortBreak Boolean いいえ false

ポート範囲の制限を解除するかどうかを指定します。 有効な値：

  • true: はい
  • false: no SNATエントリとDNATエントリが同じパブリックIPアドレスを使用し、1024を超えるポート番号を指定する場合は、PortBreakをtrueに設定します。

レスポンスパラメーター

項目 データ型 例: 説明　
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 エラーセンター」をご参照ください。