GET /openapi/memorylake/admin/v1/roles/{role_key}/access-scope
all 模式)还是仅可访问所列实例(instances 模式)。所有者角色没有范围(409)。ETag 头标识此状态,可用于条件式设置角色访问范围。
所需权限:
policy:manage路径参数
string
必填
角色键(
key)curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/roles/data_analyst/access-scope' \
-H 'Authorization: Bearer sk_xxxxxx'
响应
object
显示 Role Access Scope 对象
显示 Role Access Scope 对象
string
角色
array
每个可设范围的资源类型一项
显示 Access Scope Entry 对象
显示 Access Scope Entry 对象
string
all 表示所有实例;instances 表示仅列出的实例string
资源类型,例如
memorylake:project(参见 GET /permission-catalog)array
只读。成员角色对该类型授予的实例级操作——即范围条目最多可允许的操作。
array
mode 为 instances 时的实例列表{
"success": true,
"message": "Operation completed successfully",
"data": {
"role_key": "tenant_member",
"scopes": [
{
"mode": "all",
"resource_type": "example",
"available_actions": [
"example"
],
"instances": [
{
"id": "bc572b050c9920425b5fd75681eccbb2",
"actions": [],
"effective_actions": [],
"permission_level": "read",
"shadowed_actions": [],
"via_permission_level": false,
"workspace_id": "0fa2d21dc175adc7a003e0b37f156cb1"
}
]
}
]
}
}
错误
出错时返回success: false、message 和 error_code。全部错误码见错误码。
| 状态码 | 含义 |
|---|---|
401 | API Key 缺失、无效、已停用或已过期 |
403 | 该 Key 无权执行此操作 |
404 | 资源不存在 |
409 | 请求与当前状态冲突,例如重复或已达上限 |
422 | 请求体或参数未通过校验 |
429 | 请求过多,请按 Retry-After 等待后重试 |
500 | 服务端错误 |
503 | 暂时不可用,请稍后重试 |