更新时间:2024-02-06 GMT+08:00
分享

更新镜像仓库版本状态

功能介绍

更新镜像仓库版本状态/取消镜像版本推送

URI

POST /v1.0/{project_id}/common/image-registry/image-repos/{id}/versions/{version}/status

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id,获取方法请参见获取项目ID

id

Long

镜像仓库id

最小值:1

version

Integer

版本号

最小值:1

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

内容类型。填application/json

X-Auth-Token

String

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

表3 请求Body参数

参数

是否必选

参数类型

描述

action

String

可填值CANCEL_PUSH,表示将“推送中”和“二次推送中”的版本回退到上一个状态。 status和action字段至少填写一项,若两项都存在则action字段生效而忽略status字段

枚举值:

  • CANCEL_PUSH

status

Integer

内部使用,用于其他服务自行构建镜像而不经过镜像仓库服务上传镜像的场景。版本创建时为“初始化”状态,构建完成后通过调用该接口并将status的值设置为0表示镜像构建完成。 status和action字段至少填写一项,若两项都存在则action字段生效而忽略status字段

枚举值:

  • 0

响应参数

请求示例

取消推送

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

系统内部错误

错误码

请参见错误码

相关文档