设置当前用户默认角色

PUT https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/iam/me/default-role

调用前准备

从当前调用身份角色列表取得可选择的已直接绑定角色及 default_role_version,分别保存为 TARGET_ROLE_ID 和 DEFAULT_ROLE_VERSION;准备工作区凭据、jq 和本次 REQUEST_ID。目标不能仅是从继承关系中可达的角色。

请求

curl -X PUT "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/me/default-role" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  --data-binary "$(jq -n --arg role "$TARGET_ROLE_ID" --arg request "$REQUEST_ID" --argjson version "$DEFAULT_ROLE_VERSION" '{target_role_id:$role,expected_default_role_version:$version,request_id:$request}')"

字段

类型

说明

target_role_id

string,必填

规范正整数角色 ID,须是当前用户可选的 active/ready 直接绑定。

expected_default_role_version

integer

当前默认角色版本,不小于 0;省略为 0,不表示跳过并发检查。

request_id

string,必填

本次操作标识,相同内容确认使用原 ID。

返回结果

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "default_role_id": "7",
    "default_role_version": 3,
    "schema_version": "definition-example",
    "capability_version": "definition-example",
    "audit_event_id": "audit-example",
    "request_id": "default-example",
    "trace_id": "trace-example",
    "idempotent_replay": false
  }
}

默认角色、回执和审计在同一事务保存。相同用户/工作区/request_id 与相同内容可重放,改变目标或输入版本复用编号冲突。重新读取当前角色上下文确认新默认值。它不为用户增加绑定,也不修改其他用户。

当前显式候选仍优先于默认值;更改默认角色不自动覆盖 SDK/CLI 已配置的工作区角色映射。

当前 Go/Python/CLI 未找到专用设置默认角色方法/命令;使用本页 HTTP,不虚构客户端方法。

最后更新于