- What's new
- Function Overview
- Service Overview
- Getting Started
-
User Guide
- Introduction
- Permissions Management
- Basics of the Container Engine
-
Image Management
- Uploading an Image Through a Container Engine Client (Recommended)
- Obtaining a Long-Term Valid Login Command
- Uploading an Image Through SWR Console
- Pulling an Image
- Setting Image Attributes
- Sharing a Private Image
- Adding a Trigger
- Adding an Image Retention Policy
- Configuring Automatic Image Synchronization Between Regions
- Image Center
- Organization Management
- User Permissions
- Auditing
- Change History
- Best Practices
-
API Reference
- Before You Start
- Calling APIs
- API Overview
-
API
- Organization Management
- Managing Image Repositories
- Image Tag Management
- Shared Account Management
- API Version
- Organization Permission Management
- Image Permission Management
- Image Synchronization Management
- Trigger Management
- Image Retention Policy Management
- Temporary Login Command
- Quota Management
- Other
- Example Applications
- Appendixes
- SDK Reference
-
FAQs
- General FAQs
- Login Issues
- Synchronizing Images
- Pushing an Image
- Pulling an Image
-
Troubleshooting
- Why Does the Login Command Fail to Be Executed?
- Why Does an Image Fail to Be Pushed Through a Container Engine Client?
- Why Does an Image Fail to Be Uploaded Through SWR Console?
- Why Does the docker pull Command Fail to Be Executed?
- What Should I Do If Images Cannot Be Downloaded from Private Networks?
- What Do I Do If an Error Occurs When I Call an API?
-
Other FAQs
- Why Does a CCE Workload Cannot Pull an Image from SWR and a Message "Not Logged In" Is Displayed?
- How Many Tenants Can I Share an SWR Private Image With?
- Why Is an Image Pushed Using a Container Engine Client to SWR Different in Size From One Uploaded Through the SWR Console?
- Can I Pull Images on the SWR Console to a Local PC?
- Videos
- Glossary
-
More Documents
- User Guide
- API Reference
- User Guide (Paris Regions)
- API Reference (Paris Regions)
- User Guide (Kuala Lumpur Region)
- API Reference (Kuala Lumpur Region)
-
User Guide (Ankara Region)
- Service Overview
- Overview
- Permissions Management
- Basics of Docker
-
Image Management
- Pushing an Image Through a Container Engine Client
- Obtaining a Long-Term Valid Docker Login Command
- Obtaining a Long-Term Valid containerd Pull/Push Command
- Uploading an Image Through the SWR Console
- Pulling an Image
- Setting Image Attributes
- Sharing Private Images
- Adding a Trigger
- Adding an Image Retention Policy
- Organization Management
- User Permissions
- FAQs
-
API Reference (Ankara Region)
- Before You Start
- API Overview
- Calling APIs
- API
- Appendixes
- Permissions and Supported Actions
- General Reference
Copied.
Viewing the List of Shared Images
Function
View the list of shared images.
URI
GET /v2/manage/shared-repositories
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
namespace |
No |
String |
Organization name. An organization name contains 1 to 64 characters. It must start with a lowercase letter and end 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 |
No |
String |
self: images shared by you thirdparty: images shared with you by others. |
limit |
No |
String |
Number of returned records. Ensure that the offset and limit parameters are used together. If this parameter is not specified, all records will be returned by default. |
offset |
No |
String |
Start index. The value can be 0 or a positive integer multiple of the limit value. If this parameter is not specified, all records will be returned by default. 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). Parameters order_column and order_type should always be used together. |
order_type |
No |
String |
Sorting type. You can set this parameter to desc (descending sort) or asc (ascending sort). 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}. center can be set to self (images shared by you). thirdparty indicates images shared 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, which can be name, updated_time, or tag_count. order_type indicates the sorting type, which can be desc (descending order) or asc (ascending order). |
Request
Response
- Response parameters
Table 2 Request header parameters Parameter
Mandatory
Type
Description
Content-Type
Yes
String
Message body type (format). The value can be application/json or 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 an IAM API. The value of X-Subject-Token in the response header is the user token.
Table 3 Response body parameter description Parameter
Type
Description
[Array element]
Array of objects
Viewing the list of shared images.
Table 4 [Array element] parameters description Parameter
Type
Description
name
String
Image repository name.
category
String
Image repository type. The value can be app_server, linux, framework_app, database, lang, arm, or other.
description
String
Image repository description.
size
Integer
Total size of the images in an image repository.
is_public
Boolean
Whether the image is a public image. The value can be true or false.
num_images
Integer
Number of image tags in an image repository.
num_download
Integer
Download times.
created_at
String
Time when an image repository is created. It is the UTC standard time.
updated_at
String
Time when an image repository is updated. It is the UTC standard time.
logo
String
(Reserved field) Image repository logo address.
url
String
(Reserved field) URL of the image repository logo.
path
String
External Docker pull address. The format is {Repository address}/{Namespace name}/{Repository name}.
internal_path
String
Internal Docker pull address. The format is {Repository address}/{Namespace name}/{Repository name}.
domain_name
String
Domain name.
namespace
String
Organization name.
tags
Array of strings
Image tag list.
status
Boolean
- Query the images shared by a third party: Check whether the sharing is expired.
- Query the images shared by me: The default value is false, indicating that no images are shared.
total_range
Integer
Total number of records.
- Example response
[ { "name": "busybox", "category": "other", "description": "", "size": 115645792, "is_public": false, "num_images": 1, "num_download": 0, "created_at": "2021-06-02T09:23:01.751202Z", "updated_at": "2021-06-10T07:24:35.204517Z", "logo": "", "url": "", "path": "{Repository address}/group/busybox", "internal_path": "{Repository address}/group/busybox", "domain_name": "domain", "namespace": "namespace", "tags": [ "v1", "v2" ], "status": true, "total_range": 1 } ]
Status Code
Status Code |
Description |
---|---|
200 |
Request successful. |
400 |
Request error. Error information is returned. |
401 |
Authentication failed. |
500 |
Internal error. Error information is returned. |
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