edit-icon download-icon


Last Updated: May 04, 2018


Create a bandwidth package.

A bandwidth package is required only for cross-regional communication. When purchasing a bandwidth package, you must specify the interconnection areas for the network resources to communicate.

An area is a collection of Alibaba Cloud regions. areas in CEN include China Mainland, Asia Pacific, North America, and Europe as listed in the following table.

Mainland China China (Qingdao), China (Beijing), China (Zhangjiakou), China (Shenzhen), China (Hangzhou), China (Shanghai), China (Hohhot)
North America US (Silicon Valley), US (Virginia)
Asia Pacific Hong Kong, Singapore, Malaysia (Kuala Lumpur), Japan (Tokyo), India (Mumbai), Indonesia (Jakarta)
Europe Germany (Frankfurt)

Request parameters

Name Type Required Description
Action String Yes

The action to perform. Valid value:


BandwidthPackageChargeType String No

The billing method. Valid value:


Bandwidth String Yes

The bandwidth in Mbps of the bandwidth package.

Note: The bandwidth cannot be less than 1 Mpbs.


The area to connect. Valid value:

China | North-America | Asia-Pacific | Europe | Middle-East


The other area to connect. Valid value:

China | North-America | Asia-Pacific | Europe | Middle-East


The purchase period. The default value is 1.


The pricing cycle. Valid value:

Month (Default value) | Year


Enable the automatic payment. Valid value:

true (default value) | false

ClientToken AutoPay No A client token used to guarantee the idempotence of requests. For more information, see Ensure Idempotency.
Name String No

The name of the bandwidth package.

The name can contain [2,128] characters and numbers, underlines, and hyphens, and the name must start with English letters, but cannot start with http:// or https://.

CenIdStringNoThe ID of the CEN instance to bind.

Response parameters

Name Type Description
RequestId String The ID of the request.
CenBandwidthPackageId String The ID of the bandwidth package.

Error codes

The following table lists the error codes specific to this API. For more information about common error codes, see Common error codes.

Error code Error message HTTP status code Description
ParameterIllegal.GeoRegionId The parameter of geographic region id is illegal. 400 Invalid interconnection areas.


Request example

  1. http://cbn.aliyuncs.com/?Action=CreateCenBandwidthPackage
  2. &Bandwidth=2
  3. &GeographicRegionAId=China
  4. &GeographicRegionBId=China
  5. &<Common parameters>

Response example

XML format

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <CreateCenBandwidthPackageResponse>
  3. <RequestId>E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B</RequestId>
  4. <CenBandwidthPackageId> Cenbwp-stb2axpqzzko2jagd7</CenBandwidthPackageId>
  5. </CreateCenBandwidthPackageResponse>


  1. {
  2. "RequestId":"E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B",
  3. "CenBandwidthPackageId":"Cenbwp-stb2axpqzzko2jagd7"
  4. }
Thank you! We've received your feedback.