PATCH /openapi/memorylake/admin/v1/roles/{role_key}
所需权限:
policy:custom_role_manage路径参数
string
required
自定义角色的角色键
请求头
string
可选。使用相同值重试会重放首次结果。
请求体
string
新描述;传
"" 可清除string
新显示名称
curl -X PATCH 'https://app.memorylake.cn/openapi/memorylake/admin/v1/roles/data_analyst' \
-H 'Authorization: Bearer sk_xxxxxx' \
-H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
-H 'Content-Type: application/json' \
-d '{
"description": "Example description",
"label": "example"
}'
响应
object
Show Role Detail 对象
Show Role Detail 对象
boolean
为 true 时,仅团队所有者或持有管理员基线的成员(通过其角色或用户组)可授予此角色。这是角色本身的属性,对所有调用方相同;不同于控制台角色列表中按调用方计算的可分配标记。
boolean
成员与邀请的写操作是否接受此角色——对所有调用方相同。所有者角色始终不接受。与控制台的角色列表不同,此字段不表示您本人能否授予该角色:如需判断,请结合
admin_grant_only 与您自己的角色。boolean
每个团队都有的三个角色为 true;在本团队中创建的角色为 false
string
成员与邀请写操作的角色字段所接受的值
string
显示名称。内置角色带有固定的英文标签;自定义角色使用操作者设置的名称。
string
对于自定义角色:创建时被复制权限规则的来源角色。内置角色以及未指定基础角色创建的自定义角色不包含此字段。
string
由运营方撰写的描述。仅自定义角色带有描述。
string
与
base_role_key 的值相同;为兼容现有客户端而保留。array
{
"success": true,
"message": "Operation completed successfully",
"data": {
"admin_grant_only": false,
"assignable": false,
"built_in": false,
"key": "sk-f6e5d4c3...redacted...b2a1",
"label": "example",
"base_role_key": "tenant_member",
"description": "Example description",
"parent_role_key": "example",
"permissions": [
{
"permission": "example",
"source": "built_in"
}
]
}
}