doc-exports/docs/swr/api-ref/swr_02_0030.html

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.

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
  }

  

  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.

Parent topic: API