Querying the List of Shared Images
Description
Query the list of shared images.
Constraints
None
API Calling
For details, see Calling APIs.
URI
GET /v2/manage/shared-repositories
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
namespace |
No |
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. |
name |
No |
String |
Image repository name. |
center |
Yes |
String |
The value can only be self or thirdparty. self: images shared by you. thirdparty: images shared with you by others |
domain_name |
No |
String |
Owner name. |
status |
No |
String |
false: The sharing has expired. true: The sharing is valid. |
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 (update time), name, tag_count (number of tags), namespace (organization), or domain_name (owner). 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. |
filter |
No |
String |
Set this parameter to center::{center}|name::{name}|limit::{limit}|offset::{offset}|namespace::{namespace}|order_column::{order_column}|order_type::{order_type}. Where, center can be set to self (images shared by you) or thirdparty (images shared with you by others). namespace indicates the organization name. name indicates the image repository name. limit indicates the number of returned records. offset indicates the start index. order_column indicates sorting by column. The value can be updated_at (update time), name (image repository name), tag_count (number of tags), namespace (organization), and domain_name (owner). order_type indicates the sorting order. The value can be desc (descending order) or asc (ascending order). |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
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. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
Content-Range |
String |
Offset (Start index) – Count (Number of records on the current page)/Total (Total number of records) |
Parameter |
Type |
Description |
---|---|---|
[Array] |
Array of ShowReposResp objects |
Request succeeded. |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Repository name. |
category |
String |
Repository category (to be changed; one image will have multiple labels). |
description |
String |
Repository description. |
size |
Long |
Repository size. |
is_public |
Boolean |
Whether the repository is public. When the value is true, it indicates the repository is public. When the value is false, it indicates the repository is private. |
num_images |
Long |
Number of images in the repository, ranging from 0 to 9,223,372,036,854,775,807. |
num_download |
Long |
Download times. |
created_at |
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_at |
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. |
logo |
String |
Repository logo address (not in use). |
url |
String |
URL of the repository logo (not in use). |
path |
String |
External image pull 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. |
domain_name |
String |
Tenant name. |
namespace |
String |
Tenant organization. |
tags |
Array of strings |
Image tag list. |
status |
Boolean |
Query images shared by others: specifies whether the shared images have expired. Query images shared by yourself: The default value is false, which is meaningless. |
total_range |
Long |
Total number of records. |
Example Request
GET https://{endpoint}/v2/manage/shared-repositories
Example Response
Status code: 200
Request succeeded.
[ { "name" : "huawei", "category" : "other", "description" : "", "size" : 115645792, "is_public" : false, "num_images" : 1, "num_download" : 0, "created_at" : "2018-03-21T12:22:37Z", "updated_at" : "2018-03-21T12:22:37Z", "logo" : "", "url" : "", "path" : "swr.cn-north-1.myhuaweicloud.com/namespace/huawei", "internal_path" : "100.125.0.198:20202/namespace/huawei", "domain_name" : "domian", "namespace" : "namespace", "tags" : [ "latest" ], "status" : true } ]
Status Codes
Status Code |
Description |
---|---|
200 |
Request succeeded. |
400 |
Request error. |
401 |
Authentication failed. |
500 |
Internal error. |
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot