Updated on 2024-12-02 GMT+08:00

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.