更新BEC服务
更新时间:2022-05-05
接口描述
本接口用于用户对创建的BEC容器服务进行更新操作,支持修改服务自定义名称、修改镜像版本信息、修改部署的实例数量、从IPv4变配支持IPv4/IPv6双栈。
请求结构
PUT /v1/service/{serviceId} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"deployInstances": [{
"regionId": "cn-yangzhou-cm",
"region": "EAST_CHINA",
"replicas": 1,
"city": "YANGZHOU",
"serviceProvider": "CHINA_MOBILE",
}],
"type": "replicas"
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
serviceId | String | 是 | URL参数 | 服务ID |
type | String | 是 | RequestBody参数 | 修改类型,取值为name、replicas、resource,分别表示要修改容器名字、实例数量、资源版本 |
serviceName | String | 否 | RequestBody参数 | 服务名称 |
containers | List<ContainerDetails> | 否 | RequestBody参数 | 容器组信息 |
deployInstances | List<DeploymentInstance> | 否 | RequestBody参数 | 部署地域信息 |
imageRegistrySecrets | List<ImageRegistrySecret> | 否 | RequestBody参数 | 镜像仓库凭据 |
bandwidth | Integer | 否 | RequestBody参数 | 带宽 |
needIpv6PublicIp | Boolean | 否 | RequestBody参数 | 是否开通IPv6公网,true为开通,false为不开通。type需指定为resource。只允许从IPv4变为IPv4/IPv6双栈。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
serviceId | String | 服务ID |
action | String | 操作服务的动作,更新:update |
错误码
请参照错误返回章节的内容。
请求示例
PUT /v1/service/s-asdaxxxx HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"deployInstances": [{
"regionId": "cn-yangzhou-cm",
"region": "EAST_CHINA",
"replicas": 1,
"city": "YANGZHOU",
"serviceProvider": "CHINA_MOBILE",
}],
"type": "replicas"
}
响应示例
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",
"action":"update"
}
DeploymentInstance
参数名称 | 类型 | 描述 |
---|---|---|
regionId | String | 节点ID,由“国家码-城市-运营商”的小写字母组成字符串。例如 cn-hangzhou-cm,其中国家码标准为ISO 3166-2,城市为拼音,运营商为中国移动cm/中国电信ct/中国联通un/三线ix,海外节点运营商为bgp。如果传regjionId,则可以不传region、serviceProvider、city。 |
region | String | 服务部署的地域 |
serviceProvider | String | 服务部署的运营商 |
city | String | 服务部署的城市 |
replicas | Integer | 服务部署的副本数 |
ImageRegistrySecret
参数名称 | 类型 | 描述 |
---|---|---|
name | String | 镜像仓库凭据名称 |