更新镜像仓库版本状态-UpdateImageRepositoryVersionsStatus
功能介绍
更新镜像仓库版本状态/取消镜像版本推送
URI
POST /v1.0/{project_id}/common/image-registry/image-repos/{id}/versions/{version}/status
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目id,获取方法请参见获取项目ID |
id | 是 | Long | 镜像仓库id |
version | 是 | Integer | 版本号 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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 | 系统内部错误 |
错误码
请参见错误码。

