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

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

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

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

リクエスト

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

メソッド	URI
GET	/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}/tags/{reference}" 
-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}"

レスポンス

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

レスポンス構文

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

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

レスポンスボディ

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

フィールド	タイプ	必須の有無	説明
`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_update`	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のレスポンスステータスコードをご参照ください。

HTTPステータスコード	コード	メッセージ	説明
200	-	OK	リクエスト成功
404	-	Not Found	リクエストされたリソースが見つからない

レスポンス例

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

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

この記事は役に立ちましたか?

What's Next

イメージタグの削除

リクエスト
レスポンス