Method: enterprises.devices.delete
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Löscht ein Gerät. Bei diesem Vorgang wird versucht, die Daten auf dem Gerät zu löschen. Dies ist jedoch nicht garantiert, wenn das Gerät längere Zeit offline ist. Gelöschte Geräte werden nicht in enterprises.devices.listenterprises.devices.get
HTTP-Anfrage
DELETE https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Der Name des Geräts im Format enterprises/{enterpriseId}/devices/{deviceId}.
|
Abfrageparameter
| Parameter |
wipeDataFlags[] |
enum (WipeDataFlag)
Optionale Flags, mit denen das Verhalten beim Zurücksetzen des Geräts gesteuert wird.
|
wipeReasonMessage |
string
Optional. Eine kurze Nachricht, die dem Nutzer angezeigt wird, bevor das Arbeitsprofil auf privaten Geräten gelöscht wird. Das hat keine Auswirkungen auf unternehmenseigene Geräte. Die maximale Länge einer Nachricht beträgt 200 Zeichen.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext ein leeres JSON-Objekt.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidmanagement
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003ePermanently deletes a device, wiping its data and removing it from enterprise device lists.\u003c/p\u003e\n"],["\u003cp\u003eThe wipe behavior can be customized using optional flags like \u003ccode\u003ewipeDataFlags\u003c/code\u003e and \u003ccode\u003ewipeReasonMessage\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful deletion results in an empty response body.\u003c/p\u003e\n"],["\u003cp\u003eDevice deletion uses the \u003ccode\u003eDELETE\u003c/code\u003e method with the device name as a path parameter.\u003c/p\u003e\n"]]],["This document outlines the process for deleting a device via a `DELETE` HTTP request to the specified URL, requiring an empty request body. The device name is provided as a path parameter. Optional query parameters include `wipeDataFlags`, for managing data wiping behavior, and `wipeReasonMessage`, a user-facing message for personal devices. Successful deletion returns an empty JSON object. Deletion also involves wiping the device and removing it from device lists. Authentication requires the `androidmanagement` OAuth scope.\n"],null,["# Method: enterprises.devices.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes a device. This operation attempts to wipe the device but this is not guaranteed to succeed if the device is offline for an extended period. Deleted devices do not show up in [`enterprises.devices.list`](/android/management/reference/rest/v1/enterprises.devices/list#google.android.devicemanagement.v1.DeviceManagementService.ListDevices) calls and a 404 is returned from [`enterprises.devices.get`](/android/management/reference/rest/v1/enterprises.devices/get#google.android.devicemanagement.v1.DeviceManagementService.GetDevice).\n\n### HTTP request\n\n`DELETE https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the device in the form `enterprises/{enterpriseId}/devices/{deviceId}`. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `wipeDataFlags[]` | `enum (`[WipeDataFlag](/android/management/reference/rest/v1/WipeDataFlag)`)` Optional flags that control the device wiping behavior. |\n| `wipeReasonMessage` | `string` Optional. A short message displayed to the user before wiping the work profile on personal devices. This has no effect on company owned devices. The maximum message length is 200 characters. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
