Adds public IP addresses to a NAT bandwidth package.

This action is available only if you purchased a NAT bandwidth package before January 26, 2018. If your account does not have a NAT bandwidth package purchased before January 26, 2018, you can associate an Elastic IP Address (EIP).

For more information, see AssociateEipAddress.


Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
Action String Yes AddBandwidthPackageIps

The name of this action.

Value: AddBandwidthPackageIps

RegionId String Yes cn-hangzhou

The ID of the region to which the NAT bandwidth package belongs. To query the region ID, call DescribeRegions.

IpCount String Yes 2

The number of public IP addresses in the NAT bandwidth package. Value range: 1 to 50

BandwidthPackageId String Yes bwp-s6lmotmkkxxxxxxxx

The ID of the NAT bandwidth package.

ClientToken String No 02fb3da4-130e-11e9-8e44-0016e04115b

The client token that guarantees the idempotence of the request. The value of this parameter is generated by the client and is unique among different requests. The maximum length is 64 ASCII characters.

Response parameters

Parameter Type Example value Description
RequestId String EC0B5C51-7F40-44D6-A642-1DE764B547EC

The ID of the request.


Request example

Response example

XML format


JSON format



HTTP status code Error code Error message Description
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. The specified region ID does not exist.
400 InvalidIpCount.ValueNotSupported The specified value of IpCount not supported. The specified value of IpCount is invalid.
400 QuotaExceeded.BandwidthPackageIps The specified ipCount exceeded quota. The number of IP addresses has reached the quota.
404 BandwidthPackage.FinancialLocked The specified BandwidthPackage has been Financail Lock. The NAT bandwidth package is locked due to an overdue payment.

For a list of error codes, visit the API Error Center.