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 个字符。

请求正文

请求正文必须为空。

响应正文

如果成功，响应正文将为空的 JSON 对象。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 Overview。

WipeDataFlag

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

枚举
WIPE_DATA_FLAG_UNSPECIFIED 系统会忽略此值。
PRESERVE_RESET_PROTECTION_DATA 保留设备上的恢复出厂设置保护机制数据。
WIPE_EXTERNAL_STORAGE 此外，请擦除设备的外部存储空间（例如 SD 卡）。