为了方便用户在异常场景下，更好的了解错误原因，快速排障。镜像仓库将于 2024年6月25日 至 7月1日 分地域，对镜像推拉状态码及异常状态的返回信息进行优化。
注意
针对以下变更，请您及时评估变更影响。如果您判断此次变化对您实际业务存在影响，且无法在变更前完成处置，请在变更前 15~30 天 提交工单 或联系售后工作人员，避免变更影响。
以下是变更前后，异常状态码的变化。
| 变更点 | 修改前 | 修改后 | 常见操作 |
|---|---|---|---|
| 资源达到配额上限 | 401 | 400。例如，推送的镜像仓库镜像版本数量达上限时，用户推镜像会收到 400 状态码，同时包含资源达上限的详细报错。 | 镜像推送 |
| 服务端异常 | 401 | 500。例如，服务端异常场景中用户推拉镜像收到 500 状态码。 | 镜像推送和拉取 |
| OCI 制品仓库不存在 | 401 | 404。例如，用户具备权限，但拉取的目标镜像不存在时，收到 404 状态码，并返回镜像不存在的说明。 | 镜像拉取 |
对于编程访问用户可能额外影响如下。
| 变更点 | 修改前 | 修改后 | 常见操作 |
|---|---|---|---|
| 凭证异常时 | 返回 Scope 为空的 Token | 返回 401 报错。 | 镜像拉取 |
说明
仅部分客户端可见，例如，Docker 和 Skopeo。
以下是变更前后，异常状态报错信息的变化。
| 场景 | 修改前 | 修改后 | 常见操作 |
|---|---|---|---|
| 服务端异常 | 401，仅有无权限报错。 | 500，告知服务端异常。 | 镜像推送和拉取 |
| OCI 制品仓库不存在 | 401，仅有无权限报错。 | 404，告知镜像不存在。 | 镜像拉取 |
| 凭证异常 | 401，仅有无权限报错。 | 401，告知具体错误。 | 镜像拉取 |