更新BEC容器服务
更新时间:2022-05-17
接口描述
该接口用于更新BEC容器服务。
请求结构
Plain Text
1PUT /v2/service/{serviceId}?clientToken={clientToken} HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string
4{
5 "bandwidth": 0,
6 "containers": [
7 {
8 "args": [],
9 "commands": [],
10 "cpu": 0,
11 "envs": [
12 {
13 "name": "",
14 "value": "",
15 "valueFrom": {
16 "configMapKeyRef": {
17 "key": "",
18 "name": "",
19 "optional": true
20 },
21 "fieldRef": {
22 "apiVersion": "",
23 "fieldPath": ""
24 },
25 "resourceFieldRef": {
26 "containerName": "",
27 "divisor": "",
28 "resource": ""
29 },
30 "secretKeyRef": {
31 "key": "",
32 "name": "",
33 "optional": true
34 }
35 }
36 }
37 ],
38 "imageAddress": "",
39 "imageVersion": "",
40 "memory": 0,
41 "name": "",
42 "ports": [
43 {
44 "containerPort": 0,
45 "hostIP": "",
46 "hostPort": 0,
47 "name": "",
48 "protocol": ""
49 }
50 ],
51 "volumeMounts": [
52 {
53 "mountPath": "",
54 "mountPropagation": "",
55 "name": "",
56 "readOnly": true,
57 "subPath": ""
58 }
59 ],
60 "workingDir": ""
61 }
62 ],
63 "deployInstances": [
64 {
65 "city": "",
66 "region": "",
67 "regionId": "",
68 "replicas": 0,
69 "serviceProvider": ""
70 }
71 ],
72 "imageRegistrySecrets": [
73 {
74 "name": ""
75 }
76 ],
77 "kernelParam": "",
78 "needIpv6PublicIp": true,
79 "serviceName": "",
80 "type": ""
81}
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
---|---|---|---|---|
request | 更新服务请求体 | body | 是 | UpdateBecServiceForm |
bandwidth | 带宽 | 否 | number(float) | |
containers | 容器组信息 | 否 | array | |
args | 容器启动参数 | 否 | array | |
commands | 容器启动命令 | 否 | array | |
cpu | 容器申请的CPU核数 | 否 | integer | |
envs | 容器环境变量 | 否 | array | |
name | 容器环境变量key。 | 是 | string | |
value | 容器环境变量value. | 否 | string | |
imageAddress | 镜像地址 | 否 | string | |
imageVersion | 镜像版本 | 否 | string | |
memory | 容器申请的内存大小 | 否 | integer | |
name | 容器的名称 | 否 | string | |
ports | 容器端口协议 | 否 | array | |
protocol | 容器暴露端口协议,必须是UDP、TCP、SCTP其中一种。默认是TCP。 | 否 | string | |
volumeMounts | 容器数据卷信息 | 否 | array | |
mountPath | 容器数据卷挂载路径 | 是 | string | |
name | 容器数据卷名称。 | 是 | string | |
readOnly | 容器数据卷是否只读,默认否 | 否 | boolean | |
workingDir | 容器工作目录 | 否 | string | |
deployInstances | 部署地域信息 | 否 | array | |
city | 服务部署的城市 | 否 | string | |
region | 服务部署的地域 | 否 | string | |
regionId | 服务部署的节点ID | 否 | string | |
replicas | 服务部署的副本数 | 否 | integer | |
serviceProvider | 服务部署的运营商,可用值:BGP,CHINA_MOBILE, CHINA_UNICOM,CHINA_TELECOM,TRIPLE_LINE,INTRA |
否 | string | |
imageRegistrySecrets | 镜像仓库凭据 | 否 | array | |
name | 镜像仓库凭据名称 | 否 | string | |
needIpv6PublicIp | 是否开通IPv6公网,true为开通,false为不开通。type需指定为resource。 只允许从IPv4变为IPv4/IPv6双栈。 |
否 | boolean | |
serviceName | 服务名称 | 否 | string | |
type | 修改类型,取值为name、replicas、resource,分别表示要修改 容器名字、实例数量、资源版本 |
是 | string | |
serviceId | 服务ID | path | 是 | string |
clientToken | 幂等性Token,是一个长度不超过64位的ASCII字符串 | query | 否 | string |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 参数说明 | 类型 |
---|---|---|
deployInstances | 服务部署实例信息 | array |
city | 城市 | string |
cityName | 城市中文名 | string |
country | 国家 | string |
countryName | 国家中文名 | string |
networkType | 网络类型 | string |
region | 区域 | string |
regionName | 区域中文名 | string |
replicas | 副本数量 | integer |
serviceProvider | 运营商,可用值:BGP,CHINA_MOBILE,CHINA_UNICOM, CHINA_TELECOM,TRIPLE_LINE,INTRA |
string |
spName | 运营商中文名 | string |
regions | 服务部署区域个数 | integer |
runningPods | 服务RUNNING POD数 | integer |
serviceId | 服务Id | string |
serviceName | 服务名称 | string |
status | 资源状态,可用值:STARTING,RUNNING,PENDING,EXCEPTION, FAILED,UNKNOWN,TERMINATED,WAITING,STOP,BINDING,STOPPING, TERMINATING,DELETING,NORMAL |
string |
totalCpu | 服务CPU总数 | integer |
totalDisk | 服务磁盘总数 | integer |
totalGpu | 服务GPU总数 | integer |
totalMem | 服务内存总数 | integer |
totalPods | 服务POD总数 | integer |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1 PUT /v2/service/{serviceId} HTTP/1.1
2 Host: bec.baidubce.com
3 Authorization: authorization string
4 {
5 "deployInstances": [{
6 "regionId": "cn-yangzhou-cm",
7 "region": "EAST_CHINA",
8 "replicas": 1,
9 "city": "YANGZHOU",
10 "serviceProvider": "CHINA_MOBILE",
11 }],
12 "type": "replicas"
13 }
响应示例
Plain Text
1 HTTP/1.1 200 OK
2 Content-Type: application/json;charset=UTF-8
3 Date: Wed, 08 Jul 2015 03:28:11 GMT
4 x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5 Server: BWS
6{
7 "result": true,
8 "action": "update",
9 "details": [
10 {
11 "serviceId": "s-d6le3kd6",
12 "serviceName": "test-**",
13 "level": null,
14 "status": "STARTING",
15 "totalCpu": 2,
16 "totalMem": 4,
17 "totalGpu": 0,
18 "totalDisk": 0,
19 "regions": 2,
20 "totalPods": 2,
21 "runningPods": 1,
22 "tagsMap": null,
23 "deployInstances": [
24 {
25 "regionId": "cn-*-cm",
26 "replicas": 1,
27 "region": "*",
28 "serviceProvider": "CHINA_MOBILE",
29 "city": "TAIYUAN",
30 "regionName": "华北",
31 "spName": "移动",
32 "cityName": "太原",
33 "country": "CHINA",
34 "countryName": "中国"
35 },
36 {
37 "regionId": "cn-*-cm",
38 "replicas": 1,
39 "region": "EAST_CHINA",
40 "serviceProvider": "CHINA_MOBILE",
41 "city": "HANGZHOU",
42 "regionName": "华东",
43 "spName": "移动",
44 "cityName": "杭州",
45 "country": "CHINA",
46 "countryName": "中国"
47 }
48 ],
49 "createTime": "2022-04-13T03:25:26Z",
50 "lastUpdateTime": null
51 }
52 ]
53}