Ändert den Status einer Reihe von ChromeOS-Geräten. Weitere Informationen finden Sie im Hilfeartikel ChromeOS-Geräte reparieren, wiederverwenden oder aussortieren.
HTTP-Anfrage
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
customerId |
Erforderlich. Unveränderliche ID des Google Workspace-Kontos. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "deviceIds": [ string ], "changeChromeOsDeviceStatusAction": enum ( |
Felder | |
---|---|
deviceIds[] |
Erforderlich. Liste der IDs der zu ändernden ChromeOS-Geräte. Maximal 50. |
changeChromeOsDeviceStatusAction |
Erforderlich. Die Aktion, die auf dem ChromeOS-Gerät ausgeführt werden muss, um seinen Status zu ändern. |
deprovisionReason |
Optional. Der Grund für die Aufhebung der Bereitstellung eines Geräts. Muss angegeben werden, wenn „changeChromeOsDeviceStatusAction“ auf „CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION“ festgelegt ist. Andernfalls lassen Sie dieses Feld weg. |
Antworttext
Die Antwort auf die Statusänderung mehrerer ChromeOS-Geräte.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"changeChromeOsDeviceStatusResults": [
{
object ( |
Felder | |
---|---|
changeChromeOsDeviceStatusResults[] |
Die Ergebnisse für jedes ChromeOS-Gerät, das in der Anfrage angegeben wurde. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/admin.directory.device.chromeos
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
ChangeChromeOsDeviceStatusAction
Die Aktion, die ausgeführt werden soll, um den Status eines ChromeOS-Geräts zu ändern.
Enums | |
---|---|
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED |
Standardwert. Wert wird nicht verwendet. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION |
Die Bereitstellung eines ChromeOS-Geräts wird aufgehoben. Wenn Sie ChromeOS-Geräte haben, die in Ihrer Organisation nicht mehr verwendet werden, sollten Sie deren Bereitstellung aufheben und sie dann auch nicht mehr verwalten. Dadurch werden alle auf dem Gerät vorhandenen Richtlinien und Drucker auf Geräteebene entfernt und das Gerät kann nicht mehr als Kiosk verwendet werden. Abhängig vom Upgrade, das mit dem Gerät verknüpft ist, kann die Lizenz durch diese Aktion wieder für den Lizenzpool freigegeben werden. Sie können die Lizenz dann auf einem anderen Gerät verwenden. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE |
Deaktiviert ein ChromeOS-Gerät. Diese Aktion eignet sich, wenn das Gerät eines Nutzers verloren geht oder gestohlen wird. Das Gerät wird dadurch weiterhin verwaltet und erhält Richtlinien, kann aber von niemandem verwendet werden. Abhängig vom Upgrade, das mit dem Gerät verknüpft ist, kann die Lizenz durch diese Aktion wieder für den Lizenzpool freigegeben werden. Sie können die Lizenz dann auf einem anderen Gerät verwenden. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE |
Aktiviert ein ChromeOS-Gerät, das nach der Deaktivierung wieder verwendet werden kann. Das Gerät wird wieder aktiviert, sobald es nicht mehr verloren geht oder wiederhergestellt wird. So kann das Gerät wieder verwendet werden. Abhängig vom mit dem Gerät verknüpften Upgrade kann eine Lizenz aus dem Lizenzpool verbraucht werden. Wenn nicht genügend Lizenzen verfügbar sind, schlägt der Vorgang fehl. |
ChangeChromeOsDeviceStatusResult
Das Ergebnis eines einzelnen ChromeOS-Geräts für einen Vorgang zur Statusänderung.
JSON-Darstellung |
---|
{ "deviceId": string, // Union field |
Felder | |
---|---|
deviceId |
Die eindeutige ID des ChromeOS-Geräts. |
Union-Feld Für |
|
error |
Das Fehlerergebnis des Vorgangs im Falle eines Fehlers. |
response |
Der Status des Geräts könnte erfolgreich geändert werden. |
Status
Mit dem Typ Status
wird ein logisches Fehlermodell definiert, das für verschiedene Programmierumgebungen wie REST APIs und RPC APIs geeignet ist. Dieses Modell wird von gRPC verwendet. Jede Status
-Meldung enthält die folgenden drei Datenelemente: Fehlercode, Fehlermeldung und Fehlerdetails.
Weitere Informationen zu diesem Fehlermodell und zur Arbeit damit finden Sie in der API-Designanleitung.
JSON-Darstellung |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Felder | |
---|---|
code |
Der Statuscode, der idealerweise ein ENUM-Wert von |
message |
Eine an Entwickler gerichtete Fehlermeldung, die englischsprachig sein sollte. Jede Fehlermeldung an den Nutzer sollte lokalisiert und im Feld |
details[] |
Eine Auflistung aller Meldungen, die die Fehlerdetails enthalten. Es gibt einen gemeinsamen Satz von Nachrichtentypen, die APIs verwenden können. Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld |
ChangeChromeOsDeviceStatusSucceeded
Dieser Typ hat keine Felder.
Antwort bei erfolgreicher Statusänderung von ChromeOS-Geräten.