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
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.