调用UpdateNatGatewayNatType接口将普通型NAT网关升级为增强型NAT网关。

API描述

调用UpdateNatGatewayNatType接口前,请先了解:

  • UpdateNatGatewayNatType接口属于异步接口,即系统会先返回一个请求ID,但NAT网关的网关类型并未升级完成,系统后台的升级任务仍在进行。您可以调用GetNatGatewayConvertStatus查询NAT网关的升级状态,更多信息,请参见GetNatGatewayConvertStatus
    • 当NAT网关的升级状态处于processing时,表示正在升级中,在该状态下,您只能执行查询操作,不能执行其他操作。
    • 当NAT网关的升级状态处于successful时,表示NAT网关的网关类型升级完成。
    • 当NAT网关的升级状态处于failed时,表示NAT网关的网关类型升级失败。
  • 增强型NAT网关与普通型NAT网关的计费相同,升级过程和升级后不会产生新的计费。
  • 每个资源升级过程可能会持续5分钟,升级过程中会出现1~2次秒级闪断,业务重连即可恢复。
  • 仅支持将普通型NAT网关升级至增强型NAT网关,不支持将增强型NAT网关降级至普通型NAT网关。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String UpdateNatGatewayNatType

要执行的操作,取值:UpdateNatGatewayNatType

NatGatewayId String ngw-bp1b0lic8uz4r6vf2****

要升级网关类型的NAT网关实例ID。

NatType String Enhanced

NAT网关类型,仅可取值:Enhanced(增强型NAT网关)。

RegionId String cn-qingdao

要升级的NAT网关所属的地域ID。

VSwitchId String vsw-bp17nszybg8epodke****

增强型NAT网关所属的交换机。

说明 如果不传该参数,系统会随机将增强型NAT网关创建在VPC内的任意一台交换机。
DryRun Boolean false

是否只预检此次请求,取值:

true:发送请求,不会升级NAT网关类型。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码DryRunOperation

false(默认值):发送正常请求,通过检查后返回2XX HTTP状态码并直接升级NAT网关类型。

ClientToken String 0c593ea1-3bea-11e9-b96b-88e9fe637760

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。

返回数据

名称 类型 示例值 描述
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

示例

请求示例

http(s)://vpc.aliyuncs.com/?Action=UpdateNatGatewayNatType
&NatGatewayId=ngw-bp1b0lic8uz4r6vf2****
&NatType=Enhanced
&RegionId=cn-qingdao
&VSwitchId=vsw-bp17nszybg8epodke****
&<公共请求参数>

正常返回示例

XML 格式

<UpdateNatGatewayNatTypeResponse>    
      <RequestId>7C01CA72-73FD-4056-B16A-42E392D47625</RequestId>
</UpdateNatGatewayNatTypeResponse>

JSON 格式

{
	"RequestId": "7C01CA72-73FD-4056-B16A-42E392D47625"
}