Creating an Image Repository¶

Function¶

Create an image repository in an organization.

POST /v2/manage/namespaces/{namespace}/repos

For details about parameters, see Table 1.

**Table 1** Parameter description¶
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 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"

{
    "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	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.

last updated: 2024-11-08 14:06 UTC - commit: bafe836d5897267937ca97507796e7b30d23c387