rebuildContainer
描述
重置原生容器,对已有原生容器使用新的镜像重置。
原容器 id 不变,不涉及计费变动,暂不支持修改实例类型,不会改变原生容器所在的物理节点,也不支持修改已经使用的系统盘和数据盘以及网络相关参数。
- 镜像
- 容器的镜像通过镜像名称来确定
- nginx:tag 或 mysql/mysql-server:tag 这样命名的镜像表示 docker hub 官方镜像
- container-registry/image:tag 这样命名的镜像表示私有仓储的镜像
- 私有仓储必须兼容 docker registry 认证机制,并通过 secret 来保存机密信息
- 其他
- rebuild 之前容器必须处于关闭状态
- rebuild 完成后,容器仍为关闭状态
请求方式
POST
请求地址
https://nativecontainer.jdcloud-api.com/v1/regions/{regionId}/containers/{containerId}:rebuild
名称 |
类型 |
是否必需 |
默认值 |
描述 |
regionId |
String |
True |
|
Region ID |
containerId |
String |
True |
|
Container ID |
请求参数
名称 |
类型 |
是否必需 |
默认值 |
描述 |
image |
String |
True |
|
镜像名称 1. Docker Hub官方镜像通过类似nginx, mysql/mysql-server的名字指定 repository长度最大256个字符,tag最大128个字符,registry最大255个字符 下载镜像超时时间:10分钟 |
secret |
String |
False |
|
镜像仓库认证信息;使用Docker Hub和京东云CR的镜像不需要secret |
command |
String[ ] |
False |
|
容器启动执行的命令, 如果不指定默认是镜像的ENTRYPOINT. 数组字符总长度范围:[0-256] |
args |
String[ ] |
False |
|
容器启动执行命令的参数, 如果不指定默认是镜像的CMD. 数组字符总长度范围:[0-2048] |
tty |
Boolean |
False |
|
容器是否分配tty。默认不分配 |
workingDir |
String |
False |
|
容器的工作目录。如果不指定,默认是根目录(/),必须是绝对路径。字符长度范围:[0-1024] |
envs |
EnvVar[ ] |
False |
|
容器执行的环境变量;如果和镜像中的环境变量Key相同,会覆盖镜像中的值; 最大100对 |
EnvVar
名称 |
类型 |
是否必需 |
默认值 |
描述 |
name |
String |
True |
|
环境变量名称 |
value |
String |
False |
|
环境变量的值 |
返回参数
名称 |
类型 |
描述 |
requestId |
String |
|
返回码
返回码 |
描述 |
200 |
OK |
400 |
Invalid parameter |
401 |
Authentication failed |
404 |
Not found |
500 |
Internal server error |
503 |
Service unavailable |