删除 Cloud 角色 (V2)

软删除自定义角色。删除操作不会级联：如果该角色仍有活动绑定（用户、群组或 API Key），请求会被拒绝并返回 21141 this role is in use。请先撤销其所有绑定，再删除该角色。如果删除会导致某作用域内无法再管理角色，或该角色为预定义角色，请求也会被拒绝。

DELETE/v2/roles/{roleId}

连接端点

该 API 的 Base URL 格式如下：

https://api.cloud.zilliz.com

📘说明

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

shell

export BASE_URL="https://api.cloud.zilliz.com"

参数

Authorizationstringheader必填项

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

示例值：Bearer {{TOKEN}}

roleIdstringpath必填项

角色 ID。

示例值：r-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

bash

export TOKEN="YOUR_API_KEY"
export roleId="r-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl --request DELETE \
--url "${BASE_URL}/v2/roles/${roleId}" \
--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.

Success

成功响应。

codeinteger必填项

响应码。

示例值：0

databoolean必填项

操作是否成功。

Failure

失败响应。

codeinteger必填项

响应码。

messagestring必填项

错误消息。

Successjson

{
    "code": 0,
    "data": true
}