跳到主要内容

列出成员角色 (V2)

Lists roles directly assigned to a member. Group-inherited roles are not included.

GET/v2/members/{userId}/roles
连接端点

该 API 的 Base URL 格式如下：

https://api.cloud.zilliz.com

📘说明

控制面接口速率限制为单用户单接口每秒最多 20 个请求。

shell
export BASE_URL="https://api.cloud.zilliz.com"
参数
Authorizationstringheader必填项

认证令牌，应为具备适当权限的 API Key。

示例值：Bearer {{TOKEN}}
userIdstringpath必填项

成员用户 ID。

示例值：usr-xxxxxxxxxxxxxx
bash
export TOKEN="YOUR_API_KEY"
export userId="usr-xxxxxxxxxxxxxx"

curl --request GET \
--url "${BASE_URL}/v2/members/${userId}/roles" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
响应200 OK - application/json

Returns a successful result or an error message.

成功响应。

codeinteger必填项

响应码。

示例值：0
dataobject必填项
orgRolesarray必填项

直接授予该主体的组织级角色。

[]orgRolesobject必填项

直接授予成员或群组的角色。

roleIdstring必填项

角色 ID。

roleNamestring必填项

角色显示名称。

roleKindstring必填项

角色是预定义角色还是自定义角色。

assignedBystring必填项

授予角色的用户显示名称；非用户授予者则返回原始值。

projectRolesarray必填项

直接授予该主体的项目级角色，按项目分组。

[]projectRolesobject必填项
projectIdstring必填项

项目 ID。

rolesarray必填项

在该项目中授予的角色。

[]rolesobject必填项

直接授予成员或群组的角色。

roleIdstring必填项

角色 ID。

roleNamestring必填项

角色显示名称。

roleKindstring必填项

角色是预定义角色还是自定义角色。

assignedBystring必填项

授予角色的用户显示名称；非用户授予者则返回原始值。

失败响应。

codeinteger必填项

响应码。

messagestring必填项

错误消息。

Successjson
{
    "code": 0,
    "data": {
        "orgRoles": [
            {
                "roleId": "r-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                "roleName": "Public",
                "roleKind": "pre-defined",
                "assignedBy": "Bob Li"
            }
        ],
        "projectRoles": [
            {
                "projectId": "proj-xxxxxxxx",
                "roles": [
                    {
                        "roleId": "r-yyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
                        "roleName": "Data Reader",
                        "roleKind": "custom",
                        "assignedBy": "Bob Li"
                    }
                ]
            }
        ]
    }
}
Ctrl I