创建服务网卡
更新时间：2025-04-30
描述
创建服务网卡
请求结构
Plain Text
1POST /v{version}/endpoint?clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4 {
5 "vpcId": vpcId,
6 "name": name,
7 "subnetId": subnetId,
8 "service":service,
9 "description": description,
10 "ipAddress": ipAddress,
11 "bandwidth": 20,
12 "billing": {
13 "paymentTiming": "Postpaid"
14 },
15 "tags": [
16 {
17 "tagKey": "tagkey",
18 "tagValue": "tagvalue"
19 }
20 ],
21 "resourceGroupId": "RESG-UoMgbkuLNjj"
22 } 请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见ClientToken幂等性 |
| vpcId | String | 是 | RequestBody参数 | 所属vpc的id |
| name | String | 是 | RequestBody参数 | 服务网卡的名称，大小写字母、数字以及-_/.特殊字符、中文，必须以字母开头，长度1-65 |
| subnetId | String | 是 | RequestBody参数 | 所在子网的id |
| service | String | 是 | RequestBody参数 | 挂载的服务域名 |
| description | String | 否 | RequestBody参数 | 服务网卡描述 |
| ipAddress | String | 否 | RequestBody参数 | 指定服务网卡ip地址,不传自动分配ip地址 |
| bandwidth | Integer | 是 | RequestBody参数 | 指定服务网卡带宽 |
| billing | Billing | 是 | RequestBody参数 | 计费信息 |
| tags | List<TagModel> | 否 | RequestBody参数 | 标签 |
| resourceGroupId | String | 否 | RequestBody参数 | 资源组 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 服务网卡的id |
| ipAddress | String | ip地址 |
请求示例
Plain Text
1POST /v1/endpoint?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "vpcId": "vpc-IyWRtII7",
7 "name": "name",
8 "subnetId": "sbn-1A09ef6b",
9 "service": "www.test.com",
10 "description": "",
11 "ipAddress": "192.168.0.1",
12 "bandwidth": 20,
13 "billing": {
14 "paymentTiming": "Postpaid"
15 },
16 "tags": [
17 {
18 "tagKey": "tagkey",
19 "tagValue": "tagvalue"
20 }
21 ],
22 "resourceGroupId": "RESG-UoMgbkuLNjj"
23 } 返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Thu, 16 Mar 2017 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7 {
8 "id": "endpoint-11b09ce6",
9 "ipAddress": "192.168.0.1"
10 }