REST Resource: chromeosdevices

{
  "deviceId": string,
  "serialNumber": string,
  "status": string,
  "lastSync": string,
  "supportEndDate": string,
  "annotatedUser": string,
  "annotatedLocation": string,
  "notes": string,
  "model": string,
  "meid": string,
  "orderNumber": string,
  "willAutoRenew": boolean,
  "osVersion": string,
  "platformVersion": string,
  "firmwareVersion": string,
  "macAddress": string,
  "bootMode": string,
  "lastEnrollmentTime": string,
  "kind": string,
  "recentUsers": [
    {
      "type": string,
      "email": string
    }
  ],
  "activeTimeRanges": [
    {
      "activeTime": integer,
      "date": string
    }
  ],
  "ethernetMacAddress": string,
  "annotatedAssetId": string,
  "etag": string,
  "diskVolumeReports": [
    {
      "volumeInfo": [
        {
          "volumeId": string,
          "storageTotal": string,
          "storageFree": string
        }
      ]
    }
  ],
  "systemRamTotal": string,
  "cpuStatusReports": [
    {
      "reportTime": string,
      "cpuUtilizationPercentageInfo": [
        integer
      ],
      "cpuTemperatureInfo": [
        {
          "temperature": integer,
          "label": string
        }
      ]
    }
  ],
  "cpuInfo": [
    {
      "model": string,
      "architecture": string,
      "maxClockSpeedKhz": integer,
      "logicalCpus": [
        {
          "maxScalingFrequencyKhz": integer,
          "currentScalingFrequencyKhz": integer,
          "idleDuration": string,
          "cStates": [
            {
              "displayName": string,
              "sessionDuration": string
            }
          ]
        }
      ]
    }
  ],
  "deviceFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "systemRamFreeReports": [
    {
      "reportTime": string,
      "systemRamFreeInfo": [
        string
      ]
    }
  ],
  "lastKnownNetwork": [
    {
      "ipAddress": string,
      "wanIpAddress": string
    }
  ],
  "autoUpdateExpiration": string,
  "ethernetMacAddress0": string,
  "dockMacAddress": string,
  "manufactureDate": string,
  "orgUnitPath": string,
  "tpmVersionInfo": {
    "family": string,
    "specLevel": string,
    "manufacturer": string,
    "tpmModel": string,
    "firmwareVersion": string,
    "vendorSpecific": string
  },
  "screenshotFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "orgUnitId": string,
  "osUpdateStatus": {
    object (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType)
}

string

Die eindeutige ID des Chrome-Geräts.

string

Die bei der Aktivierung des Geräts eingegebene Seriennummer des Chrome-Geräts. Dieser Wert entspricht der Seriennummer in der Admin-Konsole auf dem Tab Chrome OS-Geräte.

string

Der Status des Geräts.

Akzeptable Werte sind:

• ACTIVE: Das Gerät ist in der Domain registriert.
• DELINQUENT: Die Jahreslizenz für die Domain ist abgelaufen und das Gerät erhält keine Richtlinien und Einstellungen mehr. Wenn eine neue Lizenz erworben wird, wechselt das Gerät in den Status ACTIVE zurück.
• PRE_PROVISIONED: Das Gerät wurde für die Zero-Touch-Registrierung registriert. Ein PRE_PROVISIONED-Gerät kann in eine andere Organisationseinheit verschoben oder gelöscht werden. Nach Abschluss der Registrierung erhält das Gerät den Status „ACTIVE“.
• DEPROVISIONED: Das Gerät kann nicht mehr in der Domain registriert werden. Die Bestellung wurde storniert. Die Einstellungen des Geräts wurden im Cache gespeichert. Wenn das Gerät wieder aktiviert wird, werden die aktuellen Systemeinstellungen auf dieses neu aktivierte Gerät angewendet.
• DISABLED: Das Gerät wurde vom Administrator deaktiviert und kann nicht verwendet werden.
• INACTIVE: Das Gerät ist nicht in der Domain registriert.
• RETURN_ARRIVED: Die Anfrage zum Ersetzen dieses Geräts ist eingegangen.
• RETURN_REQUESTED: Es wurde angefordert, dieses Gerät zu ersetzen.
• SHIPPED: Das Gerät wurde aus dem Google-Inventar versendet. (verworfen)
• UNKNOWN: Der Status des Geräts kann nicht ermittelt werden.

string

Datum und Uhrzeit der letzten Synchronisierung des Geräts mit den Richtlinieneinstellungen in der Admin-Konsole. Der Wert wird im ISO 8601-Datums- und Zeitformat angegeben. Die Zeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format YYYY-MM-DDThh:mm:ssTZD. Beispiel: 2010-04-05T17:30:04+01:00

string

Das Datum, ab dem das Gerät endgültig unterstützt wird. Dies gilt nur für Geräte, die direkt bei Google gekauft wurden. Der Wert wird im ISO 8601-Datums- und Zeitformat angegeben. Die Zeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format YYYY-MM-DDThh:mm:ssTZD. Beispiel: 2010-04-05T17:30:04+01:00

string

Der vom Administrator vermerkte Nutzer des Geräts. Die maximale Länge beträgt 100 Zeichen. Leere Werte sind zulässig.

string

Die vom Administrator vermerkte Adresse oder der Standort des Geräts. Die maximale Länge beträgt 200 Zeichen. Leere Werte sind zulässig.

string

Vom Administrator hinzugefügte Hinweise zu diesem Gerät. Diese Eigenschaft kann mit dem query-Parameter der list-Methode gesucht werden. Maximale Länge: 500 Zeichen Leere Werte sind zulässig.

string

Die Modellinformationen des Geräts. Wenn das Gerät nicht über diese Informationen verfügt, ist dieses Attribut nicht in der Antwort enthalten.

string

Die MEID (Mobile Equipment Identifier) oder die IMEI (International Mobile Equipment Identity) für die 3G-Karte eines Mobilgeräts. In der Regel wird eine MEID/IMEI verwendet, wenn ein Gerät dem Postpay-Vertrag eines Mobilfunkanbieters hinzugefügt wird. Wenn das Gerät nicht über diese Informationen verfügt, ist dieses Attribut nicht in der Antwort enthalten. Weitere Informationen zum Exportieren einer MEID/IMEI-Liste finden Sie im Entwicklerhandbuch.

string

Die Bestellnummer des Geräts. Nur Geräte, die direkt bei Google gekauft wurden, haben eine Bestellnummer.

boolean

Legt fest, ob der Support für das Gerät nach dem Enddatum des Supports automatisch verlängert wird. Diese Eigenschaft ist schreibgeschützt.

string

Die Betriebssystemversion des Chrome-Geräts.

string

Die Plattformversion des Chrome-Geräts.

string

Die Firmwareversion des Chrome-Geräts.

string

Die WLAN-MAC-Adresse des Geräts. Wenn das Gerät diese Informationen nicht hat, sind sie nicht in der Antwort enthalten.

string

Der Bootmodus für das Gerät. Die möglichen Werte sind:

• Verified: Auf dem Gerät wird eine gültige Version von Chrome OS ausgeführt.
• Dev: Die Entwicklerhardware des Geräts ist aktiviert. Beim Starten hat das Gerät eine Befehlszeilen-Shell. Ein Beispiel für einen Entwicklerwechsel finden Sie in den Informationen für Chromebook-Entwickler.

string

Datum und Uhrzeit der letzten Registrierung des Geräts. Der Wert wird im ISO 8601-Datums- und Zeitformat angegeben. Die Zeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format YYYY-MM-DDThh:mm:ssTZD. Beispiel: 2010-04-05T17:30:04+01:00 Weitere Informationen zur automatischen und manuellen Registrierung finden Sie in der Chrome-Hilfe.

string

Der Ressourcentyp. Für die ChromeOS-Ressource lautet der Wert admin#directory#chromeosdevice.

object

Eine Liste der letzten Gerätenutzer, in absteigender Reihenfolge, geordnet nach dem Zeitpunkt der letzten Anmeldung.

string

Der Typ der Nutzenden.

Akzeptable Werte sind:

• USER_TYPE_MANAGED: Der Nutzer wird von der Domain verwaltet.
• USER_TYPE_UNMANAGED: Der Nutzer wird nicht von der Domain verwaltet.

string

Die E-Mail-Adresse des Nutzers. Dies ist nur vorhanden, wenn der Nutzertyp USER_TYPE_MANAGED ist.

object

Eine Liste der aktiven Zeiträume (schreibgeschützt).

integer

Nutzungsdauer in Millisekunden.

string

Nutzungsdatum.

string

Die MAC-Adresse des Geräts auf der Ethernet-Netzwerkschnittstelle.

string

Die von einem Administrator vermerkt oder bei der Registrierung angegebene Geräte-ID.

string

Das ETag der Ressource.

object

Berichte über den Speicherplatz und andere Informationen zu bereitgestellten/verbundenen Volumes.

object

Laufwerks-Volumes

string

Volume-ID

string (int64 format)

Speicherplatz insgesamt [in Byte]

string (int64 format)

Freier Speicherplatz [in Byte]

string (int64 format)

RAM auf dem Gerät insgesamt in Byte

object

Berichte zur CPU-Auslastung und -Temperatur (schreibgeschützt)

string

Datum und Uhrzeit des Empfangs des Berichts.

integer

object

Eine Liste von CPU-Temperaturbeispielen.

integer

Temperatur in Celsius

string

CPU-Label

object

Informationen zu den CPU-Spezifikationen im Gerät.

string

Der Name des CPU-Modells.

string

Die CPU-Architektur.

integer

Die maximale CPU-Taktgeschwindigkeit in kHz.

object

Informationen zu den logischen CPUs

integer

Die maximale Frequenz, mit der die CPU gemäß Richtlinie ausgeführt werden darf.

integer

Aktuelle Frequenz, mit der die CPU ausgeführt wird.

string (Duration format)

Inaktivitätszeit seit dem letzten Start.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

object

C-States geben den Stromverbrauchsstatus der CPU an. Weitere Informationen finden Sie in der vom CPU-Hersteller veröffentlichten Dokumentation.

string

Name des Bundesstaates.

string (Duration format)

Zeit seit dem letzten Neustart im Status.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

object

Liste der Gerätedateien, die heruntergeladen werden sollen (schreibgeschützt)

string

Dateiname

string

Dateityp

string

URL für Dateidownload

string

Datum und Uhrzeit der Dateierstellung

object

Berichte über die Menge des verfügbaren RAM-Speichers (schreibgeschützt)

string

Datum und Uhrzeit des Empfangs des Berichts.

string (int64 format)

object

Enthält das letzte bekannte Netzwerk (schreibgeschützt)

string

Die IP-Adresse.

string

Die WAN-IP-Adresse.

string (int64 format)

(Schreibgeschützt) Der Zeitstempel, nach dem das Gerät keine Chrome-Updates oder -Support mehr erhält. Verwenden Sie „autoUpdateThrough“. .

string

(Schreibgeschützt) MAC-Adresse, die vom internen Ethernet-Port des Chromebooks und für die integrierte Netzwerkschnittstelle (Ethernet-Schnittstelle) verwendet wird. Das Format besteht aus zwölf (12) Hexadezimalziffern ohne Trennzeichen (Großbuchstaben). Dies ist nur für einige Geräte relevant.

string

(Schreibgeschützt) Integrierte MAC-Adresse für die Dockingstation, mit der das Gerät verbunden ist. Die Adresse für die Medienzugriffssteuerung (MAC-Adresse) wird für die Verwendung durch ein Dock auf die Werkseinstellungen festgelegt. Sie ist speziell für die MAC-Durchleitungsgeräterichtlinie reserviert. Das Format besteht aus zwölf (12) Hexadezimalziffern ohne Trennzeichen (Großbuchstaben). Dies ist nur für einige Geräte relevant.

string

(Schreibgeschützt) Das Herstellungsdatum des Geräts im Format JJJJ-MM-TT.

string

Der vollständige übergeordnete Pfad mit dem Namen der Organisationseinheit, der dem Gerät zugeordnet ist. Bei Pfadnamen wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn es sich bei der übergeordneten Organisationseinheit um die oberste Organisationsebene handelt, wird sie durch einen Schrägstrich (/) dargestellt. Dieses Attribut kann mithilfe der API aktualisiert werden. Weitere Informationen zum Erstellen einer Organisationsstruktur für Ihr Gerät finden Sie in der Hilfe für Administratoren.

object

Trusted Platform Module (TPM) (schreibgeschützt)

string

TPM-Familie. Wir verwenden die TPM 2.0-Stilcodierung. Beispiel:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: „2.0“ -> 322e3000

string

TPM-Spezifikationsebene. Siehe Bibliotheksspezifikation für TPM 2.0 und Hauptspezifikation für TPM 1.2.

string

TPM-Herstellercode.

string

TPM-Modellnummer.

string

TPM-Firmwareversion.

string

Anbieterspezifische Informationen wie die Anbieter-ID

object

Eine Liste der herunterzuladenden Screenshotdateien. Der Typ ist immer "SCREENSHOT_FILE". (schreibgeschützt)

string

Dateiname

string

Dateityp

string

URL für Dateidownload

string

Datum und Uhrzeit der Dateierstellung

string

Die eindeutige ID der Organisationseinheit. „orgUnitPath“ ist die für Menschen lesbare Version von „orgUnitId“. Während „orgUnitPath“ sich durch Umbenennen einer Organisationseinheit innerhalb des Pfads ändern kann, lässt sich „orgUnitId“ für eine Organisationseinheit nicht ändern. Dieses Attribut kann mithilfe der API aktualisiert werden. Weitere Informationen zum Erstellen einer Organisationsstruktur für Ihr Gerät finden Sie in der Hilfe für Administratoren.

object (OsUpdateStatus)

Der Status der Betriebssystemupdates für das Gerät.

string

Datum und Uhrzeit der ersten Registrierung des Geräts.

string

(Schreibgeschützt) Datum und Uhrzeit der letzten Aufhebung der Bereitstellung des Geräts.

enum (DeprovisionReason)

(Lesezugriff) Grund für das Aufheben der Bereitstellung.

enum (DeviceLicenseType)

Nur Ausgabe. Gerätelizenztyp.

object (BacklightInfo)

Nur Ausgabe. Enthält Informationen zur Hintergrundbeleuchtung für das Gerät.

string

Nur Ausgabe. Der Zeitstempel, nach dem das Gerät keine Chrome-Updates oder -Support mehr erhält.

boolean

Nur Ausgabe. Gibt an, ob für das Gerät die erweiterte Supportanmeldung erforderlich ist.

string

Nur Ausgabe. Datum des Geräts, an dem die erweiterte Supportrichtlinie für automatische Updates beginnt.

boolean

Nur Ausgabe. Gibt an, ob die Richtlinie für den erweiterten Support auf dem Gerät aktiviert ist.

object (FanInfo)

Nur Ausgabe. Lüfterinformationen für das Gerät.

enum (ChromeOsType)

Nur Ausgabe. ChromeOS-Typ des Geräts.

{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}

enum (UpdateState)

Der Updatestatus eines Betriebssystemupdates.

string

Neue Plattformversion des Betriebssystem-Images, das heruntergeladen und angewendet wird Er wird nur festgelegt, wenn der Updatestatus UPDATE_STATUS_DOWNLOAD_IN_PROGRESS oder UPDATE_STATUS_NEED_REBOOT ist. Beachten Sie, dass dies ein Dummy-Element "0.0.0.0" sein kann. für UPDATE_STATUS_NEED_REBOOT in einigen Grenzfällen, z.B. die Update-Engine ohne Neustart neu gestartet wird.

string

Neue erforderliche Plattformversion der ausstehenden aktualisierten Kiosk-App.

string

Datum und Uhrzeit der letzten erfolgreichen Betriebssystemaktualisierung.

string

Datum und Uhrzeit der letzten Updateprüfung.

string

Datum und Uhrzeit des letzten Neustarts.

{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}

string

Nur Ausgabe. Pfad zu dieser Hintergrundbeleuchtung im System. Nützlich, wenn der Anrufer mit anderen Informationen korrelieren muss.

integer

Nur Ausgabe. Maximale Helligkeit der Hintergrundbeleuchtung.

integer

Nur Ausgabe. Aktuelle Helligkeit der Hintergrundbeleuchtung, zwischen 0 und maxBrightness.

{
  "speedRpm": integer
}

integer

Nur Ausgabe. Lüftergeschwindigkeit in RPM.