Container Registryの概要

Prev Next

Classic/VPC環境で利用できます。

Container Registryは、Docker Registry v2スペックのプライベート Dockerコンテナイメージの保存場所で、コンテナイメージを簡単に保存・管理したり、デプロイしたりする NAVERクラウドプラットフォームのサービスです。
Container Registryサービスは、レジストリと Dockerコンテナイメージ管理機能関連の APIを RESTful形式で提供します。

Container Registryの共通設定

Container Registry APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

韓国リージョン: https://ncr.apigw.ntruss.com/ncr/api/v2
シンガポールリージョン: https://ncr.apigw.ntruss.com/ncr/sgn-api/v2
日本リージョン: https://ncr.apigw.ntruss.com/ncr/jpn-api/v2

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-timestamp Required 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
x-ncp-iam-access-key Required NAVERクラウドプラットフォームから発行された Access Key
x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名
Content-Type Required リクエストデータの形式
  • application/json

レスポンス

共通レスポンス形式を説明します。

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード メッセージ 説明
200 - OK リクエスト成功
201 - OK リクエスト成功
204 - OK リクエスト成功
400 - Bad Request HTTPSプロトコルまたは UTF-8エンコードによるリクエストエラー
401 - Unauthorized リクエストしたリソースを使用するための認証情報が提供されていないか、有効ではない
403 - Forbidden リクエストしたリソースに対する権限がない
404 - Not Found リクエストされたリソースが見つからない
409 - Conflict リクエストの処理中にクラッシュ発生
500 - Internal Server Error サーバエラー
参考

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

Container Registry API

Container Registryサービスで提供する APIの説明は次の通りです。

API 説明
レジストリリストの照会 Container Registryに登録されているレジストリリストを照会
新規レジストリの登録 Object Storageバケットと連携された新規レジストリを登録
レジストリの削除 Container Registryに登録されているレジストリを削除
イメージリストの照会 Container Registryのレジストリに登録されているイメージリストを照会
イメージの詳細情報の照会 Container Registryのレジストリに登録されているイメージの詳細情報を照会
イメージ情報の変更 Container Registryのレジストリに登録されているイメージの説明を変更
イメージの削除 Container Registryのレジストリに登録されているイメージを削除
イメージタグリストの照会 Container Registryのレジストリに登録されているイメージのタグリストを照会
イメージタグの詳細情報の照会 Container Registryのレジストリに登録されているイメージのタグ情報を照会
イメージタグの削除 Container Registryのレジストリに登録されているイメージのタグを削除

Container Registry関連リソース

Container Registry APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。