イメージタグリストの照会

Prev Next

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

Container Registryのレジストリに登録されているイメージのタグリストを照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET /repositories/{registry}/{imageName}/tags

リクエストヘッダ

Container Registry APIで共通して使用されるヘッダの詳細は、Container Registryの共通ヘッダをご参照ください。

リクエストパスパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
registry String Required タグリスト照会対象のイメージが登録されているレジストリの名前
imageName String Required タグリスト照会対象イメージの名前
  • URIエンコード値を使用
  • <例> hello/worldの場合、hello%2Fworldに変換して使用

リクエストクエリパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
page Number Optional 照会するページ番号
  • ページ番号は0より大きい値を入力
pagesize Number Optional 照会するページサイズ
  • ページサイズは0より大きい値を入力

リクエスト例

リクエストのサンプルコードは次の通りです。

curl -X GET "https://ncr.apigw.ntruss.com/ncr/api/v2/repositories/{registry}/tags" 
-H "x-ncp-apigw-timestamp: {Timestamp}"
-H "x-ncp-iam-access-key: {Sub Account Access Key}"
-H "x-ncp-apigw-signature-v2: {API Gateway Signature}"

レスポンス

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

レスポンス構文

レスポンス構文は次の通りです。

{
  "count": "number",
  "next": "number",
  "previous": "number",
  "results": [
      {
          "creator": "string",
          "digest": "string",
          "full_size": "number",
          "id": "number",
          "image_id": "number",
          "images": [
              {
                  "architecture": "string",
                  "created": "number",
                  "digest": "string",
                  "features": "string",
                  "latest_pulled": "number",
                  "mediaType": "string",
                  "os": "string",
                  "os_features": "string",
                  "os_version": "string",
                  "size": "number",
                  "updated": "number",
                  "variant": "string"
              }
          ],
          "last_updated": "number",
          "last_updater": "string",
          "name": "string",
          "repository": "number",
          "v2": "boolean"
      }
  ]
}

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
count Number - 登録されているレジストリの総数
next Number - 次のページの番号
  • 次のページがない場合、Nullを返す
previous Number - 以前のページの番号
  • 以前のページがない場合、Nullを返す
result[].creator String - イメージ登録者 ID
result[].digest String - イメージの固有 ID
result[].full_size Number - タグサイズ
result[].id Number - タグ ID
result[].image_id Number - イメージ ID
result[].images[].architecture String - amd64またはppc64leといった CPUアーキテクチャ
result[].image[].created String - イメージの作成日
  • 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で返す
result[].image[].digest String - イメージの固有 ID
result[].image[].features String - 使用しない
result[].images[].latest_pulled Number - イメージを Pullした直近の日時
result[].images[].mediaType String - イメージ形式関連の MIMEタイプ
  • <例> vnd.docker.container.image.v1+json: Dockerコンテナで定義したイメージで、イメージ形式バージョンは v1、データが JSON形式でエンコードされた MIMEタイプ
result[].image[].os String - linuxまたはwindowsといった OS
result[].image[].os_features String - 使用しない
result[].image[].os_version String - 使用しない
result[].images[].size Number - イメージのサイズ
result[].images[].updated Number - イメージの変更日時
result[].images[].variant String - 特定のアーキテクチャに使用可能な変数
result[].last_updated String - イメージの最終更新日
  • 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で返す
result[].last_updater String - イメージ登録者 ID
result[].name String - タグ名
result[].repository Number - レジストリ ID
result[].v2 Boolean - イメージに v2スペックを適用するかどうか

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

Container Registry APIで共通して使用されるレスポンスステータスコードの詳細は、Container Registryのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
      {
          "creator": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "digest": "sha256:a180 ~ b9dc",
          "full_size": 83518086,
          "id": 730606,
          "image_id": 322122,
          "images": [
              {
                  "architecture": "amd64",
                  "created": 1711928488000,
                  "digest": "sha256:sha256:a180 ~ b9dc",
                  "features": "",
                  "latest_pulled": 0,
                  "mediaType": "application/vnd.docker.container.image.v1+json",
                  "os": "linux",
                  "os_features": "",
                  "os_version": null,
                  "size": 83518086,
                  "updated": 1711928488000,
                  "variant": null
              }
          ],
          "last_updated": 1711928488000,
          "last_updater": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "name": "ncpdocker",
          "repository": 5976,
          "v2": true
      }
  ]
}