创建实例
更新时间：2023-06-20
接口描述
创建一个BCI容器实例。
请求结构
POST /v{version}/instance HTTP/1.1
Host: bci.bj.baidubce.com
Authorization: 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 |
请求示例
POST /v2/instance HTTP/1.1
Host: bci.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"name": "mybci",
"zoneName": "zoneC",
"securityGroupIds": ["g-59gf44p4jmwe"],
"subnetIds": ["sbn-g463qx0aqu7q"],
"restartPolicy":"Always",
"tags":[
{
"tagKey":"pod",
"tagValue":"tag"
}
],
"imageRegistryCredentials": [
{
"server":"docker.io/wywcoder",
"userName":"wywcoder",
"password":"Qaz123456"
}
],
"containers":[
{
"name":"container01",
"image":"registry.baidubce.com/bci-zjm-public/ubuntu:18.04",
"memory":0.25,
"cpu":0.25,
"workingDir":"",
"imagePullPolicy":"Always",
"commands":[
"/bin/sh",
"-c",
"sleep 30000 && exit 0"
],
"args":[
],
"volumeMounts":[
{
"mountPath":"/usr/local/share",
"readOnly":false,
"name":"emptydir",
"type":"EmptyDir"
},
{
"mountPath":"/config",
"readOnly":false,
"name":"configfile",
"type":"ConfigFile"
}
],
"ports":[
{
"port":8099,
"protocol":"TCP"
}
],
"environmentVars":[
{
"key":"java",
"value":"/usr/local/jre"
}
]
}
],
"volume":{
"nfs":[],
"emptyDir":[
{
"name":"emptydir"
}
],
"configFile":[
{
"name":"configfile",
"configFiles":[
{
"path":"podconfig",
"file":"filenxx"
}
]
}
]
}
}响应示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tue, 06 Sep 2016 10:08:44 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"instanceId": "p-khyaaskt"
}