Method: customer.devices.chromeos.batchChangeStatus

Ändert den Status mehrerer ChromeOS-Geräte. Weitere Informationen zum Ändern des Status eines ChromeOS-Geräts finden Sie unter 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 ChromeOS-Geräte, die geändert werden sollen. Maximal 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

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

enum (DeprovisionReason)

Optional. Der Grund für das Aufheben der Bereitstellung eines Geräts. Muss angegeben werden, wenn „changeChromeOsDeviceStatusAction“ ist auf "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION" festgelegt. Andernfalls lassen Sie dieses Feld weg.

Antworttext

Reaktion auf die Änderung des Status 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 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 auszuführende Aktion, 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 Die Bereitstellung eines ChromeOS-Geräts wird aufgehoben. Wenn Sie ChromeOS-Geräte haben, die in Ihrer Organisation nicht mehr verwendet werden, heben Sie die Bereitstellung auf, damit Sie sie nicht mehr verwalten können. Wenn Sie die Bereitstellung für das Gerät aufheben, werden alle auf dem Gerät vorhandenen Richtlinien sowie Drucker auf Geräteebene entfernt und das Gerät kann nicht mehr als Kiosk verwendet werden. Je nach Upgrade, das mit dem Gerät verknüpft ist, wird die Lizenz durch diese Aktion möglicherweise wieder im Lizenzpool freigegeben. damit Sie die Lizenz auf einem anderen Gerät verwenden können.
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 dadurch zwar weiterhin verwaltet, erhält zwar weiterhin Richtlinien, kann es aber nicht mehr verwenden. Je nach Upgrade, das mit dem Gerät verknüpft ist, wird die Lizenz durch diese Aktion möglicherweise wieder im Lizenzpool freigegeben. damit Sie die Lizenz auf einem anderen Gerät verwenden können.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Ein ChromeOS-Gerät wird wieder aktiviert, damit es nach der Deaktivierung wieder verwendet werden kann. Das Gerät wird wieder aktiviert, sobald es nicht mehr verloren geht oder wiederhergestellt wurde. Dadurch kann das Gerät wieder verwendet werden. Je nach Upgrade, das mit dem Gerät verknüpft ist, wird möglicherweise eine Lizenz aus dem Lizenzpool verbraucht. Wenn nicht genügend Lizenzen verfügbar sind, schlägt der Vorgang fehl.

ChangeChromeOsDeviceStatusResult

Das Ergebnis eines einzelnen ChromeOS-Geräts bei einem Vorgang zum Ändern des Status.

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 möglicherweise 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 auf eine erfolgreiche Änderung des ChromeOS-Gerätestatus.