ModifyNatGatewaySpec - 接口修改NAT网关的规格 - NAT 网关

使用ModifyNatGatewaySpec接口修改预付费公网NAT网关的规格。

接口说明

ModifyNatGatewaySpec 接口不支持预付费公网 NAT 网关规格降配，请在控制台执行降配操作。
ModifyNatGatewaySpec 接口在执行预付费公网 NAT 网关规格升配时，会生成升配订单，请在订单中心进行支付，支付完成后，公网 NAT 网关升配即可成功。
ModifyNatGatewaySpec 接口属于异步接口，即系统会先返回一个请求 ID，但该公网 NAT 网关实例的规格并未变配完成，系统后台的变配任务仍在进行。您可以调用 DescribeNatGateways 查询公网 NAT 网关的状态：
- 当公网 NAT 网关处于 Modifying 状态时，表示公网 NAT 网关正在变配中，在该状态下，您只能执行查询操作，不能执行其他操作。
- 当公网 NAT 网关处于 Available 状态时，表示公网 NAT 网关变配完成。
ModifyNatGatewaySpec 接口不支持并发修改按规格计费 NAT 网关实例的规格。

公网 NAT 网关提供不同的规格。公网 NAT 网关的规格会影响 SNAT 功能的最大连接数和每秒新建连接数，但不会影响数据吞吐量。公网 NAT 网关规格与 SNAT 性能的关系如下表所示。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作	访问级别	资源类型	条件关键字	关联操作
vpc:ModifyNatGatewaySpec		NatGateway acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}	无	无

名称	类型	必填	描述	示例值
RegionId	string	是	公网 NAT 网关所属的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-hangzhou
NatGatewayId	string	是	要修改规格的公网 NAT 网关的 ID。	ngw-bp1uewa15k4iy5770****
Spec	string	是	公网 NAT 网关的规格，取值： Small：小型。 Middle：中型。 Large：大型。	Middle
AutoPay	boolean	否	是否自动付费。 true：开启自动付费，自动支付订单。 false（默认值）：不开启自动付费，生成订单后需要到订单中心完成支付。	false
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。	123e4567-e89b-12d3-a456-426655****

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D

正常返回示例

JSON格式

{
  "RequestId": "DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D"
}

HTTP status code	错误码	错误信息	描述
400	NATGW_MODIFY_SPEC_SAME	The specified Spec is same with now.	该规格和当前规格一样。
400	InvalidParameter.Spec.ValueNotSupported	The specified Spec is not valid.	该规格不合法。
400	OperationFailed.SyncOrderToSub	SyncOrderToSub error.	操作失败
400	OperationFailed.QueryPrice	Query price failed when create order.	创建订单时查询价格失败。
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 是否正确。
404	IncorrectStatus.NatGateway	%s	-
404	OperationUnsupported.PayByLcuNatModifySpec	The spec of payByLcu nat is unsupported to modify.	按量计费NAT网关的规格不支持修改
404	Forbidden.ModifySpecToSpecialSpec	You are not authorized to modify nat spec to special spec.	-
404	Forbidden.ModifySpecToSpecialSpecForNormalNat	Normal NAT is not allowed to change to special spec, only enhanced nat allowed.	-
500	OperationFailed.NoAvailableResource	The Zone have no available resource.	区域没有可用资源。

访问错误中心查看更多错误码。

变更时间	变更内容概要	操作
2023-03-01	OpenAPI 错误码发生变更	查看变更详情
2022-07-22	OpenAPI 错误码发生变更	查看变更详情