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 文字で、アルファベット文字または漢字で始まる必要があります。 |
SourceCIDR | String | 任意 | 10.1.1.0/24 |
VSwitch の CIDR ブロック、または ECS インスタンスを設定します。
注 このパラメーターは、 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 をご覧ください。