使用ModifyNatGatewaySpec接口修改预付费公网NAT网关的规格。
使用说明
- ModifyNatGatewaySpec接口不支持预付费公网NAT网关规格降配,请在控制台执行降配操作。
- ModifyNatGatewaySpec接口在执行预付费公网NAT网关规格升配时,会生成升配订单,请在订单中心进行支付,支付完成后,公网NAT网关升配即可成功。
ModifyNatGatewaySpec接口属于异步接口,即系统会先返回一个请求ID,但该公网NAT网关实例的规格并未变配完成,系统后台的变配任务仍在进行。您可以调用DescribeNatGateways查询公网NAT网关的状态:
- 当公网NAT网关处于Modifying状态时,表示公网NAT网关正在变配中,在该状态下,您只能执行查询操作,不能执行其他操作。
- 当公网NAT网关处于Available状态时,表示公网NAT网关变配完成。
公网NAT网关提供不同的规格。公网NAT网关的规格会影响SNAT功能的最大连接数和每秒新建连接数,但不会影响数据吞吐量。公网NAT网关规格与SNAT性能的关系如下表所示。
规格 |
最大连接数 |
每秒新建连接数 |
---|---|---|
小型 |
1万 |
1千 |
中型 |
5万 |
5千 |
大型 |
20万 |
1万 |
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyNatGatewaySpec |
要执行的操作。取值:ModifyNatGatewaySpec。 |
NatGatewayId | String | 是 | ngw-bp1uewa15k4iy5770**** |
要修改规格的公网NAT网关的ID。 |
RegionId | String | 是 | cn-hangzhou |
公网NAT网关所属的地域ID。 您可以通过调用DescribeRegions接口获取地域ID。 |
Spec | String | 是 | Middle |
公网NAT网关的规格,取值:
|
AutoPay | Boolean | 否 | false |
是否自动付费。
|
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655**** |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ModifyNatGatewaySpec
&NatGatewayId=ngw-bp1uewa15k4iy5770****
&RegionId=cn-hangzhou
&Spec=Middle
&<公共请求参数>
正常返回示例
XML
格式
<ModifyNatGatewaySpecResponse>
<RequestId>DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D</RequestId>
</ModifyNatGatewaySpecResponse>
JSON
格式
{
"RequestId": "DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | 指定的RegionId不存在。 |
404 | InvalidNatGatewayId.NotFound | The specified NatGatewayId does not exist in our records. | 指定的 NatGatewayId 不存在,请您检查填写的 NatGatewayId 是否正确。 |
400 | NATGW_MODIFY_SPEC_SAME | The specified Spec is same with now. | 该规格和当前规格一样。 |
400 | InvalidParameter.Spec.ValueNotSupported | The specified Spec is not valid. | 该规格不合法。 |
访问错误中心查看更多错误码。