Modifies the specification of a NAT Gateway.
API description
NAT Gateway comes in different specifications. The specification of a NAT Gateway determines the performance metrics (Max Connections and Connections Per Second) of SNAT, but does not relate to data throughput.
The relationship between the NAT Gateway specification and SNAT performance is as follows:
|
Specification |
Max Connections |
Connections Per Second (CPS) |
|---|---|---|
|
Small |
10,000 |
1,000 |
|
Middle |
50,000 |
5,000 |
|
Large |
200,000 |
10,000 |
Make the API call
Request parameters
| Parameter | Type | Required? | Example value | Description |
|---|---|---|---|---|
| Action | String | Yes | ModifyNatGatewaySpec |
The name of this action. Value: ModifyNatGatewaySpec |
| NatGatewayId | String | Yes | ngw-bp1uewa15k4iy5770**** |
The ID of the NAT Gateway. |
| RegionId | String | Yes | cn-hangzhou |
The ID of the region to which the NAT Gateway belongs. |
| Spec | String | Yes | Small |
The specification of the NAT Gateway. Valid values:
|
| ClientToken | String | No | SHA234js121223xxxxx |
The client token that guarantees the idempotence of the request. The value of this parameter is generated by the client. The value is unique among different requests and is 1 to 64 ASCII characters in length. For more information, see How to guarantee the idempotence? |
Response parameters
| Parameter | Type | Example value | Description |
|---|---|---|---|
| RequestId | String | DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D |
The ID of the request. |
Examples
Request example
https://vpc.aliyuncs.com/?Action=ModifyNatGatewaySpec
&NatGatewayId=ngw-bp1uewa15k4iy5770****
&RegionId=cn-hangzhou
&Spec=Small
&<Common request parameters>Response example
XML format
<ModifyNatGatewaySpecResponse>
<RequestId>DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D</RequestId>
</ModifyNatGatewaySpecResponse>JSON format
{
"RequestId":"DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D"
}Errors
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | The specified RegionId does not exist. |
| 404 | InvalidNatGatewayId.NotFound | The specified NatGatewayId does not exist in our records. | The specified NatGatewayId does not exist. |
| 400 | NATGW_MODIFY_SPEC_SAME | The specified Spec is same with now. | The specified specification is the same as the current one. |
| 400 | InvalidParameter.Spec.ValueNotSupported | The specified Spec is not valid. | The specification is invalid. |
For a list of error codes, visit the API Error Center.