This topic describes the differences in API operations between enhanced Internet NAT gateways and standard Internet NAT gateways.

CreateNatGateway

Before you call the CreateNatGateway operation to create an enhanced Internet NAT gateway, you must call the ListEnhanhcedNatGatewayAvailableZones operation to query the zones that support enhanced Internet NAT gateways in a specified region. Then, create a vSwitch or select a vSwitch that has idle IP addresses in the zone.
Item Enhanced Internet NAT gateway Standard Internet NAT gateway
How the API operation is called The operation is asynchronous.
CreateNatGateway is an asynchronous operation. After you make a request, the ID of an enhanced Internet NAT gateway is returned but the enhanced Internet NAT gateway is not created. The system creates the enhanced Internet NAT gateway in the background. You can call the DescribeNatGateways operation to query the status of enhanced Internet NAT gateways:
  • If an enhanced Internet NAT gateway is in the Creating state, the system is creating the enhanced Internet NAT gateway. You can only query the status of the enhanced Internet NAT gateway. You cannot perform other operations on the enhanced Internet NAT gateway.
  • If an enhanced Internet NAT gateway is in the Available state, the enhanced Internet NAT gateway is created.
The operation is synchronous.
Request parameters The following parameters are added:
  • VswitchId: required.
  • NatType: required.
  • InternetChargeType: optional.
N/A

DescribeNatGateways

The following table describes the differences in response parameters of the DescribeNatGateways operation between enhanced Internet NAT gateways and standard Internet NAT gateways.
Parameter Enhanced Internet NAT gateway Standard Internet NAT gateway
NatGatewayPrivateInfo Information about the private network of an enhanced Internet NAT gateway is returned in this new parameter. The parameter includes the following parameters:
  • EniInstanceId: the ID of the elastic network interface (ENI). This value of this parameter is a string, for example, eni-xaskc****.
  • PrivateIpAddress: the private IP address of the enhanced Internet NAT gateway. The value of this parameter is a string, for example, 192.XX.XX.1.
  • VswitchId: the ID of the vSwitch to which the enhanced Internet NAT gateway belongs. The value of this parameter is a string, for example, vsw-bp1s2laxhdf9ayjbo****.
  • MaxBandwidth: the maximum bandwidth of the enhanced Internet NAT gateway. Unit: Mbit/s. The value of this parameter is an integer, for example, 5120.
  • IzNo: the zone to which the enhanced Internet NAT gateway belongs. The value of this parameter is a string, for example, cn-hangzhou-b.
N/A
Status The following states are added:
  • Creating: After you send a request to create an enhanced Internet NAT gateway, the system creates the enhanced Internet NAT gateway in the background. The enhanced Internet NAT gateway remains in the Creating state until the operation is complete.
  • Modifying: After you send a request to modify an enhanced Internet NAT gateway, the system modifies the enhanced Internet NAT gateway in the background. The enhanced Internet NAT gateway remains in the Modifying state until the operation is complete.
  • Deleting: After you send a request to delete an enhanced Internet NAT gateway, the system deletes the enhanced Internet NAT gateway in the background. The enhanced Internet NAT gateway remains in the Deleting state until the operation is complete.
Available: After an enhanced Internet NAT gateway is created, it enters the Available state.
NatType Enhanced: enhanced Internet NAT gateway Normal: standard Internet NAT gateway
InternetChargeType
  • PayBySpec: pay-by-specification
  • PayByLcu: pay-by-CU
N/A

ModifyNatGatewaySpec

The following table describes the differences in the ModifyNatGatewaySpec operation between enhanced Internet NAT gateways and standard Internet NAT gateways.
Enhanced Internet NAT gateway Standard Internet NAT gateway
The operation is asynchronous.
ModifyNatGatewaySpec is an asynchronous operation. After you make a request, the ID of the request is returned but the enhanced Internet NAT gateway is not modified. The system modifies the enhanced Internet NAT gateway in the background. You can call the DescribeNatGateways operation to query the status of enhanced Internet NAT gateways:
  • If an enhanced Internet NAT gateway is in the Modifying state, the system is modifying the enhanced Internet NAT gateway. You can only query the status of the enhanced Internet NAT gateway. You cannot perform other operations on the enhanced Internet NAT gateway.
  • If an enhanced Internet NAT gateway is in the Available state, the enhanced Internet NAT gateway is modified.
The operation is synchronous.

DeleteNatGateway

The following table describes the differences in the DeleteNatGateway operation between enhanced Internet NAT gateways and standard Internet NAT gateways.
Enhanced Internet NAT gateway Standard Internet NAT gateway
The operation is asynchronous.
DeleteNatGateway is an asynchronous operation. After you make a request, the ID of the request is returned but the enhanced Internet NAT gateway is not deleted. The system deletes the enhanced Internet NAT gateway in the background. You can call the DescribeNatGateways operation to query the status of enhanced Internet NAT gateways:
  • If an enhanced Internet NAT gateway is in the Deleting state, the system is deleting the enhanced Internet NAT gateway. You can only query the status of the enhanced Internet NAT gateway. You cannot perform other operations on the enhanced Internet NAT gateway.
  • If the returned NAT gateway list is empty, the enhanced Internet NAT gateway is deleted.
The operation is synchronous.

New API operations supported by enhanced Internet NAT gateways

API Description
ListEnhanhcedNatGatewayAvailableZones Queries the zones that support enhanced Internet NAT gateways.
UpdateNatGatewayNatType Upgrades a standard Internet NAT gateway to an enhanced Internet NAT gateway.
GetNatGatewayConvertStatus Queries the upgrade status of an enhanced Internet NAT gateway.