イメージタグの詳細情報の照会

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

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

リクエスト

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

メソッド	URI
GET	/ncr/api/v2/repositories/{registry}/{imageName}/tags/{reference} (韓国リージョン)
GET	/ncr/sgn-api/v2/repositories/{registry}/{imageName}/tags/{reference} (シンガポールリージョン)
GET	/ncr/jpn-api/v2/repositories/{registry}/{imageName}/tags/{reference} (日本リージョン)

リクエストヘッダ

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

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

リクエストパスパラメータの説明は次の通りです。

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

リクエスト例

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

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

レスポンス

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

レスポンス構文

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

{
  "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"
}

レスポンスボディ

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

フィールド	タイプ	必須の有無	説明
`results`	Array	-	レスポンス結果: results

`results`

resultsの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`creator`	String	-	イメージ登録者 ID
`digest`	String	-	イメージの固有 ID
`full_size`	Number	-	タグサイズ
`id`	Number	-	タグ ID
`image_id`	Number	-	イメージ ID
`images`	Array	-	イメージ情報: images
`last_updated`	String	-	イメージの最終更新日 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で返す
`last_updater`	String	-	イメージ登録者 ID
`name`	String	-	タグ名
`repository`	Number	-	レジストリ ID
`v2`	Boolean	-	イメージに v2スペックを適用するかどうか

`images`

imagesの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`architecture`	String	-	`amd64`または`ppc64le`といった CPUアーキテクチャ
`created`	String	-	イメージの作成日 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で返す
`digest`	String	-	イメージの固有 ID
`features`	String	-	使用しない
`latest_pulled`	Number	-	イメージを Pullした直近の日時
`mediaType`	String	-	イメージ形式関連の MIMEタイプ <例> vnd.docker.container.image.v1+json: Dockerコンテナで定義したイメージで、イメージ形式バージョンは v1、データが JSON形式でエンコードされた MIMEタイプ
`os`	String	-	`linux`または`windows`といった OS
`os_features`	String	-	使用しない
`os_version`	String	-	使用しない
`size`	Number	-	イメージのサイズ
`updated`	Number	-	イメージの変更日時
`variant`	String	-	アーキテクチャ内の変数

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

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

レスポンス例

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

{
  "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
}