Docker は、Docker Hub リポジトリに関連する情報にアクセスする Docker Hub v1 API エンドポイントを 2022 年 9 月 5 日に廃止する予定です。
文脈
現時点では、Docker Hub 上の v1 API コンシューマーの数が、このバージョンの Hub API を維持するための妥当なしきい値を下回っていることがわかりました。 さらに、Hub API 要求の約 95% は、新しい v2 API を対象としています。 この決定は、最高の開発者エクスペリエンスを提供し続けることができるように、サービスの安定性とパフォーマンスの向上を確保するために行われました。
これはあなたにどのような影響を与えますか?
9 月 5 日以降、v1 パス内の次の API ルートは機能しなくなり、404 状態コードが返されます。
- /v1/リポジトリ/<name>/イメージ
- /v1/リポジトリ/<name>/タグ
- /v1/repositories/<name>/tags/<tag_name>
- /v1/repositories/<namespace>/<name>/images
- /v1/リポジトリ/<namespace>/<name>/タグ
- /v1/repositories/<namespace>/<name>/tags/<tag_name>
現在のアプリケーションで Docker Hub API を引き続き使用する場合は、v2 エンドポイントを使用するようにクライアントを更新する必要があります。 v2 API の使用方法に関する追加のドキュメントと技術的な詳細については、次の場所を参照してください。 https://docs.docker.com/docker-hub/api/latest/
v1 API を v2 API に置き換えるにはどうすればよいですか
v1 ハブ API を使用している場合は、次の方法で v2 ハブ API に置き換えることができます。 これらの変更の一部は、オープンコンテナイニシアチブ(OCI)配布仕様に準拠しています。
| 非推奨の v1 API | 代わりに使用できる新しい v2 API |
| •/v1/リポジトリ/<name>/イメージ •/v1/リポジトリ/<namespace>/<name>/イメージ | •/v2/namespaces/{名前空間}/リポジトリ/{リポジトリ}/images |
| •/v1/リポジトリ/<name>/タグ •/v1/リポジトリ/<namespace>/<name>/タグ | •/v2/namespaces/{名前空間}/リポジトリ/{リポジトリ}/tags |
| •/v1/リポジトリ/<name>/タグ/<tag_name> •/v1/リポジトリ<namespace>/<name>/ /タグ<tag_name>/ | •/v2/repository/{名前空間}/{リポジトリ}/tags/{tag} |
これらの変更の詳細については、 ドキュメントを参照してください。
追加のヘルプをどのように取得しますか?
Hub v1 APIの非推奨プロセスについてさらに質問や懸念がある場合は、 [メール保護].