Method: enterprises.devices.delete

删除设备。此操作会擦除设备。已删除的设备不会显示在 enterprises.devices.list 调用中,并且 enterprises.devices.get 会返回 404。

HTTP 请求

DELETE https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}

网址采用 gRPC 转码语法。

路径参数

参数
name

string

设备的名称,格式为 enterprises/{enterpriseId}/devices/{deviceId}

查询参数

参数
wipeDataFlags[]

enum (WipeDataFlag)

用于控制设备擦除行为的可选标志。

wipeReasonMessage

string

可选。擦除个人设备上的工作资料前向用户显示的简短消息。此操作对公司拥有的设备没有任何影响。消息长度上限为 200 个字符。

请求正文

请求正文必须为空。

响应正文

如果成功,则响应正文为空。

授权范围

需要以下 OAuth 作用域:

  • https://www.googleapis.com/auth/androidmanagement

有关详情,请参阅 OAuth 2.0 概览

WipeDataFlag

用于在删除设备时控制数据擦除行为的标志。默认情况下,系统会擦除所有用户数据和恢复出厂设置保护数据。

枚举
WIPE_DATA_FLAG_UNSPECIFIED 系统会忽略此值。
PRESERVE_RESET_PROTECTION_DATA 保留设备上的恢复出厂设置保护数据。
WIPE_EXTERNAL_STORAGE 此外,还要擦除设备的外部存储空间(例如 SD 卡)。