Method: customer.devices.chromeos.batchChangeStatus

Ä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

string

Erforderlich. 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 seinen 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 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 (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
Felder
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

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 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 Falle eines Fehlers.
response

object (ChangeChromeOsDeviceStatusSucceeded)

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

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 von ChromeOS-Geräten.