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