- What's New
- Function Overview
- Service Overview
- Getting Started
-
User Guide
- 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
- Image Center
- Organization Management
- User Permissions
- Auditing
- Best Practices
-
API Reference
- Before You Start
- API Overview
- Calling APIs
-
API
- Organization Management
- Image Repository Management
- Image Tag Management
- Shared Account Management
- API Versions
- Organization Permission Management
- Image Permission Management
- Automatic Image Synchronization Task Management
- Trigger Management
- Image Retention Policy Management
- Temporary Login Command
- Quota Management
- Example Applications
- Appendixes
- Change History
- FAQs
- Videos
- SDK Reference
Creating an Image Repository
Function
Create an image repository in an organization.
URI
POST /v2/manage/namespaces/{namespace}/repos
For details about parameters, see Table 1.
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
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. |
Request
- Request parameters
Table 2 FormData parameter description Parameter
Mandatory
Type
Description
repository
Yes
String
Image repository name.
Enter 1 to 128 characters, starting and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), slashes (/), underscores (_), and hyphens (-) are allowed. Periods, slashes, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.
category
No
String
Repository type.
The value can be app_server, linux, framework_app, database, lang, other, windows or arm.
description
No
String
Brief description of the image repository.
is_public
Yes
Boolean
Whether the repository is a public repository. When the value is true, it indicates the repository is public. When the value is false, it indicates the repository is private.
- Example request
POST https://{Endpoint}/v2/manage/namespaces/group/repos
Body:
-F "repository=busybox" \ -F "category=linux" \ -F "description=this is a busybox repository" \ -F "is_public=true"
Or
{ "repository": "busybox", "category": "linux", "description": "this is a busybox repository", "is_public": true }
NOTE:
The form format will no longer be supported soon. You are advised to use the body in the JSON format to call the API.
Status Code
Status Code |
Description |
---|---|
201 |
Creation successful. |
400 |
Request error. Error information is returned. |
401 |
Authentication failed. |
409 |
The repository already exists. |
500 |
Internal error. Error information is returned. |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.