创建共享带宽
更新时间：2025-01-02
接口描述
本接口用于创建共享带宽。
请求结构
POST /v1/eipgroup{?clientToken} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"regionId": "regionId",
"routeType": "routeType",
"ipVersion": "ipVersion",
"bandwidthInMbps": 20,
"eipCount": 1,
"name": "name",
"tags": [
{
"tagKey": "默认项目",
"tagValue": ""
}
],
"billing": {
"paymentTiming": "paymentTiming"
}
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| name | String | 否 | Request Body参数 | 共享带宽名称，支持大小写字母、数字、中文和“-_/.+“，长度1-64 |
| eipCount | Integer | 是 | Request Body参数 | 共享带宽中EIP的个数，公网IP数量最少为1个 |
| bandwidthInMbps | Integer | 是 | Request Body参数 | 公网带宽，单位为Mbps |
| routeType | String | 是 | Request Body参数 | 线路类型, ChinaTelcom、ChinaUnicom、ChinaMobile |
| tags | List<TagModel> | 否 | Request Body参数 | 标签信息 |
| billing | Billing | 是 | Request Body参数 | 订单信息 |
| ipVersion | String | 是 | Request Body参数 | IP地址类型，ipv4、ipv6 |
| regionId | String | 是 | Request Body参数 | 节点id |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 分配的实例ID |
请求示例
POST /v1/eipgroup?clientToken=14aca5fe-f899-4775-bdbf-4b1394126958 HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"regionId": "cn-changzhou1-ix",
"routeType": "ChinaTelcom",
"ipVersion": "ipv4",
"bandwidthInMbps": 20,
"eipCount": 1,
"name": "test",
"tags": [
{
"tagKey": "默认项目",
"tagValue": ""
}
],
"billing": {
"paymentTiming": "Postpaid"
}
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50
Date: Thu, 16 Mar 2022 06:29:48 GMT
Content Type: application/json;charset=UTF 8
Server: BWS
{
"id":"eg-kgmyswts"
}Modal对象定义
TagModel
| 参数名称 | 类型 | 描述 |
|---|---|---|
| tagKey | String | 标签键 |
| tagValue | String | 标签值 |
Billing
| 参数名称 | 类型 | 描述 |
|---|---|---|
| paymentTiming | String | 付款时间，后支付（Postpaid） |