ModifyNatGatewaySpec - 接口修改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 性能的关系如下表所示。

规格最大连接数每秒新建连接数
小型1 万1 千
中型5 万5 千
大型20 万1 万

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vpc:ModifyNatGatewaySpec
*NatGateway
acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}

请求参数

名称类型必填描述示例值
RegionIdstring

公网 NAT 网关所属的地域 ID。

您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou
NatGatewayIdstring

要修改规格的公网 NAT 网关的 ID。

ngw-bp1uewa15k4iy5770****
Specstring

公网 NAT 网关的规格,取值:

  • Small:小型。

  • Middle:中型。

  • Large:大型。

Middle
AutoPayboolean

是否自动付费。

  • true:开启自动付费,自动支付订单。

  • false(默认值):不开启自动付费,生成订单后需要到订单中心完成支付。

false
ClientTokenstring

客户端 Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

123e4567-e89b-12d3-a456-426655****

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400NATGW_MODIFY_SPEC_SAMEThe specified Spec is same with now.该规格和当前规格一样。
400InvalidParameter.Spec.ValueNotSupportedThe specified Spec is not valid.该规格不合法。
400OperationFailed.SyncOrderToSubSyncOrderToSub error.操作失败
400OperationFailed.QueryPriceQuery price failed when create order.创建订单时查询价格失败。
404InvalidRegionId.NotFoundThe specified RegionId does not exist in our records.指定的RegionId不存在。
404InvalidNatGatewayId.NotFoundThe specified NatGatewayId does not exist in our records.指定的 NatGatewayId 不存在,请您检查填写的 NatGatewayId 是否正确。
404IncorrectStatus.NatGateway%s-
404OperationUnsupported.PayByLcuNatModifySpecThe spec of payByLcu nat is unsupported to modify.按量计费NAT网关的规格不支持修改
404Forbidden.ModifySpecToSpecialSpecYou are not authorized to modify nat spec to special spec.-
404Forbidden.ModifySpecToSpecialSpecForNormalNatNormal NAT is not allowed to change to special spec, only enhanced nat allowed.-
500OperationFailed.NoAvailableResourceThe Zone have no available resource.区域没有可用资源。

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

变更历史

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