创建BEC服务
接口描述
创建BEC服务接口,在用户开通BEC服务之后进行部署BEC服务。
请求结构
POST /v1/service/create HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"serviceName":"baidu-bec",
"paymentMethod":"postpay",
"containerGroupName":"baidu-bec-pod",
"needPublicIp":true,
"bandwidth": 100,
"containers":[
{
"name":"containers1",
"imageAddress":"nginx",
"imageVersion":"v1.0",
"cpu":4,
"memory":8,
"workingDir":"/home",
"commands":[
"/bin/sh"
],
"args":[
"sleep 3600"
],
"ports":[
{
"containerPort":80,
"protocol":"TCP"
}
],
"envs":[
{
"name":"name",
"value":"baidu"
}
],
"volumeMounts":[
{
"name":"baidu-config",
"readOnly":false,
"mountPath":"/temp"
}
]
}
],
"tags":[
{
"tagKey":"service",
"tagValue":"bec"
}
],
"deployInstances":[
{
"region":"EAST_CHINA",
"serviceProvider":"CHINA_TELECOM",
"replicas":1
}
],
"volume":{
"secret":[
{
"name":""
}
],
"configMap":[
{
"name":"baidu-config"
}
],
"volumeClaimTemplates":[
{
"name":"volume",
"storageSize":1,
"diskType":"NVME"
}
],
"emptyDir":[
{
"name":""
}
]
},
"imageRegistrySecrets":[
{
"name":""
}
]
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 |
类型 |
是否必需 |
参数位置 |
描述 |
serviceName |
String |
是 |
RequestBody参数 |
服务名称 |
paymentMethod |
String |
否 |
RequestBody参数 |
付费方式,只支持后付费postpay |
containerGroupName |
String |
是 |
RequestBody参数 |
容器组名称 |
needPublicIp |
boolean |
否 |
RequestBody参数 |
是否购买公网IP,缺省否 |
bandwidth |
Int |
否 |
RequestBody参数 |
当needPublicIp为true时,用于设置外网带宽,范围为1Mps到2048Mps,可开通白名单上限增加到5120Mps |
containers |
List |
是 |
RequestBody参数 |
容器组信息 |
deployInstances |
List |
是 |
RequestBody参数 |
部署地域信息 |
volume |
Volume |
否 |
RequestBody参数 |
存储卷信息 |
imageRegistrySecrets |
List |
否 |
RequestBody参数 |
镜像仓库凭据 |
tags |
List |
否 |
RequestBody参数 |
标签信息 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 |
类型 |
描述 |
serviceId |
String |
服务ID |
错误码
请参照前文的统一错误码和平台错误码。
请求示例
POST /v1/service/create HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"serviceName":"baidu-bec",
"paymentMethod":"postpay",
"containerGroupName":"baidu-bec-pod",
"needPublicIp":false,
"containers":[
{
"name":"containers1",
"imageAddress":"nginx",
"imageVersion":"v1.0",
"cpu":4,
"memory":8,
"workingDir":"/home",
"commands":[
"/bin/sh"
],
"args":[
"sleep 3600"
],
"ports":[
{
"containerPort":80,
"protocol":"TCP"
}
],
"envs":[
{
"name":"name",
"value":"baidu"
}
],
"volumeMounts":[
{
"name":"baidu-config",
"readOnly":false,
"mountPath":"/temp"
}
]
}
],
"tags":[
{
"tagKey":"service",
"tagValue":"bec"
}
],
"deployInstances":[
{
"region":"EAST_CHINA",
"serviceProvider":"CHINA_TELECOM",
"replicas":1
}
],
"volume":{
"secret":[
{
"name":""
}
],
"configMap":[
{
"name":"baidu-config"
}
],
"volumeClaimTemplates":[
{
"name":"volume",
"storageSize":1,
"diskType":"NVME"
}
],
"emptyDir":[
{
"name":""
}
]
},
"imageRegistrySecrets":[
{
"name":""
}
]
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"serviceId":"s-xart2shr"
}
数据类型
Model对象定义
ContainerDetails
参数名称 |
类型 |
描述 |
name |
String |
容器的名称 |
cpu |
float |
容器申请的CPU核数 |
memory |
float |
容器申请的内存大小 |
imageAddress |
String |
镜像地址 |
imageVersion |
Striing |
镜像版本 |
workingDir |
String |
容器工作目录 |
commands |
List |
容器启动命令 |
args |
List |
容器启动参数 |
volumeMounts |
List |
容器数据卷信息 |
ports |
List |
容器端口协议 |
envs |
List |
容器环境变量 |
V1VolumeMount
参数名称 |
类型 |
描述 |
name |
String |
容器数据卷名称 |
mountPath |
String |
容器数据卷挂载路径 |
readOnly |
String |
容器数据卷是否只读 |
V1ContainerPort
参数名称 |
类型 |
描述 |
protocol |
String |
容器暴露端口协议 |
containerPort |
String |
容器暴露端口 |
V1EnvVar
参数名称 |
类型 |
描述 |
name |
String |
容器环境变量key |
value |
String |
容器环境变量value |
ImageRegistrySecret
参数名称 |
类型 |
描述 |
name |
String |
镜像仓库凭据名称 |
Volume
参数名称 |
类型 |
描述 |
emptyDir |
List |
emptyDir存储卷 |
configMap |
List |
configMap存储卷 |
secret |
List |
密钥 & 凭据存储卷 |
volumeClaimTemplates |
List |
数据盘存储卷 |
EmptyDir/ConfigFile/Secret
参数名称 |
类型 |
描述 |
name |
String |
EmptyDir/ConfigFile/Secret存储卷名称 |
VolumeClaimTemplates
参数名称 |
类型 |
描述 |
name |
String |
数据盘存储卷名称 |
storageSize |
int |
数据盘存储卷容量大小 |
diskType |
String |
数据盘存储卷类型(HDD类型:NVME,SSD类型:SATA) |
Tag
参数名称 |
类型 |
描述 |
tagKey |
String |
标签的key |
tagValue |
String |
标签的value |
DeploymentInstance
参数名称 |
类型 |
描述 |
region |
String |
服务部署的地域 |
serviceProvider |
String |
服务部署的运营商 |
replicas |
int |
服务部署的副本数 |
ServiceBriefVo
参数名称 |
类型 |
描述 |
region |
String |
服务部署的地域 |
serviceProvider |
String |
服务部署的运营商 |
replicas |
int |
服务部署的副本数 |