Creating an Image Repository

Updated on 2023-04-04 GMT+08:00

Function

Create an image repository in an organization.

URI

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

  • 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.

Response

  • Response parameters

    N/A

  • Example response
    {}

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

Feedback

Feedback

0/500

Selected Content

Submit selected content with the feedback