インターネットNATゲートウェイのサービス品質 (QoS) エントリを作成します。

使用上の注意

この操作を呼び出してインターネットNATゲートウェイのQoSエントリを作成する前に、インターネットNATゲートウェイのQoS機能が有効になっていることを確認してください。 NATゲートウェイのQoS機能を有効にする方法の詳細については、「EnableNatGatewayQosEntry」をご参照ください。

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

NATゲートウェイのリージョンID。

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

NatGatewayId String 必須 ngw-112za33e4 ****

NAT ゲートウェイの ID 。

EcsIp String 必須 192.168.1.6

QoSエントリを適用するECSインスタンスのIPアドレス。

説明 IPアドレスは、RFC定義のプライベートCIDRブロック (192.168.0.0/16、172.16.0.0/12、および10.0.0.0/8) に該当する必要があります。
QosEntryName String 必須 nametest

QoSエントリの名前。

名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。

QosEntryDesc String 必須 説明　

QoSエントリの説明。

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

QosTableId String 必須 qtb-gw8uztpwp2eiqz4un ****

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

クォータ Long 〇 5

QoSエントリを適用するECSインスタンスに許可される同時接続の最大数。

  • 最小値: 0。
  • 最大値: インターネットNATゲートウェイでサポートされている接続の最大数。 詳細については、「ModifyNatGatewaySpec」をご参照ください。
確立率 Long 〇 10

QoSエントリを適用するECSインスタンスに許可される1秒あたりの新規接続の最大数。

  • 最小値: 0。
  • 最大値: インターネットNATゲートウェイでサポートされている1秒あたりの新規接続の最大数。 詳細については、「ModifyNatGatewaySpec」をご参照ください。
ClientToken String 任意 123e4567-e89b-12d3-a456-426655440000

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

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

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

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B45

リクエストの ID です。

QosEntryId String qos-gw8rrbfsqmq5zdwb8 ****

QoSエントリのID。

例

リクエストの例

http(s)://[Endpoint]/? アクション=CreateNatGatewaySessionQosEntry
&RegionId=cn-hangzhou
&NatGatewayId=ngw-112za33e4 ****
&EcsIp=192.168.1.6
&QosEntryName=nametest
&QosEntryDesc=説明
&QosTableId=qtb-gw8uztpwp2eiqz4un ****
&クォータ=5
&EstablishRate=10
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&共通リクエストパラメータ

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

XML 形式 

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

<CreateNatGatewaySessionQosEntryResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <QosEntryId>qos-gw8rrbfsqmq5zdwb8 ****</QosEntryId>
</CreateNatGatewaySessionQosEntryResponse>

JSON 形式 

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45" 、
  "QosEntryId" : "qos-gw8rrbfsqmq5zdwb8 ****"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 InvalidNatGatewayId.NotFound NatGatewayId は存在しません。 指定されたNATゲートウェイIDが存在しない場合に返されるエラーメッセージ。 NatGatewayIdパラメーターの値が有効かどうかを確認します。
400 UnsupportedFeature.NatQosEntry 指定されたnatGatewayはqosエントリ機能をサポートできません。 NATゲートウェイがQoS機能をサポートしていない場合に返されるエラーメッセージ。
400 ResourceAlreadyExist.NatQosEntry 指定されたnatGateway qosEntryは既に存在します QoSエントリが既に存在する場合に返されるエラーメッセージ。

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