Skip to main content

设置设备可信状态接口

将指定设备标记为可信或取消可信，trusted 指定目标状态，version 用于并发控制，需与当前记录版本一致。

  • Scope: admin.v1.trusted-devices.manage
  • 权限项: 可信设备管理
  • 权限类型: manage
  • 接口: PATCH/api/openapi/v1/trusted-devices/{id}/trusted-state
使用 Authorization: Bearer <API_KEY>。应用必须配置“全部用户”范围（subject_scope={"mode":"all"}）；受限或无效范围在业务执行前返回 403 openapi_subject_scope_denied。各 Scope 独立授权，互不隐含。组织及应用操作主体取自可信鉴权，不接受请求参数指定。

请求参数

名称位置类型必填说明
idpathstringTrue记录标识
trustedbodybooleanTrue是否可信
versionbodyintegerTrue并发控制版本；minimum=1

请求示例

curl --request PATCH 'https://example.invalid/api/openapi/v1/trusted-devices/11111111-1111-4111-8111-111111111111/trusted-state' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"trusted": true, "version": 1}'

响应字段

名称类型说明
created_atstring创建时间
created_bystring创建主体标识
created_by_emailstring创建主体邮箱
created_by_namestring创建主体名称
device_namestring设备名称
idstring记录标识
login_usernamestring设备登录用户名
mac_addressstring设备 MAC 标识
modelstring设备型号
operating_systemstring操作系统
serial_numberstring设备序列号 SN
sourcestring设备登记来源；enum=['single', 'import', 'first_device_auto_trust', 'approval']
trustedboolean是否可信
updated_atstring更新时间
updated_bystring更新主体标识
updated_by_emailstring更新主体邮箱
updated_by_namestring更新主体名称
userobject设备所属用户快照
user.department_idstring部门标识
user.department_namestring部门名称
user.department_pathstring部门路径
user.departmentsarray用户部门快照
user.departments[].idstring记录标识
user.departments[].namestring名称
user.departments[].pathstringpath
user.emailstring用户邮箱
user.employee_nostring员工编号
user.org_idstring所属组织标识
user.user_idstring设备所属用户标识
user.user_namestring用户姓名
versioninteger并发控制版本

错误处理

沿用 {error, detail, code} 错误结构。身份校验失败为 401/403；缺少 Scope 或非全部用户范围为 403；资源不存在为 404；冲突或旧版本为 409；参数不合法为 400/422；依赖不可用为 503。业务错误沿用控制台语义。

接口语义与安全边界

设为不可信会沿用现有访问变更通知；这不是用户级强制下线任务。version 用于并发检查，版本冲突时应重新读取后决定是否更新。