更新镜像仓库版本状态-UpdateImageRepoVersionStatus

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

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
octopus:imageRepo:update	Write	workspace *	-	-	-

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，获取方法请参见获取项目ID。约束限制：不涉及取值范围：只能用小写字母 a-z 和数字 0-9组成，且长度为32个字符默认取值：不涉及
id	是	Long	参数解释：镜像仓库id 约束限制：不涉及取值范围：不涉及默认取值：不涉及
version	是	Integer	参数解释：版本号约束限制：不涉及取值范围：不涉及默认取值：不涉及

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	参数解释：内容类型。填application/json 约束限制：不涉及取值范围：不涉及默认取值：不涉及
X-Auth-Token	是	String	参数解释：用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）约束限制：不涉及取值范围：不涉及默认取值：不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
action	否	String	参数解释：表示将“推送中”和“二次推送中”的版本回退到上一个状态约束限制： status和action字段至少填写一项，若两项都存在则action字段生效而忽略status字段取值范围： CANCEL_PUSH 默认取值：不涉及
status	否	Integer	参数解释：内部使用，用于其他服务自行构建镜像而不经过镜像仓库服务上传镜像的场景。版本创建时为“初始化”状态，构建完成后通过调用该接口并将status的值设置为0表示镜像构建完成约束限制： status和action字段至少填写一项，若两项都存在则action字段生效而忽略status字段取值范围：不涉及默认取值：不涉及

状态码：200

修改完成

无

取消推送

POST https://{endpoint}/v1.0/{project_id}/common/image-registry/image-repos/10001/versions/1/status

{
  "action" : "CANCEL_PUSH"
}

无