Create Shared Bandwidth
Last Updated：2020-10-21
- Create a shared bandwidth.
- Identity Verification is needed for creation of shared bandwidth, and if you fail to pass identity verification, you can go to identity verification under security authentication in Baidu Open Cloud Console for authentication.
- Currently, only the creation of prepaid shared bandwidth is supported.
Request structure
POST /v{version}/eipgroup?clientToken={clientToken} HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: authorization string
{
"name": name,
"eipCount": eipCount,
"bandwidthInMbps": bandwidthInMbps,
"billing":{
"paymentTiming": paymentTiming,
"billingMethod": billingMethod,
"reservation":{
"reservationLength": reservationLength,
"reservationTimeUnit": reservationTimeUnit
}
}
}Request header
There are no other special headers except the public headers.
Request parameter
| Parameter name | Type | Required or not | Parameter position | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number (the current value is 1) |
| clientToken | String | Yes | Query parameter | Idempotence Token, for details, please see clientToken |
| eipCount | int | Yes | RequestBody parameter | Number of EIP in shared bandwidth. The number of public network IP is 2 at least, and at most n can be contained (n*5Mbps less than total amount of shared bandwidth packet) |
| bandwidthInMbps | int | Yes | RequestBody parameter | Public network bandwidth, in Mbps. For the EIP Group of prepay type, it is limited to an integer between 10 and 200. |
| billing | Billing | Yes | RequestBody parameter | Order information |
| name | String | No | RequestBody parameter | It is 1-65 bytes in length beginning with a letter. It can contain letters, numbers and characters of -_/.. If this parameter is not transmitted, the service generates a name automatically. |
Return status code
200 is returned successfully, for the failed return, please see Error Code.
Return header
There are no other special headers except the public headers.
Return parameter
| Parameter name | Type | Description |
|---|---|---|
| id | String | Assigned instance ID |
Request example, prepaid
POST /v1/eipgroup?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST eip.bj.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
{
"name":"eipgroup-for-test",
"eipCount": 5,
"bandwidthInMbps": 1,
"billing":{
"paymentTiming":"Prepaid",
"reservation":{
"reservationLength":1,
"reservationTimeUnit":"Month"
}
}
}Response example
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"id":"eg-b2511000"
}