すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:CreateForwardEntry

最終更新日:Apr 18, 2026

説明

この API は廃止されました。一時的にアクセス可能ですが、更新やバグ修正対応は一切行われません。代わりに Vpc(2016-04-28) - CreateForwardEntry への移行を推奨します。より強化された機能に加え、サポートも引き続きご利用いただけます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vpc:CreateForwardEntry

create

*ForwardTable

acs:vpc:{#regionId}:{#accountId}:forwardtable/{#ForwardTableId}

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

RegionId

string

必須

DNAT テーブルが属するリージョンの ID。利用可能なリージョンの一覧を取得するには、DescribeRegions API を呼び出します。

ForwardTableId

string

必須

DNAT テーブルの ID。

ExternalIp

string

必須

DNAT エントリのパブリック IP アドレス。DNAT テーブルに関連付けられている NAT ゲートウェイのパブリック IP アドレスでなければなりません。

ExternalPort

string

必須

DNAT に使用する外部ポート。有効な値: 1~65535。

InternalIp

string

必須

トラフィックの転送先となるプライベート IP アドレス。

InternalPort

string

必須

トラフィックの転送先となる内部ポート。有効な値: 1~65535。

IpProtocol

string

必須

プロトコル。有効な値: TCP、UDP、Any。このパラメーターを Any に設定すると、DNAT エントリはすべてのプロトコルに適用されます。

レスポンスフィールド

フィールド

型

説明

例

object

レスポンスデータです。

ForwardEntryId

string

フォワードエントリの ID です。

RequestId

string

リクエスト ID です。

例

成功レスポンス

JSONJSON

{
  "ForwardEntryId": "",
  "RequestId": ""
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 OperationUnsupported.ForwardEntry Duplicated destination ip port is unsupported.
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 Internal 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 Invalid.natgwNotExist The specified natgateway not exist.
400 InvalidIp.NotInNatgw The specified ip not belong to natgateway.
400 MissingParameter Missing mandatory parameter.
400 OperationFailed.InstacneBindEip Private ip instance already bind eip.
400 DuplicatedParam.ExternalPort The param of %s is duplicated.
400 DuplicatedParam.InternalPort The param of %s is duplicated.
400 UnsupportedFeature.PrivateLinkEnabled The feature of PrivateLinkEnabled is not supported.
400 UnsupportedFeature.PortSegment The feature of PortSegment is not supported.
400 ExclusiveParam.%sAnd%s The param of %s and %s are mutually exclusive.
400 OperationFailed.AnyPortConfig Operation failed because any port correspondence any protocol.
400 QuotaExceeded.ForwardEntry The quota of %s is exceeded, usage %s/%s.
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 Forbidden.DestinationIpOutOfVswitchCIDR The specified Internal Ip is Out of VSwitch CIDR.
400 Forbidden.ExternalIp.UsedInSnatTable The specified ExternalIp is already used in SnatTable.
400 Forbidden.InternalIpOutOfVpcCIDR The specified Internal Ip is Out of VPC CIDR.
400 AnyPort.PortMustBeZero Any port port must be zero.
400 InvalidParameter.Name.Malformed The specified Name is not valid.
400 IncorrectStatus.ForwardEntry The status of %s [%s] is incorrect.
400 Duplicated.DestinationPort The specified param DestinationPort is duplicated.
400 OperationUnsupported.EipInBinding Create snat entry with eip in associating status is unsupported.
400 QuotaExceeded.ForwardEntrySessionManytoOne The dnat session quota is exceed.
400 DuplicatedParam.%s The param of %s is duplicated.
400 UnsupportedFeature.%s The feature of %s is not supported.
400 Operation.Conflict The operation may conflicts with others.
500 InternalError The request processing has failed due to some unknown error.
500 System.Error ERROR SYSTEM ERROR.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
404 InvalidForwardTableId.NotFound Specified forward table does not exist.
404 InvalidExternalIp.NotFound Specified External Ip address does not found on the VRouter.
404 ResourceNotFound.NatIp The specified resource of %s is not found.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。