edit-icon download-icon

CreateCenBandwidthPackage

Last Updated: May 04, 2018

Description

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.

AreasRegions
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:

CreateCenBandwidthPackage

BandwidthPackageChargeType String No

The billing method. Valid value:

PREPAY

Bandwidth String Yes

The bandwidth in Mbps of the bandwidth package.

Note: The bandwidth cannot be less than 1 Mpbs.

GeographicRegionAIdStringYes

The area to connect. Valid value:

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

GeographicRegionBIdStringYes

The other area to connect. Valid value:

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

PricingCycleStringYes

The purchase period. The default value is 1.

PeriodStringNo

The pricing cycle. Valid value:

Month (Default value) | Year

AutoPayStringNo

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.

Examples

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>

JSONformat

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