All Products
Search
Document Center

Virtual Private Cloud:ConvertBandwidthPackage

Last Updated:Mar 04, 2024

Converts a NAT service plan to an Internet Shared Bandwidth instance.

Operation description

Before you convert a NAT service plan to an Internet Shared Bandwidth instance, take note of the following limits:

  • You are not charged for the conversion.
  • When you convert a NAT service plan to an Internet Shared Bandwidth instance, you can continue to use the SNAT and DNAT features of the NAT gateway, and your workloads are not affected. However, we recommend that you convert your NAT service plan during off-peak hours.
  • After the NAT service plan is converted to an Internet Shared Bandwidth instance, the public IP addresses in the NAT service plan are converted to elastic IP addresses (EIPs). The maximum bandwidth and billing method of the Internet Shared Bandwidth instance are the same as those of the NAT service plan.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
BandwidthPackageIdstringYes

The ID of the NAT service plan.

bwp-bp1xea10o8qxw4f****
RegionIdstringYes

The region where the NAT gateway resides. You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou
ClientTokenstringNo

The client token that is used to ensure the idempotency of the request. You can use the client to generate a client token. Make sure that a unique client token is used for each request. The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

123e4567-e89b-12d3-a456-426655440000

Response parameters

ParameterTypeDescriptionExample
object
ConvertInstanceIdstring

The ID of the Internet Shared Bandwidth instance.

bwp-s6lmotmkkf567b****
RequestIdstring

The request ID.

455AC20C-7061-446A-BDBD-B3BEE0856304

Examples

Sample success responses

JSONformat

{
  "ConvertInstanceId": "bwp-s6lmotmkkf567b****",
  "RequestId": "455AC20C-7061-446A-BDBD-B3BEE0856304"
}

Error codes

HTTP status codeError codeError messageDescription
400NotOpen.ApiThe api is not open.-
400NotFound.BandwidthPackageBandwidthPackage is not exist-
400ORDER.QUOTA_EXCEEDEDThe EIP quota is exceeded-
400ORDER.ERRORCreate order failed.Commodity configuration does not support.-
500InternalErrorThe request processing has failed due to some unknown error.An unknown error occurred.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-12-11API Description Update. The Error code has changedsee changesets
Change itemChange content
API DescriptionAPI Description Update.
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 500