Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Utilizza BatchChangeChromeOsDeviceStatus. Esegue un'azione che interessa un dispositivo ChromeOS. Sono inclusi il deprovisioning, la disattivazione e la riattivazione dei dispositivi.
Richiesta HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
L'ID univoco dell'account Google Workspace del cliente. In qualità di amministratore dell'account, puoi anche utilizzare l'alias my_customer per rappresentare il customerId del tuo account. customerId viene restituito anche all'interno della risorsa Utenti.
resourceId
string
L'ID univoco del dispositivo. I resourceId vengono restituiti nella risposta del metodo chromeosdevices.list.
Dati su un aggiornamento dello stato di un dispositivo ChromeOS.
Rappresentazione JSON
{"action": string,"deprovisionReason": string}
Campi
action
string
chromeosdevices.action da eseguire sul dispositivo ChromeOS.
I valori accettabili sono:
deprovision: rimuovi dalla gestione un dispositivo che non è più attivo, che viene rivenduto o che viene inviato per la restituzione / la riparazione. Utilizza l'azione di deprovisioning per disaccoppiarlo dalla gestione.
disable: se ritieni che un dispositivo della tua organizzazione sia stato perso o rubato, puoi disattivarlo in modo che nessun altro possa utilizzarlo. Quando un dispositivo viene disattivato, l'utente può vedere solo una schermata che lo informa della disattivazione e i tuoi dati di contatto per la restituzione del dispositivo.
reenable: riattiva un dispositivo disattivato quando viene trovato un dispositivo smarrito o viene restituito un dispositivo smarrito. Puoi utilizzare questa funzionalità anche se contrassegni accidentalmente un dispositivo Chrome come disattivato.
pre_provisioned_disable: un dispositivo di cui è stato eseguito il pre-provisioning che non può essere registrato. Un amministratore può riattivare il dispositivo per consentire la registrazione zero-touch modificando lo stato in "pre_provisioned_reenable". Nota: da questo stato è possibile eseguire il deprovisioning del dispositivo.
pre_provisioned_reenable: il dispositivo è preconfigurato dagli OEM. I dispositivi in questo stato sono idonei per la registrazione zero-touch.
deprovisionReason
string
Viene utilizzato solo quando l'azione è di deprovisioning. Con l'azione di deprovisioning, questo campo è obbligatorio.
I valori accettabili sono:
different_model_replacement: da utilizzare se esegui l'upgrade o sostituisci il dispositivo con un modello più recente dello stesso tipo.
retiring_device: da utilizzare se vendi, doni o rimuovi definitivamente il dispositivo dall'uso.
same_model_replacement: da utilizzare se è stato riscontrato un problema hardware su un dispositivo e questo viene sostituito con lo stesso modello o con un modello simile da un fornitore / produttore di servizi di riparazione.
upgrade_transfer: da utilizzare se sostituisci i dispositivi Cloud Ready con Chromebook entro un anno.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# Method: chromeosdevices.action\n\n| This item is deprecated!\nUse [BatchChangeChromeOsDeviceStatus](https://developers.google.com/workspace/admin/directory/reference/rest/v1/customer.devices.chromeos/batchChangeStatus) instead. Takes an action that affects a Chrome OS Device. This includes deprovisioning, disabling, and re-enabling devices.\n| **Warning:**\n|\n| \u003cbr /\u003e\n|\n| - Deprovisioning a device will stop device policy syncing and remove device-level printers. After a device is deprovisioned, it must be wiped before it can be re-enrolled.\n| - Lost or stolen devices should use the disable action.\n| - Re-enabling a disabled device will consume a device license. If you do not have sufficient licenses available when completing the re-enable action, you will receive an error. \n| For more information about deprovisioning and disabling devices, visit the [help center](https://support.google.com/chrome/a/answer/3523633).\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). |\n| `resourceId` | `string` The unique ID of the device. The `resourceId`s are returned in the response from the [chromeosdevices.list](https://developers.google.com/workspace/admin/directory/v1/reference/chromeosdevices/list) method. |\n\n### Request body\n\nThe request body contains an instance of [ChromeOsDeviceAction](/workspace/admin/directory/reference/rest/v1/chromeosdevices/action#ChromeOsDeviceAction).\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.device.chromeos`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nChromeOsDeviceAction\n--------------------\n\nData about an update to the status of a Chrome OS device.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ``` { \"action\": string, \"deprovisionReason\": string } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `action` | `string` \u003cbr /\u003e chromeosdevices.action to be taken on the Chrome OS device. Acceptable values are: - `deprovision`: Remove a device from management that is no longer active, being resold, or is being submitted for return / repair, use the deprovision action to dissociate it from management. - `disable`: If you believe a device in your organization has been lost or stolen, you can disable the device so that no one else can use it. When a device is disabled, all the user can see when turning on the Chrome device is a screen telling them that it's been disabled, and your desired contact information of where to return the device.**Note**: Configuration of the message to appear on a disabled device must be completed within the Admin Console. - `reenable`: Re-enable a disabled device when a misplaced device is found or a lost device is returned. You can also use this feature if you accidentally mark a Chrome device as disabled.**Note**: The re-enable action can only be performed on devices marked as disabled. - `pre_provisioned_disable`: A pre-provisioned device that cannot enroll. An admin can re-enable the device to allow Zero-Touch Enrollment by changing the status to \"pre_provisioned_reenable\". **Note**: From this state the device can be deprovisioned. - `pre_provisioned_reenable`: Device is pre-provisioned by OEMs. Devices in this state are eligible for Zero-Touch Enrollment. |\n| `deprovisionReason` | `string` \u003cbr /\u003e Only used when the action is deprovision. With the deprovision action, this field is required. \u003cbr /\u003e | **Note**: The deprovision reason is audited because it might have implications on licenses for perpetual subscription customers. \u003cbr /\u003e Acceptable values are: - `different_model_replacement`: Use if you're upgrading or replacing your device with a newer model of the same device. - `retiring_device`: Use if you're reselling, donating, or permanently removing the device from use. - `same_model_replacement`: Use if a hardware issue was encountered on a device and it is being replaced with the same model or a like-model replacement from a repair vendor / manufacturer. - `upgrade_transfer`: Use if you're replacing your Cloud Ready devices with Chromebooks within one year. |"]]
