Help Center> SoftWare Repository for Container> API Reference> API> Querying the Brief Information on an Image Repository

Querying the Brief Information on an Image Repository

Function

Query the brief information on an image repository in an organization.

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}

For details about parameters, see Table 1.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name

repository

Yes

String

Name of the image repository

Request

N/A

Response

Response parameters

Table 2 Response body parameter description

Parameter

Type

Description

id

Integer

Repository ID.

ns_id

Integer

Organization ID.

name

String

Repository name.

category

String

Repository type. The value can be app_server, linux, framework_app, database, lang, other, windows, or arm.

description

String

Repository description.

creator_id

String

Repository creator ID.

creator_name

String

Repository creator.

size

Integer

Repository size.

is_public

Boolean

Whether the repository is a public repository. The value can be true or false.

num_images

Integer

Number of images in a repository.

num_download

Integer

Download times.

url

String

URL of the repository logo image. This field has been discarded and is left empty by default.

path

String

External image download address. For example, swr.cn-north-1.myhuaweicloud.com/namespace/repository.

internal_path

String

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

created

String

Time when a repository 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 a repository 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.

domain_id

String

Account ID.

priority

Integer

Image sorting priority.

Response example

{
    "id": 0,
    "ns_id": 0,
    "name": "busybox",
    "category": "other",
    "description": "containerops",
    "creator_id": "1",
    "creator_name": "admin",
    "size": 2099575,
    "is_public": false,
    "num_images": 0,
    "num_download": 0,
    "url": "",
    "path": "swr.cn-north-1.myhuaweicloud.com/namespace/repository",
    "internal_path": "10.125.0.198:20202/namespace/repository",
    "created": "2017-08-17T12:00:03.915153267Z",
    "updated": "2017-08-17T12:00:03.915153267Z",
    "domain_id": "da44776c316c4a99b3683bb174f8821b", 
    "priority": 0
}

Status Code

For details about status code, see Table 3.

Table 3 Status code

Status Code

Description

200

The request is successfully sent.

400

Request error. Error information is returned.

401

Authentication failed.

404

The repository does not exist.

500

Internal error. Error information is returned.