Method: enterprises.devices.delete
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elimina un dispositivo. Questa operazione tenta di cancellare i dati presenti sul dispositivo, ma non è garantito che vada a buon fine se il dispositivo è offline per un periodo prolungato. I dispositivi eliminati non vengono visualizzati nelle chiamate enterprises.devices.listenterprises.devices.get
Richiesta HTTP
DELETE https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
name |
string
Il nome del dispositivo nel formato enterprises/{enterpriseId}/devices/{deviceId}.
|
Parametri di query
| Parametri |
wipeDataFlags[] |
enum (WipeDataFlag)
Flag facoltativi che controllano il comportamento di cancellazione dei dati del dispositivo.
|
wipeReasonMessage |
string
(Facoltativo) Un breve messaggio visualizzato dall'utente prima della cancellazione del profilo di lavoro sui dispositivi personali. Ciò non influisce sui dispositivi di proprietà aziendale. La lunghezza massima del messaggio è di 200 caratteri.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta è un oggetto JSON vuoto.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidmanagement
Per ulteriori informazioni, consulta la OAuth 2.0 Overview.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
