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

Creating Organization Permissions

Function

Grant permissions of an organization to certain users so that they can manage, edit, and read images from the organization.

Constraints

None

URI

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

Table 1 describes the parameters.

Table 1 Parameter description

Parameter	Mandatory	Type	Description
namespace	Yes	String	Organization name.

Request

• Request 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 Request body parameters

  Parameter	Mandatory	Type	Description
  [Array element]	Yes	Array of objects	Information required for creating organization permissions.

  Table 4 [Array element]

  Parameter	Mandatory	Type	Description
  user_id	Yes	String	User ID. Obtain it from IAM.
  user_name	Yes	String	Username. Obtain it from IAM.
  auth	Yes	Integer	User permission 7: Manage 3: Write 1: Read

• Example request

  POST https://{endpoint}/v2/manage/namespaces/{namespace}/access
  
  [ {
    "user_id" : "fb3f175c1fd146ab8cdae3272be6107b",
    "user_name" : "user01",
    "auth" : 1
  } ]

Response

• Response parameters

  N/A

• Example response

  None

Status Code

Status Code	Description
201	Creation successful.
400	Request error.
401	Authentication failed.
404	The organization does not exist.
409	The organization permission already exists.
500	Internal error.

Error Codes

For details, see Error Codes.

Parent topic: Organization Permission Management