Querying the List of Image Tags

namespace

Yes

String

Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.

repository

Yes

String

Image repository name. Replace a slash (/) with a dollar sign ($) before you send the request.

limit

No

String

Number of returned records. Parameters offset and limit should always be used together.

offset

No

String

Start index. The value can be 0 or a positive integer multiple of the limit value.

Parameters offset and limit should always be used together.

order_column

No

String

Sorting by column. You can set this parameter to updated_at (sorting by update time) or tag (sorting by tag). Parameters order_column and order_type should always be used together.

order_type

No

String

Sorting order. You can set this parameter to desc (descending order) and asc (ascending order). Parameters order_column and order_type should always be used together.

tag

No

String

Image tag name.

filter

No

String

Set this parameter to offset::{offset}|limit::{limit}|order_column::{order_column}|order_type::{order_type}|tag::{tag}. limit indicates the number of returned records. offset indicates the start index. Parameters offset and limit should always be used together. order_column indicates sorting by column. The value can be updated_at (sorting by update time) or tag (sorting by tag). order_type indicates the sorting order. The value can be desc (descending order) or asc (ascending order). tag indicates the image tag name.

Content-Type

Yes

String

Message body type (format). The value can be application/json;charset=utf-8 application/json

The default value is application/json.

X-Auth-Token

Yes

String

User token.

The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Content-Range

String

Offset (Start index) – Count (Number of records on the current page)/Total (Total number of records)

[Array]

Array of ShowReposTagResp objects

Image tag list.

id

Long

Tag ID.

repo_id

Long

Repository ID.

Tag

String

Image tag name.

image_id

String

Image ID.

manifest

String

Image manifest.

digest

String

Hash value of an image.

schema

Long

Docker protocol version. The version can be 1 or 2.

path

String

External image pull address, for example, swr.cn-north-1.myhuaweicloud.com/namespace/repository:tag.

internal_path

String

Internal image pull path. For example, 10.125.0.198:20202/namespace/repository:tag.

size

Long

Image size, ranging from 0 to 9,223,372,036,854,775,807.

is_trusted

Boolean

By default, the value is false.

Default value: false

created

String

Time when the image is created. It is the UTC standard time. Users need to calculate the offset based on the local time. For example, GMT+8 is 8 hours ahead the GMT time.

updated

String

Time when an image is updated. It is the UTC standard time. Users need to calculate the offset based on the local time. For example, GMT+8 is 8 hours ahead the GMT time.

deleted

String

Time when an image is deleted. It is the UTC standard time. Users need to calculate the offset based on the local time. For example, GMT+8 is 8 hours ahead the GMT time.

domain_id

String

Account ID.

scanned

Boolean

Whether the image has been scanned.

tag_type

Long

0: manifest; 1: manifest list.

200

The list of image tags is queried successfully.

400

Request error.

401

Authentication failed.

404

The image repository does not exist.

500

Internal error.