Creates a bandwidth package.

API description

Before you can use a CEN instance to connect network instances that belong to different regions, you must create a bandwidth package according to the area where the network instances belong.

An area consists of one or more Alibaba Cloud regions. CEN areas include Mainland China, Asia Pacific, North America, Europe, and Australia. The following table shows the CEN areas and their respective regions.

Area

Regions

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

China (Hong Kong), Singapore, Malaysia (Kuala Lumpur), Japan (Tokyo), Indonesia (Jakarta), India (Mumbai)

Europe

Germany (Frankfurt), UK (London)

Australia

Australia (Sydney)

Debug

Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
Bandwidth Integer Yes 2

The peak bandwidth of the bandwidth package. Unit: Mbps. Minimum value: 2.

GeographicRegionAId String Yes China

The area to which the network instance belongs. Valid values:

China | North-America | Asia-Pacific | Europe | Australia

GeographicRegionBId String Yes China

The area to which the network instance belongs. Valid values:

China | North-America | Asia-Pacific | Europe | Australia

Action String No CreateCenBandwidthPackage

The name of this action. Value: CreateCenBandwidthPackage

ClientToken String No SSJFLAFHHFHFF-SJSJJFBWHHE-SHHFJJDBD

The client token that guarantees the idempotence of the request. The value of this parameter is generated by the client. The value must be unique among different requests and must be 1 to 64 ASCII characters in length.

Name String No cen

The name of the bandwidth package. The name must be 2 to 128 characters in length and can contain letters, numbers, periods (.), underscores (_), and hyphens (-). The name must start with a letter, but cannot start with http:// or https://.

Description String No Bandwidth Package

The description of the bandwidth package.

BandwidthPackageChargeType String No PREPAY

The billing method of the bandwidth package. Valid values:

  • POSTPAY: pay-as-you-go
  • PREPAY: subscription
Note POSTPAY is only supported by the international site.
Period Integer No 1

The duration of the bandwidth package. The default value is 1.

PricingCycle String No Month

The billing cycle of the bandwidth package. Valid values:

  • Month (default): billed by month
  • Year: billed by year
AutoPay Boolean No true

Indicates whether the bandwidth package is paid automatically. Valid values:

  • true: The bandwidth package is paid automatically.
  • false (default): The bandwidth package is paid manually.

Response parameters

Parameter Type Example value Description
CenBandwidthPackageId String cenbwp-4c2zaavbvh5fx****

The ID of the bandwidth package.

CenBandwidthPackageOrderId String 201564200040390

The order ID of the bandwidth package.

RequestId String 6547D2DA-4383-46A0-9E39-BA324492AD9F

The ID of the request.

Examples

Request example


http(s)://[Endpoint]/? Action=CreateCenBandwidthPackage
&Bandwidth=2
&GeographicRegionAId=China 
&GeographicRegionBId=China 
&<CommonParameters>

Response example

XML format

<CreateCenBandwidthPackageResponse>
      <RequestId>E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B</RequestId>
      <CenBandwidthPackageOrderId>201564200040390</CenBandwidthPackageOrderId>
      <CenBandwidthPackageId> Cenbwp-stb2axpqzzko2j****</CenBandwidthPackageId>
</CreateCenBandwidthPackageResponse>

JSON format

{
	"CenBandwidthPackageOrderId":"201564200040390",
	"RequestId":"E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B",
	"CenBandwidthPackageId":"Cenbwp-stb2axpqzzko2j****"
}

Errors

HTTP status code Error code Error message Description
400 UnSupported.ChargeType The charge type is not supported. This payment type is not supported.

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