You need to enable JavaScript to run this app.
导航
【产品公告】镜像推拉状态码以及返回信息优化
最近更新时间:2024.04.19 10:29:06首次发布时间:2024.04.19 10:29:06

为了方便用户在异常场景下,更好的了解错误原因,快速排障。镜像仓库将于 2024年6月25日 至 7月1日 分地域,对镜像推拉状态码及异常状态的返回信息进行优化。

注意

针对以下变更,请您及时评估变更影响。如果您判断此次变化对您实际业务存在影响,且无法在变更前完成处置,请在变更前 15~30 天 提交工单 或联系售后工作人员,避免变更影响。

状态码变更

以下是变更前后,异常状态码的变化。

变更点修改前修改后常见操作
资源达到配额上限401400。例如,推送的镜像仓库镜像版本数量达上限时,用户推镜像会收到 400 状态码,同时包含资源达上限的详细报错。镜像推送
服务端异常401500。例如,服务端异常场景中用户推拉镜像收到 500 状态码。镜像推送和拉取
OCI 制品仓库不存在401404。例如,用户具备权限,但拉取的目标镜像不存在时,收到 404 状态码,并返回镜像不存在的说明。镜像拉取

Token Service 行为变更

对于编程访问用户可能额外影响如下。

变更点修改前修改后常见操作
凭证异常时返回 Scope 为空的 Token返回 401 报错。镜像拉取

报错信息变更

说明

仅部分客户端可见,例如,Docker 和 Skopeo。

以下是变更前后,异常状态报错信息的变化。

场景修改前修改后常见操作
服务端异常401,仅有无权限报错。500,告知服务端异常。镜像推送和拉取
OCI 制品仓库不存在401,仅有无权限报错。404,告知镜像不存在。镜像拉取
凭证异常401,仅有无权限报错。401,告知具体错误。镜像拉取