Skip to content

Remove users from a user Group

1. API Description

Use this API to remove users from a user group.

2. API URL

POST http://{anymetrics_host:anymetrics_port}/anymetrics/api/v1/userGroup/removeuser

To obtain anymetrics_host:anymetrics_port, see Calling APIs.

3. Common Request Headers

parameter Type required Description
tenant-id String Yes Tenant ID that identifies the tenant to which the resource belongs.
auth-type String Yes Authentication method. Supports UID, TOKEN, ACCOUNT, and APIKEY.
auth-value String Yes Authentication value corresponding to auth-type.

3.1 How to Obtain Common parameters

In Aloudata CAN, select Metric Applications in the top navigation bar, then select API Integration in the left navigation menu. You can obtain tenant-id on the API Integration page. Set auth-value according to auth-type.

image.png

3.2.  Request Body parameters:

parameter Type required Description
identityType String Yes user identifier type
identityIds Array Yes List of user IDs or accounts
value String Yes user group ID or code
groupIdentityType String Yes user group identifier type

4. Request Example:

curl --location 'http://localhost:8083/anymetrics/api/v1/userGroup/removeuser' \
--header 'tenant-id: tn_21571046' \
--header 'auth-value: authority_test' \
--header 'auth-type: ACCOUNT' \
--header 'Content-Type: application/json' \
--data '{
  "identityType": "USER_ACCOUNT",
  "identityIds": ["zhangsan"],
  "value": "g_1001",
  "groupIdentityType": "USER_GROUP_ID"
}'

5. Response Example:

{
    "data": true,
    "success": true,
    "code": "200",
    "errorMsg": null,
    "detailErrorMsg": null,
    "traceId": "27cb89dae3b64e238acc50d5458e93e5.187.17761399445512211"
}