创建实例
更新时间：2025-08-20
接口描述
创建一个BCI容器实例。
请求结构
Plain Text
1POST /v{version}/instance HTTP/1.1
2Host: bci.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2。 |
| clientToken | String | 否 | Query参数 | 保证请求幂等性。 从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持ASCII字符，且不能超过64个字符。 |
| name | String | 是 | RequestBody参数 | BCI实例名称，即容器组名称。 长度必须介于2和252之间，有效的名称必须由字母数字字符、“-”或“.”组成，并且必须以字母数字字符开始和结束。 如果填写大写字母，后台会自动转为小写。 |
| zoneName | String | 否 | RequestBody参数 | 可用区名称 |
| securityGroupIds | List<String> | 是 | RequestBody参数 | 实例所属于的安全组ID。 所有安全组、子网应属于同一个VPC。 数量上限：10 |
| subnetIds | List<String> | 是 | RequestBody参数 | 实例所属的子网ID。 所有子网应该属于同一个VPC，不可重复。 数量上限：10 |
| restartPolicy | String | 否 | RequestBody参数 | 实例重启策略。 取值范围： Always：总是重启。 Never：从不重启。 OnFailure：失败时重启。 默认值：Always |
| eipIp | String | 否 | RequestBody参数 | 弹性公网IP |
| autoCreateEip | Boolean | 否 | RequestBody参数 | 是否自动创建一个EIP，并绑定到BCI实例上。 只有当eipIp为空的情况下，此字段才生效。 默认值：false |
| eipName | String | 否 | RequestBody参数 | 弹性公网名称。 当autoCreateEip为true时，此字段才生效。 默认值：eip |
| eipRouteType | String | 否 | RequestBody参数 | EIP线路类型，包含标准BGP（BGP）和增强BGP（BGP_S）。 当autoCreateEip为true时，此字段才生效。 默认值：BGP |
| eipBandwidthInMbps | Integer | 否 | RequestBody参数 | 公网带宽，单位：Mbps。 对于预付费以及按使用带宽计费的后付费EIP，标准型BGP限制为1~500之间的整数，增强型BGP限制为100~5000之间的整数（代表带宽上限）；对于按使用流量计费的后付费EIP， 标准型BGP限制为1~200之间的整数（代表允许的带宽流量峰值）。 如果填写浮点数会向下取整。 当autoCreateEip为true时，此字段才生效。 默认值：100 |
| eipBillingMethod | String | 否 | RequestBody参数 | 计费方式，按流量（ByTraffic）、按带宽（ByBandwidth）、按增强95（ByPeak95）（只有共享带宽后付费支持）。 当autoCreateEip为true时，此字段才生效。 增强型BGP_S不支持按流量计费（ByTraffic），需要按带宽计费（ByBandwidth）。 默认值：ByTraffic |
| gpuType | String | 否 | RequestBody参数 | 实例所需的 GPU 资源型号。 目前仅支持：Nvidia A10 PCIE。 |
| terminationGracePeriodSeconds | Long | 否 | RequestBody参数 | 程序的缓冲时间。 用于处理关闭之前的操作。 |
| hostName | String | 否 | RequestBody参数 | 主机名称 |
| tags | List<Tag> | 否 | RequestBody参数 | 用户标签列表 |
| imageRegistryCredentials | List<ImageRegistryCredential> | 否 | RequestBody参数 | 镜像仓库凭证信息 |
| containers | List<Container> | 是 | RequestBody参数 | 业务容器组 |
| initContainers | List<Container> | 否 | RequestBody参数 | Init 容器 |
| volume | Volume | 是 | RequestBody参数 | 数据卷信息。 名称不可重复，有效名称必须由小写字母数字字符或“-”组成，并且必须以字母数字字符开头和结尾。 |
响应头域
除公共头域外，无其它特殊头域。
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| instanceId | String | BCI容器实例ID |
请求示例
Plain Text
1POST /v2/instance HTTP/1.1
2Host: bci.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "name": "mybci",
8 "zoneName": "zoneC",
9 "securityGroupIds": ["g-59gf44p4jmwe"],
10 "subnetIds": ["sbn-g463qx0aqu7q"],
11 "restartPolicy":"Always",
12 "tags":[
13 {
14 "tagKey":"pod",
15 "tagValue":"tag"
16 }
17 ],
18 "imageRegistryCredentials": [
19 {
20 "server":"docker.io/wywcoder",
21 "userName":"wywcoder",
22 "password":"Qaz123456"
23 }
24 ],
25 "containers":[
26 {
27 "name":"container01",
28 "image":"registry.baidubce.com/bci-zjm-public/ubuntu:18.04",
29 "memory":0.25,
30 "cpu":0.25,
31 "workingDir":"",
32 "imagePullPolicy":"Always",
33 "commands":[
34 "/bin/sh",
35 "-c",
36 "sleep 30000 && exit 0"
37 ],
38 "args":[
39
40 ],
41 "volumeMounts":[
42 {
43 "mountPath":"/usr/local/share",
44 "readOnly":false,
45 "name":"emptydir",
46 "type":"EmptyDir"
47 },
48 {
49 "mountPath":"/config",
50 "readOnly":false,
51 "name":"configfile",
52 "type":"ConfigFile"
53 }
54 ],
55 "ports":[
56 {
57 "port":8099,
58 "protocol":"TCP"
59 }
60 ],
61 "environmentVars":[
62 {
63 "key":"java",
64 "value":"/usr/local/jre"
65 }
66 ]
67 }
68 ],
69 "volume":{
70 "nfs":[],
71 "emptyDir":[
72 {
73 "name":"emptydir"
74 }
75 ],
76 "configFile":[
77 {
78 "name":"configfile",
79 "configFiles":[
80 {
81 "path":"podconfig",
82 "file":"filenxx"
83 }
84 ]
85 }
86 ]
87 }
88}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Tue, 06 Sep 2016 10:08:44 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7{
8 "instanceId": "p-khyaaskt"
9}