更新镜像仓库版本状态
功能介绍
更新镜像仓库版本状态/取消镜像版本推送
URI
POST /v1.0/{project_id}/common/image-registry/image-repos/{id}/versions/{version}/status
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目id,获取方法请参见获取项目ID |
id |
是 |
Long |
镜像仓库id 最小值:1 |
version |
是 |
Integer |
版本号 最小值:1 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
是 |
String |
内容类型。填application/json |
X-Auth-Token |
是 |
String |
用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action |
否 |
String |
可填值CANCEL_PUSH,表示将“推送中”和“二次推送中”的版本回退到上一个状态。 status和action字段至少填写一项,若两项都存在则action字段生效而忽略status字段 枚举值:
|
status |
否 |
Integer |
内部使用,用于其他服务自行构建镜像而不经过镜像仓库服务上传镜像的场景。版本创建时为“初始化”状态,构建完成后通过调用该接口并将status的值设置为0表示镜像构建完成。 status和action字段至少填写一项,若两项都存在则action字段生效而忽略status字段 枚举值:
|
响应参数
无
请求示例
取消推送
POST https://{endpoint}/v1.0/{project_id}/common/image-registry/image-repos/10001/versions/1/status { "action" : "CANCEL_PUSH" }
响应示例
无
状态码
状态码 |
描述 |
---|---|
200 |
修改完成 |
400 |
参数校验失败 |
401 |
身份认证失败 |
403 |
权限校验失败 |
404 |
找不到镜像仓库或版本 |
409 |
镜像版本当前状态不满足要求 |
500 |
系统内部错误 |
错误码
请参见错误码。