指定された SNAT エントリを変更します。
操作説明
ModifySnatEntry は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返しますが、SNAT エントリはまだ変更済みではありません。変更タスクはバックグラウンドで実行中です。 DescribeSnatTableEntries を呼び出して SNAT エントリのステータスをクエリできます:
-
SNAT エントリが Pending 状態の場合、SNAT エントリは変更中です。この状態では、クエリ操作のみを実行でき、他の操作は実行できません。
-
SNAT エントリが Available 状態の場合、SNAT エントリは変更済みです。
SNAT テーブル内のいずれかの SNAT エントリが Pending 状態の場合、その SNAT テーブル内の SNAT エントリを変更できません。
ModifySnatEntry 操作は、同じ SNAT エントリインスタンス内で指定された SNAT エントリの同時変更をサポートしていません。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vpc:ModifySnatEntry |
update |
*SnatTable
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
NAT ゲートウェイのリージョン ID。 DescribeRegions 操作を呼び出してリージョン ID をクエリできます。 |
cn-hangzhou |
| SnatTableId |
string |
必須 |
SNAT エントリが属する SNAT テーブルの ID。 |
stb-8vbczigrhop8x5u3t**** |
| SnatEntryId |
string |
必須 |
変更する SNAT エントリの ID。 |
snat-bp1vcgcf8tm0plqcg**** |
| SnatIp |
string |
任意 |
説明
複数の EIP を指定して SNAT IP IPAM プールを割り当てる場合、サービストラフィックはハッシュアルゴリズムを使用して EIP 間に分散されます。接続ごとにトラフィックが異なるため、サービストラフィックが EIP 間で不均等に分散される場合があります。単一の EIP に対する帯域幅調整によるサービス中断を防ぐため、すべての EIP を同じインターネット共有帯域幅インスタンスに追加してください。
|
47.98.XX.XX |
| SnatEntryName |
string |
任意 |
SNAT エントリの名前。 名前は 2~128 文字で、英字または中国語の文字で始まる必要があります。 |
SnatEntry-1 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。ClientToken の値には ASCII 文字のみを含めることができます。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。RequestId は API リクエストごとに異なる場合があります。 |
02fb3da4-130e-11e9-8e44-001**** |
| EipAffinity |
integer |
任意 |
EIP アフィニティを有効にするかどうかを指定します。有効な値:
説明
EIP アフィニティを有効にすると、SNAT エントリが複数の EIP または NAT IP アドレスに関連付けられている場合、同じクライアントは同じ EIP または NAT IP アドレスを使用してアクセスします。それ以外の場合、クライアントは関連付けられた EIP または NAT IP アドレスからランダムに選択してアクセスします。 |
1 |
| NetworkInterfaceId |
string |
任意 |
Elastic ネットワークインターフェース (ENI) の ID。 説明
ネットワークインターフェース (NIC) の IPv4 アドレスが SNAT アドレスとして使用されます。 |
eni-gw8g131ef2dnbu3k**** |
| DryRun |
boolean |
任意 |
ドライランを実行するかどうかを指定します。有効な値:
|
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスボディ。 |
||
| RequestId |
string |
リクエスト ID。 |
2315DEB7-5E92-423A-91F7-4C1EC9AD**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidSnatIp.Malformed | The specified SnatIp is not a valid IP address. | |
| 400 | Forbidden.SourceVSwitchId.Duplicated | The specified SourceCIDRis duplicated. | |
| 400 | Forbidden.IpUsedInForwardTable | The specified SnatIp already used in forward table | |
| 400 | OperationUnsupported.EipForSnatPool | The Eip cannot support snat pool | |
| 400 | InvalidParameter.Name.Malformed | The specified Name is not valid. | |
| 400 | IncorretSnatEntryStatus | The Specified SnatEntry is not stable status, can not operation | |
| 400 | EIP_NOT_IN_GATEWAY | The Eip not in nat gateway | |
| 400 | InvalidParameter.SnatIp | Error public ip must in same bandwidth package. | |
| 400 | QuotaExceeded.SnatIp | Public ip number exceeds quota. | |
| 400 | InvalidSnatEntryId.NotFound | Specified SNAT entry does not exist. | |
| 400 | IncorrectStatus.SnatEntry | The Specified SnatEntry is not stable status, can not operation | |
| 400 | OperationFailed.CanNotUseEipInDnat | Operation failed because the eip can not used by forward entry. | |
| 400 | OperationUnsupported.EipNatGWCheck | Operation unsupported because the relation check of eip and nat gateway is failed. | |
| 400 | ResourceNotFound.SnatEntry | Specified SNAT entry does not exist. | |
| 400 | IncorrectStatus.NatIp | Specified NatIp does not exist. | |
| 400 | OperationFailed.CanNotUseNatIpInDnat | Operation failed because the NatIp can not used by forward entry. | |
| 400 | IncorrectStatus.NATGW | NATGW status is invalid. | |
| 400 | OperationUnsupported.EipInBinding | Create snat entry with eip in associating status is unsupported. | |
| 400 | OperationUnsupported.EipNatBWPCheck | The EIP is not associated with a NAT service plan. | |
| 400 | IllegalParam.NetworkInterfaceId | The param of NetworkInterfaceId is illegal. | |
| 400 | OperationFailed.SnatIpPoolBwpRules | The operation failed because the IP in Snat entryl was added to multiple NAT bandwidth packets. | |
| 400 | OperationFailed.SnatIpPoolCbwpRules | The operation failed because the SNAT rule IPs are added to multi bandwidth packages. | |
| 400 | OperationFailed.SnatIpsTooMany | The maximum number of IP addresses is exceeded in the SNAT pool. | |
| 400 | OperationFailed.SnatIpsCheck | The operation fails because some IPs address in the SNAT entry are not added to common bandwidth packet. | |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | |
| 404 | InvalidSnatTableId.NotFound | Specified SNAT table does not exist. | |
| 404 | InvalidSnatEntryId.NotFound | Specified SNAT entry does not exist. | |
| 404 | InvalidSnatIp.NotFound | Specified SnatIp does not found on the NAT Gateway | |
| 404 | ResourceNotFound.NatIp | Specified NatIp does not found on the NAT Gateway |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。