SNAT テーブルに SNAT エントリを追加します。

この API を呼び出して SNAT エントリを追加する前に、次の点に注意してください。

  • SNAT エントリに設定する VSwitch は、NAT Gateway と同じ VPC に設定されている必要があります。
  • 各 VSwitch および ECS インスタンスは、1 つの SNAT エントリのみに設定することができます。
  • VSwitch に HAVIP インスタンスが存在する場合、SNAT エントリは追加できません。
  • SNAT エントリに設定するパブリック IP アドレス (SnatIp) は、次の条件を満たす必要があります。
    • NAT 帯域幅パッケージを 2018 年 1 月 26 日より前に購入している場合、SnatIp は NAT Gateway の NAT 帯域幅パッケージのパブリック IP アドレスである必要があります。
    • NAT 帯域幅パッケージを 2018 年 1 月 26 日以降に購入している場合、SnatIp は NAT Gateway に関連付けられた EIP である必要があります。
    • 1 つのパブリック IP アドレスを DNAT エントリと SNAT エントリで同時に使用することはできません。

デバッグ

OpenAPI Explorer を使用してデバッグ操作を実行し、SDK コード例を生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 値の例 説明
Action String 必須 CreateSnatEntry

操作の実行に使用する API (CreateSnatEntry) を設定します。

RegionId String 必須 cn-hangzhou

NAT Gateway が設定されているリージョンの ID を設定します。

リージョン ID を照会するには、DescribeRegions を呼び出します。

SnatIp String 必須 47.XX.XX.98

パブリック IP アドレスを設定します。 IP アドレスが複数の場合はカンマで区切ります。

SnatTableId String 必須 stb-bp190wu8io1vgev****

SNAT テーブルの ID を設定します。

SnatEntryName String 任意 SnatEntry-1

追加する SNAT エントリの ID を設定します。 名前の長さは 2 文字から 128 文字で、アルファベット文字または漢字で始まる必要があります。 http:// または https:// で始まる名前は使用できません。

SourceCIDR String 任意 10.1.1.0/24

VSwitch の CIDR ブロック、または ECS インスタンスを設定します。

  • VSwitch granularity: VSwitch の CIDR ブロック (例: 192.168.1.0/24) を設定します。 VSwitch の ECS インスタンスがインターネットアクセスリクエストを開始すると、NAT Gateway が ECS インスタンスに SNAT サービス (インターネットプロキシサービス) を提供します。 SnatIp パラメーターに 単一のパブリック IP アドレスを指定した場合、ECS インスタンスは指定されたパブリック IP アドレスを使用してインターネットにアクセスします。 SnatIp パラメーターに複数のパブリック IP アドレスを指定した場合、 ECS インスタンスは指定されたパブリック IP のいずれか 1 つを使用してインターネットにアクセスします。
  • ECS granularity: ECS インスタンスの IP アドレス (例: 192.168.1.1/32) を設定します。 ECS インスタンスがインターネットアクセスリクエストを開始すると、NAT Gateway は ECS インスタンスに SNATサービス (インターネットプロキシサービス) を提供します。 SnatIp パラメーターに 単一のパブリック IP アドレスを指定した場合、ECS インスタンスは指定されたパブリック IP アドレスを使用してインターネットにアクセスします。 SnatIp パラメーターに複数のパブリック IP アドレスを指定した場合、 ECS インスタンスは指定されたパブリック IP のいずれか 1 つを使用してインターネットにアクセスします。
このパラメーターは、 SourceVSwtichId パラメーターと同時に使用することはできません。 SourceVSwitchId パラメーターが設定されている場合、SourceCIDR パラメーターは設定できません。 同様に、SourceCIDR パラメーターが設定されている場合、SourceVSwitchId パラメーターは設定できません。
SourceVSwitchId String 任意 vsw-bp1nhx2s9ui5o****

インターネットへのアクセスを必要とする VSwitch の ID を設定します。

レスポンスパラメーター

パラメーター データ型 値の例 説明
SnatEntryId String snat-kmd6nv8fy****

SNAT エントリの ID を示します。

RequestId String 2315DEB7-5E92-423A-91F7-4C1EC9AD97C3

リクエストの ID を示します。

リクエストの例


https://vpc.aliyuncs.com/?Action=CreateSnatEntry
1.RegionId=cn-hangzhou
&SnatIp = 47.XX.XX.98
&SnatTableId=stb-bp190wu8io1vgevx****
&<CommonParameters>

レスポンスの例

XML 形式

<CreateSnatEntryResponse>
  <RequestId>2315DEB7-5E92-423A-91F7-4C1EC9AD97C3</RequestId>
  <SnatEntryId>snat-119smw5tkx****</SnatEntryId>
</CreateSnatEntryResponse>

JSON format

{
	"RequestId":"2315DEB7-5E92-423A-91F7-4C1EC9AD97C3",
	"SnatEntryId":"snat-kmd6nv8fyx****"
}

エラー

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定されたリージョン ID が存在しない場合に返されるエラーメッセージです。
404 InvalidSnatTableId.NotFound Specified SNAT table does not exist. 指定された SNAT テーブルが存在しない場合に返されるエラーメッセージです。
400 Forbidden.SourceVSwitchId.IncludeHaVip There is some HaVips under specified VSwitch 指定された VSwitch に 1 つ以上の HAVIP がすでに設定されている場合に返されるエラーメッセージです。
400 InvalidSnatIp.Malformed The specified SnatIp is not a valid IP address. 指定された SNAT IP アドレスが正しくない場合に返されるエラーメッセージです。
400 SNAT_IP_POOL_COUNT_TOO_MANY The Snat pool ip too many. SNAT IP アドレスプールに割り当てられる IP アドレス数の上限に達した場合に返されるエラーメッセージです。
400 Forbidden.SnatEntryCountLimited SNAT entry in the specified SNAT table reaches its limit. SNAT エントリの数が上限にに達した場合に返されるエラーメッセージです。
400 NOT_ALLOW_USE_SOURCECIDR The User not in nat_scope_unlimited white list. Cannot use SourceCidr param. 指定されたイントラネット IP アドレスが、VPC の CIDR ブロック内に存在しない場合に返されるエラーメッセージです。
404 InvalidVSwitchId.NotFound The specified virtual switch does not exist. 指定された VSwitch が存在しない場合に返されるエラーメッセージです。
400 INVALID_PARAMETER The parameter is invalid. パラメーターが正しくない場合に返されるエラーメッセージです。
400 Forbidden.SourceVSwitchId.Duplicated The specified SourceCIDR is duplicated. 指定された VSwitch に対する SNAT ルールがすでに設定されている場合に返されるエラーメッセージです。
404 InvalidSnatIp.NotFound The specified SnatIp is not found in the NAT Gateway. パブリック IP アドレスが NAT Gateway に存在しない場合に返されるエラーメッセージです。
400 Forbidden.IpUsedInForwardTable The specified SnatIp already used in forward table. 指定されたパブリック IP アドレスがすでに DNAT ルールで使用されている場合に返されるエラーメッセージです。 別のパブリック IP アドレスを選択するか、DNAT ルールを削除します。
400 Forbidden The specified Instance already bind eip 指定された ECS インスタンスに対して、すでに EIP が関連付けられている場合に返されるエラーメッセージです。 ECSインスタンスと EIP の関連付けを解除してから、転送ルールを追加します。
400 InvalidParameter.Name.Malformed The specified Name is not valid. 指定された名前が正しくない場合に返されるエラーメッセージです。 正しい名前を入力して、再試行します。

エラーコードのリストについては、 API Error Center をご覧ください。