Modifies the quality of service (QoS) entry of an Internet NAT gateway.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyNatGatewaySessionQosEntry

The operation that you want to perform. Set the value to ModifyNatGatewaySessionQosEntry.

RegionId String Yes cn-hangzhou

The region ID of the Internet NAT gateway.

You can call the DescribeRegions operation to query the most recent region list.

NatGatewayId String Yes ngw-112za33e4****

The ID of the Internet NAT gateway for which you want to modify the QoS entry.

QosEntryId String Yes qos-gw8rrbfsqmq5zdwb8****

The ID of the QoS entry.

QosEntryName String Yes nametest

The name of the QoS entry.

The name must be 2 to 128 characters in length, and can contain letters, digits, underscores (_), and hyphens (-). The name must start with a letter.

QosEntryDesc String Yes Description

The description of the QoS entry.

The description must be 2 to 256 characters in length. It must start with a letter but cannot start with http:// or https://.

Quota Long No 5

The maximum number of concurrent connections allowed for the Elastic Compute Service (ECS) instance to which you want to apply the QoS entry. Unit: connections.

  • Minimum value: 0.
  • Maximum value: the maximum number of connections that is supported by the Internet NAT gateway. For more information about the maximum number of connections that is supported by an Internet NAT gateway, see ModifyNatGatewaySpec.
EstablishRate Long No 10

The maximum number of new connections per second allowed for the ECS instance to which you want to apply the QoS entry. Unit: connections.

  • Minimum value: 0.
  • Maximum value: the maximum number of new connections that is supported by the Internet NAT gateway per second. For more information about the maximum number of new connections that is supported by an Internet NAT gateway per second, see ModifyNatGatewaySpec.
ClientToken String No 123e4567-e89b-12d3-a456-426655440000

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must make sure that it is unique among different requests. The token can only contain ASCII characters.

Note If you do not specify this parameter, the system uses RequestId as ClientToken. RequestId may be different for each API request.

Response parameters

Parameter Type Example Description
RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B45

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyNatGatewaySessionQosEntry
&RegionId=cn-hangzhou
&NatGatewayId=ngw-112za33e4****
&QosEntryId=qos-gw8rrbfsqmq5zdwb8****
&QosEntryName=nametest
&QosEntryDesc=Description
&Quota=5
&EstablishRate=10
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Common request parameters

Sample success responses

XML format

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

<ModifyNatGatewaySessionQosEntryResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
</ModifyNatGatewaySessionQosEntryResponse>

JSON format

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

Error codes

HTTP status code Error code Error message Description
400 InvalidNatGatewayId.NotFound The NatGatewayId not exist. The error message returned because the ID of the Internet NAT gateway does not exist. Check whether the value of the NatGatewayId parameter is valid.
400 InvalidNatGatewayId.NotFound The specified NatGatewayId does not exist in our records. The error message returned because the ID of the Internet NAT gateway does not exist. Check whether the value of the NatGatewayId parameter is valid.
400 InvalidParam.NotFound Parameter must not be null The error message returned because a required parameter is empty.
400 InvalidParams.NotFound instance not found The error message returned because the specified instance does not exist.
400 ResourceNotFound.QosTableIdOrNatGatewayId natGatewayId and qosTableId can not both be null The error message returned because both the NatGatewayId and QosTableId parameters are empty. Specify at least one of the parameters.
400 UnsupportedFeature.NatQosEntry The specified natGateway can not support the qos entry feature. The error message returned because the Internet NAT gateway does not support the QoS feature.

For a list of error codes, visit the API Error Center.