Skip to main content

批量删除可信设备接口

按标识列表批量删除可信设备，ids 单次最多 1000 条。

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

请求参数

名称位置类型必填说明
idsbodyarrayTrue目标记录标识列表；maxItems=1000

请求示例

curl --request POST 'https://example.invalid/api/openapi/v1/trusted-devices/batch-deletions' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"ids": ["example"]}'

响应字段

名称类型说明
deletedinteger实际删除数
requestedinteger请求删除数

错误处理

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

接口语义与安全边界

最多 1,000 个 ID。该批量接口沿用按 ID 删除，不提供逐项 version 条件或逐项失败原因；须核对 requested/deleted，成功响应不保证所有请求 ID 都被删除。