已弃用的 Docker Hub API 端点

Table of contents

本页概述了 Docker Hub API 中已弃用的端点。

端点弃用策略

随着 Docker 的更新，有时需要移除或替换现有端点，以使用较新的端点。在移除现有端点之前，文档中会将其标记为“已弃用”。一段时间后，该端点可能会被移除。

已弃用的端点

下表概述了已弃用端点的当前状态：

已弃用：该端点被标记为“已弃用”，不应再使用。

该端点可能会在未来的版本中被移除、禁用或更改行为。

已移除：该端点已被移除、禁用或隐藏。

状态 功能 日期
已弃用 弃用未文档化的创建/获取仓库 2025-09-19
已弃用 弃用 /v2/repositories/{namespace} 2025-06-27
创建弃用日志表 2025-06-27
已移除 Docker Hub API v1 弃用 2022-08-23

弃用旧版 CreateRepository 和 GetRepository

弃用未文档化的端点：

  • POST /v2/repositories 和 POST /v2/repositories/{namespace} 被 创建仓库 替代。
  • GET /v2/repositories/{namespace}/{repository} 被 获取仓库 替代。
  • HEAD /v2/repositories/{namespace}/{repository} 被 检查仓库 替代。

弃用旧版 ListNamespaceRepositories

弃用未文档化的端点 GET /v2/repositories/{namespace}，被 列出仓库 替代。

创建弃用日志表

重新格式化页面

Docker Hub API v1 弃用

Docker Hub API v1 已被弃用。请改用 Docker Hub API v2。

v1 路径中的以下 API 路由将不再工作，并返回 410 状态码：

  • /v1/repositories/{name}/images
  • /v1/repositories/{name}/tags
  • /v1/repositories/{name}/tags/{tag_name}
  • /v1/repositories/{namespace}/{name}/images
  • /v1/repositories/{namespace}/{name}/tags
  • /v1/repositories/{namespace}/{name}/tags/{tag_name}

如果您希望继续在现有应用程序中使用 Docker Hub API，请将您的客户端更新为使用 v2 端点。

旧 新
/v1/repositories/{name}/tags /v2/namespaces/{namespace}/repositories/{repository}/tags
/v1/repositories/{namespace}/{name}/tags /v2/namespaces/{namespace}/repositories/{repository}/tags
/v1/repositories/{namespace}/{name}/tags /v2/namespaces/{namespace}/repositories/{repository}/tags/{tag}
/v1/repositories/{namespace}/{name}/tags/{tag_name} /v2/namespaces/{namespace}/repositories/{repository}/tags/{tag}