Converts a NAT bandwidth package to an Internet Shared Bandwidth instance.

API description

Before you convert a NAT bandwidth package to an Internet Shared Bandwidth instance, make sure you are aware of the following:

  • The conversion does not incur any additional fees.
  • The conversion does not affect the SNAT or DNAT entries of the NAT Gateway, and has no impact on the running services. However, we recommend that you perform the conversion during off-peak hours.
  • After the conversion, the public IP address in the NAT bandwidth package is converted to an EIP. The peak bandwidth and billing method of the Internet Shared Bandwidth instance are consistent with those of the original NAT bandwidth package.

Make the API call

You can use OpenAPI Explorer to make API calls, search for API calls, perform debugging, and generate SDK example code.

Request parameters

Parameter Type Required? Example value Description
Action String Yes ConvertBandwidthPackage

The name of this action. Value: ConvertBandwidthPackage.

BandwidthPackageId String Yes bwp-bp1xea10o8qxw4f****

The ID of the NAT bandwidth package.

RegionId String Yes cn-hangzhou

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

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

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 ClientToken value is 1 to 64 ASCII characters in length. For more information, see How to ensure idempotence.

Response parameters

Parameter Type Example value Description
ConvertInstanceId String cbwp-s6lmotmkkf567b****

The ID of the Internet Shared Bandwidth instance after the conversion.

RequestId String 0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50

The ID of the request.

Examples

Request example


http(s)://[Endpoint]/? Action=ConvertBandwidthPackage
&BandwidthPackageId=bwp-bp1xea10o8qxw4f****
&RegionId=cn-hangzhou
&<CommonParameters>

Response example

XML format

<ConvertBandwidthPackageResponse>
	  <RequestId>0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50</RequestId>
	  <ConvertInstanceId>cbwp-s6lmotmkkf567b****</ConvertInstanceId>
</ConvertBandwidthPackageResponse>

JSON format

{
	"RequestId":"0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50",
	"ConvertInstanceId":"cbwp-s6lmotmkkf567b****"
}

Errors

HTTP status code Error code Error message Description
500 InternalError The request processing has failed due to some unknown error. The request failed to be processed due to unknown errors.

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