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

説明　

ModifySnatEntryは非同期操作です。 リクエストを行った後、リクエストのIDが返されますが、指定されたSNATエントリは変更されません。 システムはバックグラウンドでエントリを変更します。 DescribeSnatTableEntries操作を呼び出して、SNATエントリのステータスを照会できます。

  • Pending: システムがSNATエントリを変更していることを示します。 SNATエントリのステータスのみを照会できますが、その他の操作は実行できません。
  • Available: SNATエントリが変更されたことを示します。
説明 Pending: SNATテーブルのSNATエントリを変更できないことを示します。

ModifySnatEntry操作を繰り返し呼び出して、指定された期間内にSNATエントリを変更することはできません。

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

NATゲートウェイがデプロイされているリージョンのID。

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

SnatTableId String 必須 stb-8vbczigrhop8x5u3t ****

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

SnatEntryId String 必須 snat-bp1vcgcf8tm0plqcg ****

変更するSNATエントリのID。

SnatIp String 任意 47.98.XX.XX

  • インターネットNATゲートウェイのSNATエントリを変更したときのSNATエントリのelastic IPアドレス (EIP) 。 EIPはコンマ (,) で区切ります。

    複数のEIPを選択してSNATアドレスプールを作成すると、これらのEIPへの接続がハッシュされます。 各接続を通過するトラフィックの量が異なるため、ネットワークトラフィックがEIPに均等に分散されない場合があります。 個々のEIPの帯域幅制限によるサービスの中断を防ぐために、これらのEIPを同じEIP帯域幅プランに関連付けることを推奨します。

  • VPC NATゲートウェイのSNATエントリを変更する場合、このパラメーターにはSNATエントリのNAT IPアドレスを指定します。
SnatEntryName String 任意 SnatEntry-1

SNATエントリの名前。

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

ClientToken String 任意 02fb3da4-130e-11e9-8e44-001****

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

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

説明 このパラメーターを設定しない場合、システムは自動的にRequestIdをClientTokenとして使用します。 RequestIdの値は、APIリクエストごとに異なる場合があります。

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 2315DEB7-5E92-423A-91F7-4C1EC9AD97C3

リクエストの ID です。

例

リクエストの例

http(s):// [エンドポイント]/?Action=ModifySnatEntry
&RegionId=cn-hangzhou
&SnatTableId=stb-8vbczigrhop8x5u3t ****
&SnatEntryId=snat-bp1vcgcf8tm0plqcg ****
&SnatIp=47.98.XX.XX
&SnatEntryName=SnatEntry-1
&ClientToken=02fb3da4-130e-11e9-8e44-001 ****
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifySnatEntryResponse>
    <RequestId>2315DEB7-5E92-423A-91F7-4C1EC9AD97C3</RequestId>
</ModifySnatEntryResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 InvalidSnatIp。奇形 指定されたSnatIpは有効なIPアドレスではありません。 指定されたEIPが無効な場合に返されるエラーメッセージ。
400 Forbidden.SourceVSwitchId.Duplicated 指定されたSourceCIDRが複製されます。 指定されたvSwitchに対してSNATエントリが既に作成されている場合に返されるエラーメッセージ。
400 Forbidden.IpUsedInForwardTable 指定されたSnatIpは、転送テーブルで既に使用されています。 指定されたEIPがDNATエントリによってすでに使用されている場合に返されるエラーメッセージ。 別のEIPを選択するか、指定されたEIPを使用するDNATルールを削除します。
400 InvalidParameter.Name.Malformed 指定されたNameは無効です。 指定された名前の形式が無効な場合に返されるエラーメッセージ。 有効な形式で名前を指定します。
400 InvalidSnatEntryId.NotFound 指定されたSNATエントリが存在しません。 指定されたSNATエントリが存在しない場合に返されるエラーメッセージ。 SNATエントリが有効かどうかを確認します。
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。
404 InvalidSnatTableId.NotFound 指定されたSNATテーブルが存在しません。 指定されたSNATテーブルが存在しない場合に返されるエラーメッセージ。 SNATテーブルのIDが有効かどうかを確認します。
404 InvalidSnatIp.NotFound 指定されたSnatIpがNAT Gatewayに見つかりません 指定されたEIPがNATゲートウェイに存在しない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。