创建节点
更新时间：2026-09-09
- 创建一个BCI容器实例。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/instance?clientToken={clientToken} HTTP/1.1
2Host: bci.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "name": name,
7 "securityGroupIds": securityGroupIds,
8 "subnetIds": subnetIds,
9 "containers": containers,
10 "volume": volume
11}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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 |
| eipIp | String | 否 | RequestBody参数 | 弹性公网IP |
| autoCreateEip | Boolean | 否 | RequestBody参数 | 是否自动创建EIP并绑定，仅eipIp为空时生效，默认false |
| eipName | String | 否 | RequestBody参数 | 弹性公网名称，autoCreateEip为true时生效，默认"eip" |
| eipRouteType | String | 否 | RequestBody参数 | EIP线路类型：BGP（标准）或BGP_S（增强），默认BGP |
| eipBandwidthInMbps | Integer | 否 | RequestBody参数 | 公网带宽(Mbps)，标准BGP 1-500，增强BGP 100-5000，按流量计费标准BGP 1-200，默认100 |
| eipBillingMethod | String | 否 | RequestBody参数 | 计费方式：ByTraffic（按流量，默认）、ByBandwidth（按带宽）、ByPeak95（按增强95） |
| 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参数 | 数据卷信息，名称不可重复，由小写字母数字或"-"组成 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| 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 "volumeMounts": [
40 {
41 "mountPath": "/usr/local/share",
42 "readOnly": false,
43 "name": "emptydir",
44 "type": "EmptyDir"
45 },
46 {
47 "mountPath": "/config",
48 "readOnly": false,
49 "name": "configfile",
50 "type": "ConfigFile"
51 }
52 ],
53 "ports": [
54 {
55 "port": 8099,
56 "protocol": "TCP"
57 }
58 ],
59 "environmentVars": [
60 {
61 "key": "java",
62 "value": "/usr/local/jre"
63 }
64 ]
65 }
66 ],
67 "volume": {
68 "nfs": [],
69 "emptyDir": [
70 {
71 "name": "emptydir"
72 }
73 ],
74 "configFile": [
75 {
76 "name": "configfile",
77 "configFiles": [
78 {
79 "path": "podconfig",
80 "file": "filenxx"
81 }
82 ]
83 }
84 ]
85 }
86}响应示例
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
5
6{
7 "instanceId": "p-khyaaskt"
8}评价此篇文章