Method: customer.devices.chromeos.batchChangeStatus

Ändert den Status einer Gruppe von ChromeOS-Geräten. Weitere Informationen zum Ändern des Status eines ChromeOS-Geräts 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

string

Erforderlich. Die unveränderliche ID des Google Workspace-Kontos.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
Felder
deviceIds[]

string

Erforderlich. Liste der IDs der zu ändernden ChromeOS-Geräte. Maximal 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

Erforderlich. Die Aktion, die auf dem ChromeOS-Gerät ausgeführt werden muss, um den Status zu ändern.
deprovisionReason

enum (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 leer.

Antworttext

Die Antwort auf die Änderung des Status einer Gruppe von ChromeOS-Geräten.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
Felder
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

Die Ergebnisse für jedes der in der Anfrage angegebenen ChromeOS-Geräte.

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 muss, um den Status eines ChromeOS-Geräts zu ändern.

Enums
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Standardwert. Der Wert wird nicht verwendet.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION Deaktiviert die Bereitstellung eines ChromeOS-Geräts. Wenn Sie ChromeOS-Geräte haben, die in Ihrer Organisation nicht mehr verwendet werden, sollten Sie deren Bereitstellung aufheben und damit auch die Verwaltung beenden. Dadurch werden alle auf dem Gerät vorhandenen Richtlinien und Drucker auf Geräteebene entfernt und das Gerät kann dann nicht mehr als Kiosk verwendet werden. Je nachdem, welches Upgrade mit dem Gerät verknüpft ist, wird die Lizenz durch diese Aktion möglicherweise wieder in den Lizenzpool freigegeben. Sie können sie dann auf einem anderen Gerät verwenden.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Deaktiviert ein ChromeOS-Gerät. Verwenden Sie diese Aktion, wenn ein Nutzer sein Gerät verliert oder es gestohlen wird. Das Gerät wird dann weiterhin verwaltet und erhält weiterhin Richtlinien, kann aber von niemandem verwendet werden. Je nachdem, welches Upgrade mit dem Gerät verknüpft ist, wird die Lizenz durch diese Aktion möglicherweise wieder in den Lizenzpool freigegeben. Sie können sie dann auf einem anderen Gerät verwenden.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Hiermit wird die Verwendung eines ChromeOS-Geräts reaktiviert, nachdem es deaktiviert wurde. Das Gerät wird wieder aktiviert, sobald es nicht mehr verloren ist oder wiedergefunden wurde. Das Gerät kann dann wieder verwendet werden. Je nach dem mit dem Gerät verknüpften Upgrade wird dadurch möglicherweise eine Lizenz aus dem Lizenzpool verbraucht. Wenn also nicht genügend Lizenzen verfügbar sind, schlägt der Vorgang fehl.

ChangeChromeOsDeviceStatusResult

Das Ergebnis eines einzelnen ChromeOS-Geräts für einen Statusänderungsvorgang.

JSON-Darstellung 
{
  "deviceId": string,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
Felder
deviceId

string

Die eindeutige ID des ChromeOS-Geräts.

Union-Feld result.

Für result ist nur einer der folgenden Werte zulässig:
error

object (Status)

Das Fehlerergebnis des Vorgangs im Fall eines Fehlers.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Der Status des Geräts konnte 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

integer

Der Statuscode, der idealerweise ein ENUM-Wert von google.rpc.Code ist.
message

string

Eine an Entwickler gerichtete Fehlermeldung, die englischsprachig sein sollte. Jede Fehlermeldung an den Nutzer sollte lokalisiert und im Feld google.rpc.Status.details gesendet werden. Sie kann auch clientseitig lokalisiert werden.
details[]

object

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 "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

Dieser Typ hat keine Felder.

Antwort bei erfolgreicher Statusänderung eines ChromeOS-Geräts.