Creates an Internet Shared Bandwidth instance.

Debug

By using API Explorer, you can easily debug APIs, automatically generate SDK code examples, and quickly search for APIs.

Request parameters

Parameter Type Required? Example value Description 
Action String Yes CreateCommonBandwidthPackage

The name of this action. Value: 

CreateCommonBandwidthPackage

Bandwidth Integer Yes 5

The peak bandwidth in Mbps of the Internet Shared Bandwidth instance.

RegionId String  Yes cn-hangzhou

The ID of the region where the Internet Shared Bandwidth is located.

To query the region ID, call DescribeRegions.

ClientToken String No 02fb3da4-130e-11e9-8e44-0016e04115b

A client token used to guarantee the idempotence of requests. 

This parameter value is generated by the client and must be unique. It must be 1 to 64 ASCII characters in length.

Description String No Description

The description of the Internet Shared Bandwidth.

The description must be 2 to 256 characters in length. It must start with a letter, but cannot start with http:// or https://.

InternetChargeType String No PayByBandwidth

The billing method of the Internet Shared Bandwidth. Valid values:

PayByBandwidth (default): Pay by bandwidth

PayBy95: Pay by classic 95th percentile pricing.

Name String No test123

The name of the Internet Shared Bandwidth.

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

Ratio Integer No 100 The minimum percentage of the Internet Shared Bandwidth. Value range: 10 to 100 (that is, the range of the minimum percentage is 10% to 100%). This parameter is required when the PayBy95 billing method is selected.
ResourceGroupId String No rg-acfmxazb4ph6aiy

The ID of the resource group.

Request parameters

Parameter Type Example value Description
BandwidthPackageId String cbwp-bp1vevu8h3ieh5xkcdhdy

The ID of the Internet Shared Bandwidth instance.

RequestId String FF39F653-033E-4CD9-9EDF-3CCA5A71FBC3

The ID of the request.

ResourceGroupId String rsFAF424324-033E

The ID of the resource group.

Examples

Request example


https://vpc.aliyuncs.com/?Action=CreateCommonBandwidthPackage
&Bandwidth=5
&RegionId=cn-hangzhou
&<CommonParameters>
Response example
XML format
{<CreateCommonBandwidthPackageResponse>
  <BandwidthPackageId>cbwp-bp1vevu8h3ieh5xkcdhdy</BandwidthPackageId>
  <RequestId>FF39F653-033E-4CD9-9EDF-3CCA5A71FBC3</RequestId>
</CreateCommonBandwidthPackageResponse>

JSON format

<{
	"BandwidthPackageId":"cbwp-bp1vevu8h3ieh5xkcdhdy",
	"RequestId":"FF39F653-033E-4CD9-9EDF-3CCA5A71FBC3"
}

Error codes

HTTP status code Error code Error message Description
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. The specified region ID does not exist.
400 MissingParameter Miss mandatory parameter. Required parameters are missing.
404 InvalidZoneId.NotFound Specified value of ZoneId is not exists. The specified zone does not exist.
400 InvalidParameter.Name.Malformed The specified Name is not valid. The name is invalid.
400 InvalidParameter.Description.Malformed The specified Description is not valid. The description is invalid.

See common error codes