Adding a Member to a Privilege Set

Function

Add members to the privilege set.

Calling Method

For details, see Calling APIs.

URI

POST /v1/{project_id}/security/permission-sets/{permission_set_id}/members

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Project ID and Account ID.
permission_set_id	Yes	String	Permission set ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
workspace	Yes	String	Workspace ID. For details about how to obtain the workspace ID, see Instance ID and Workspace ID.
X-Auth-Token	Yes	String	IAM token, which is obtained by calling the IAM API for obtaining a user token (value of X-Subject-Token in the response header). This parameter is mandatory for token authentication.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
member_type	No	String	Member type, user/user group/workspace role, USER, USER_GROUP, WORKSPACE_ROLE
member_id	No	String	Member ID.
member_name	No	String	Member name.
workspace	No	String	Work space.
auto_sync	No	Boolean	Whether to enable automatic synchronization. The default value is false.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
id	String	id.
permission_set_id	String	Permission set ID.
project_id	String	Project ID.
instance_id	String	Instance ID.
member_type	String	Member type, which can be user, user group, workspace role (discarded), or cluster role. The value is USER, USER_GROUP, WORKSPACE_ROLE, CLUSTER_ROLE.
member_id	String	Member ID.
member_name	String	Member name.
member_status	String	Member status. The value can be NORMAL or UNFINISHED.
workspace	String	Workspace (required only for workspace roles).
cluster_type	String	Cluster type (required only for cluster roles), which can be MRS, DLI, or GaussDB(DWS).
cluster_id	String	Cluster ID (required only for cluster roles).
cluster_name	String	Cluster name (required only for cluster roles).
create_time	Long	Time when the bandwidth was specified.
create_user	String	Creator.
deadline	Long	Expiration time.

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Requests

/v1/0833a5737480d53b2f25c010dc1a7b88/security/permission-sets/members

{
  "member_id" : "b43927a45a514e93ba70524b28923500",
  "member_name" : "common_user",
  "member_type" : "USER",
  "workspace" : null
}

Example Responses

Status code: 200

{
  "cluster_id" : null,
  "cluster_name" : null,
  "cluster_type" : null,
  "create_time" : 1698204793000,
  "create_user" : "ei_dayu_test_01",
  "deadline" : null,
  "id" : "d9ff4b06db43e3d4f81de1e60077a480",
  "instance_id" : "dd97167b873d4a79b2aad54d4370a3bc",
  "member_id" : "b43927a45a514e93ba70524b28923500",
  "member_name" : "common_user",
  "member_status" : "NORMAL",
  "member_type" : "USER",
  "permission_set_id" : "fea96c90024711b8bf8d6886407b814b",
  "project_id" : "0833a5737480d53b2f25c010dc1a7b88",
  "workspace" : null
}