イメージタグリストの照会
- 印刷する
- PDF
イメージタグリストの照会
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Classic/VPC環境で利用できます。
Container Registryのレジストリに登録されているイメージのタグ(Tag)リストを照会します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| GET | /repositories/{registry}/{imageName}/tags |
リクエストヘッダ
Container Registry APIで共通して使用されるヘッダの詳細は、Container Registryの共通ヘッダをご参照ください。
リクエストパスパラメータ
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
registry | String | Required | タグリスト照会対象のイメージが登録されているレジストリの名前 |
imageName | String | Required | タグリスト照会対象イメージの名前
|
リクエストクエリパラメータ
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
page | Number | Optional | 照会するページ番号
|
pagesize | Number | Optional | 照会するページサイズ
|
リクエスト例
リクエストのサンプルコードは次の通りです。
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 | - | 次のページの番号
|
previous | Number | - | 以前のページの番号
|
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 | - | イメージの作成日
|
result[].image[].digest | String | - | イメージの固有 ID |
result[].image[].features | String | - | 使用しない |
result[].images[].latest_pulled | Number | - | イメージを Pullした直近の日時 |
result[].images[].mediaType | String | - | イメージ形式関連の 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 | - | イメージの最終更新日
|
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 | リクエストされたリソースが見つからない |
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"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
}
]
}
この記事は役に立ちましたか?