REST Resource: customers.telemetry.devices

Ressource: TelemetryDevice

Von einem verwalteten Gerät erfasste Telemetriedaten

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_DEVICE
JSON-Darstellung 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "deviceId": string,
  "serialNumber": string,
  "cpuInfo": [
    {
      object (CpuInfo)
    }
  ],
  "cpuStatusReport": [
    {
      object (CpuStatusReport)
    }
  ],
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryStatusReport": [
    {
      object (MemoryStatusReport)
    }
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "networkStatusReport": [
    {
      object (NetworkStatusReport)
    }
  ],
  "networkDiagnosticsReport": [
    {
      object (NetworkDiagnosticsReport)
    }
  ],
  "osUpdateStatus": [
    {
      object (OsUpdateStatus)
    }
  ],
  "graphicsInfo": {
    object (GraphicsInfo)
  },
  "graphicsStatusReport": [
    {
      object (GraphicsStatusReport)
    }
  ],
  "batteryInfo": [
    {
      object (BatteryInfo)
    }
  ],
  "batteryStatusReport": [
    {
      object (BatteryStatusReport)
    }
  ],
  "storageInfo": {
    object (StorageInfo)
  },
  "storageStatusReport": [
    {
      object (StorageStatusReport)
    }
  ],
  "thunderboltInfo": [
    {
      object (ThunderboltInfo)
    }
  ],
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "bootPerformanceReport": [
    {
      object (BootPerformanceReport)
    }
  ],
  "heartbeatStatusReport": [
    {
      object (HeartbeatStatusReport)
    }
  ],
  "kioskAppStatusReport": [
    {
      object (KioskAppStatusReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
Felder
name

string

Nur Ausgabe Ressourcenname des Geräts.
customer

string

Nur Ausgabe Der Google Workspace-Kunde, dessen Unternehmen das Gerät registriert hat.
orgUnitId

string

Nur Ausgabe ID der Organisationseinheit des Geräts.
deviceId

string

Nur Ausgabe Die eindeutige Directory API-ID des Geräts. Dieser Wert entspricht der Directory API-ID der Admin-Konsole auf dem Tab „ChromeOS-Geräte“
serialNumber

string

Nur Ausgabe Seriennummer des Geräts Dieser Wert entspricht der Seriennummer der Admin-Konsole auf dem Tab „ChromeOS-Geräte“.
cpuInfo[]

object (CpuInfo)

Nur Ausgabe Informationen zu den CPU-Spezifikationen für das Gerät.
cpuStatusReport[]

object (CpuStatusReport)

Nur Ausgabe Die regelmäßig erfassten CPU-Statusberichte sind in absteigender Reihenfolge (reportTime) sortiert.
memoryInfo

object (MemoryInfo)

Nur Ausgabe Informationen zu den Speicherspezifikationen des Geräts.
memoryStatusReport[]

object (MemoryStatusReport)

Nur Ausgabe Regelmäßig erhobene Arbeitsspeicherstatusberichte, absteigend nach reportTime sortiert.
networkInfo

object (NetworkInfo)

Nur Ausgabe Informationen zu Netzwerkgeräten.
networkStatusReport[]

object (NetworkStatusReport)

Nur Ausgabe Netzwerkspezifikationen, die regelmäßig erfasst werden.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Nur Ausgabe Netzwerkdiagnose wird in regelmäßigen Abständen erfasst.
osUpdateStatus[]

object (OsUpdateStatus)

Nur Ausgabe Enthält relevante Informationen zum Status des ChromeOS-Updates.
graphicsInfo

object (GraphicsInfo)

Nur Ausgabe Enthält Informationen zu grafischen Peripheriegeräten für das Gerät.
graphicsStatusReport[]

object (GraphicsStatusReport)

Nur Ausgabe Grafikberichte, die regelmäßig erstellt werden.
batteryInfo[]

object (BatteryInfo)

Nur Ausgabe Informationen zu den Akkuspezifikationen des Geräts.
batteryStatusReport[]

object (BatteryStatusReport)

Nur Ausgabe Akkuberichte werden regelmäßig erstellt.
storageInfo

object (StorageInfo)

Nur Ausgabe Informationen zu den Speicherspezifikationen des Geräts.
storageStatusReport[]

object (StorageStatusReport)

Nur Ausgabe Speicherberichte, die regelmäßig erstellt werden.
thunderboltInfo[]

object (ThunderboltInfo)

Nur Ausgabe Informationen zum Thunderbolt-Bus.
audioStatusReport[]

object (AudioStatusReport)

Nur Ausgabe Die regelmäßig erhobenen Audioberichte sind in absteigender Reihenfolge (reportTime) sortiert.
bootPerformanceReport[]

object (BootPerformanceReport)

Nur Ausgabe Leistungsberichte des Geräts starten.
heartbeatStatusReport[]

object (HeartbeatStatusReport)

Nur Ausgabe Heartbeat-Statusbericht mit Zeitstempeln, die regelmäßig in absteigender Reihenfolge von reportTime sortiert sind
kioskAppStatusReport[]

object (KioskAppStatusReport)

Nur Ausgabe Statusbericht zu Kiosk-Apps für das Kioskgerät
networkBandwidthReport[]

object (NetworkBandwidthReport)

Nur Ausgabe Berichte zur Netzwerkbandbreite werden regelmäßig in absteigender Reihenfolge (reportTime) erfasst.
peripheralsReport[]

object (PeripheralsReport)

Nur Ausgabe Die regelmäßig erfassten Berichte zu Peripheriegeräten sind in absteigender Reihenfolge (reportTime) sortiert.
runtimeCountersReport[]

object (RuntimeCountersReport)

Nur Ausgabe Laufzeitzähler melden die erfasste Lebensdauer der Gerätelaufzeit sowie die Anzahl der Übergänge S0->S3, S0->S4 und S0->S5, was bedeutet, dass der Ruhemodus, Ruhezustand und Abschalten ausgelöst wird.

CpuInfo

CPU-Spezifikationen für das Gerät

  • Dieses Feld enthält Geräteinformationen. Diese sind statisch und ändern sich im Laufe der Zeit nicht.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_CPU_INFO
JSON-Darstellung 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
Felder
model

string

Nur Ausgabe Der Name des CPU-Modells. Beispiel: Intel(R) Core(TM) i5-8250U CPU mit 1,60 GHz
architecture

enum (Architecture)

Nur Ausgabe Architekturtyp für die CPU.

  • Dieses Feld enthält Geräteinformationen. Diese sind statisch und ändern sich im Laufe der Zeit nicht.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
maxClockSpeed

integer

Nur Ausgabe Die maximale CPU-Taktgeschwindigkeit in kHz.
keylockerSupported

boolean

Nur Ausgabe Gibt an, ob Keylocker unterstützt wird.
keylockerConfigured

boolean

Nur Ausgabe Gibt an, ob die Tastensperre konfiguriert ist.TRUE = Aktiviert; FALSE = deaktiviert. Wird nur gemeldet, wenn keylockerSupported = TRUE.

Architektur

Architekturtyp für die CPU.

Enums
ARCHITECTURE_UNSPECIFIED Architektur unbekannt.
X64 x64-Architektur

CpuStatusReport

Liefert Informationen zum Status der CPU.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerhebung: alle 10 Minuten
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_CPU_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe Zeitstempel in Millisekunden für den Zeitpunkt, zu dem für diesen Bericht eine Stichprobe erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

Nur Ausgabe Häufigkeit der Stichprobenerhebung für den Bericht

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
cpuUtilizationPct

integer

Nur Ausgabe Stichprobe der CPU-Auslastung (0–100 %).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Nur Ausgabe Informationen zur CPU-Temperaturbeispiel pro CPU-Kern in Celsius

CpuTemperatureInfo

CPU-Temperatur eines Geräts. Stichprobenerhebung pro CPU-Kern in Celsius.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerhebung: alle 10 Minuten
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "temperatureCelsius": integer,
  "label": string
}
Felder
temperatureCelsius

integer

Nur Ausgabe CPU-Temperatur in Celsius.
label

string

Nur Ausgabe CPU-Label. Beispiel: Kern 0

MemoryInfo

Informationen zum Arbeitsspeicher eines Geräts.

  • Dieses Feld enthält sowohl Telemetrie- als auch Geräteinformationen:
    • totalRamBytes – Geräteinformationen
    • availableRamBytes – Telemetrieinformationen
    • totalMemoryEncryption – Geräteinformationen
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceMemoryInfo gesteuert.
  • Häufigkeit der Datenerhebung:
    • totalRamBytes – nur beim Upload
    • availableRamBytes – alle 10 Minuten
    • totalMemoryEncryption – beim Gerätestart
  • Standardmäßige Häufigkeit für Datenberichte:
    • totalRamBytes–3 Stunden
    • availableRamBytes–3 Stunden
    • totalMemoryEncryption – beim Gerätestart
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: nur für totalMemoryEncryption
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_MEMORY_INFO
JSON-Darstellung 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Felder
totalRamBytes

string (int64 format)

Nur Ausgabe RAM insgesamt in Byte.
availableRamBytes

string (int64 format)

Nur Ausgabe Menge des verfügbaren RAM in Byte.
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

Nur Ausgabe Informationen zur Arbeitsspeicherverschlüsselung für das Gerät insgesamt.

TotalMemoryEncryptionInfo

Informationen zur Speicherverschlüsselung eines Geräts.

  • Dieses Feld enthält Geräteinformationen. Diese sind statisch und ändern sich im Laufe der Zeit nicht.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceMemoryInfo gesteuert.
  • Häufigkeit der Datenerhebung: beim Gerätestart
  • Standardmäßige Häufigkeit der Datenberichte: Beim Gerätestart
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja.
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Felder
encryptionState

enum (MemoryEncryptionState)

Der Status der Speicherverschlüsselung auf dem Gerät.
maxKeys

string (int64 format)

Die maximale Anzahl von Schlüsseln, die für die Verschlüsselung verwendet werden können.
keyLength

string (int64 format)

Die Länge der Verschlüsselungsschlüssel.
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Algorithmus zur Speicherverschlüsselung.

MemoryEncryptionState

Der Status der Speicherverschlüsselung auf dem Gerät.

Enums
MEMORY_ENCRYPTION_STATE_UNSPECIFIED Der Verschlüsselungsstatus des Arbeitsspeichers ist nicht festgelegt.
MEMORY_ENCRYPTION_STATE_UNKNOWN Der Verschlüsselungsstatus des Arbeitsspeichers ist unbekannt.
MEMORY_ENCRYPTION_STATE_DISABLED Die Speicherverschlüsselung auf dem Gerät ist deaktiviert.
MEMORY_ENCRYPTION_STATE_TME Bei der Arbeitsspeicherverschlüsselung auf dem Gerät wird die gesamte Arbeitsspeicherverschlüsselung verwendet.
MEMORY_ENCRYPTION_STATE_MKTME Bei der Speicherverschlüsselung auf dem Gerät wird die Gesamtspeicherverschlüsselung mit mehreren Schlüsseln verwendet.

MemoryEncryptionAlgorithm

Der auf dem Gerät verwendete Verschlüsselungsalgorithmus.

Enums
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED Der Speicherverschlüsselungsalgorithmus ist nicht festgelegt.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN Der verwendete Algorithmus für die Speicherverschlüsselung ist unbekannt.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 Der Speicherverschlüsselungsalgorithmus verwendet den AES_XTS-Verschlüsselungsalgorithmus mit einem 128-Bit-Blockverschlüsselung.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 Der Speicherverschlüsselungsalgorithmus verwendet den AES_XTS-Verschlüsselungsalgorithmus mit einem 256-Bit-Blockverschlüsselung.

MemoryStatusReport

Enthält Beispiele für Arbeitsspeicherstatusberichte.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceMemoryInfo gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload, SystemRamFreeByes wird alle 10 Minuten erfasst
  • Standardmäßige Häufigkeit für Datenberichte: alle 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_MEMORY_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe Zeitstempel in Millisekunden für den Zeitpunkt, zu dem für diesen Bericht eine Stichprobe erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

Nur Ausgabe Häufigkeit der Stichprobenerhebung für den Bericht

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
systemRamFreeBytes

string (int64 format)

Nur Ausgabe Menge des kostenlosen RAM-Speichers in Byte (unzuverlässig aufgrund der automatischen Speicherbereinigung)
pageFaults

integer

Nur Ausgabe Anzahl der Seitenfehler während dieser Sammlung

NetworkInfo

Informationen zum Netzwerkgerät.

  • Dieses Feld enthält Geräteinformationen. Diese sind statisch und ändern sich im Laufe der Zeit nicht.
  • Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerhebung: beim Gerätestart
  • Standardmäßige Häufigkeit der Datenberichte: Beim Gerätestart
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja.
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_INFO
JSON-Darstellung 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
Felder
networkDevices[]

object (NetworkDevice)

Nur Ausgabe Liste der Netzwerkgeräte.

NetworkDevice

Details zum Netzwerkgerät

  • Dieses Feld enthält Geräteinformationen. Diese sind statisch und ändern sich im Laufe der Zeit nicht.
  • Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerhebung: beim Gerätestart
  • Standardmäßige Häufigkeit der Datenberichte: Beim Gerätestart
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja.
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Felder
type

enum (NetworkDeviceType)

Nur Ausgabe Netzwerkgerätetyp.
macAddress

string

Nur Ausgabe MAC-Adresse (falls zutreffend) des entsprechenden Netzwerkgeräts.
meid

string

Nur Ausgabe MEID (falls zutreffend) des entsprechenden Netzwerkgeräts.
imei

string

Nur Ausgabe IMEI des entsprechenden Netzwerkgeräts (falls zutreffend).
iccid

string

Nur Ausgabe Die Karten-ID der integrierten Schaltung, die der SIM-Karte des Geräts zugeordnet ist.
mdn

string

Nur Ausgabe Die Mobiltelefonnummer, die der SIM-Karte des Geräts zugewiesen ist.

NetworkDeviceType

Netzwerkgerätetypen

Enums
NETWORK_DEVICE_TYPE_UNSPECIFIED Netzwerkgerätetyp nicht angegeben.
CELLULAR_DEVICE Mobilfunkgerät
ETHERNET_DEVICE Ethernet-Gerät.
WIFI_DEVICE Wifi-Gerät.

NetworkStatusReport

Status sichtbarer/konfigurierter Netzwerke.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportNetworkStatus gesteuert.
  • Häufigkeit der Datenerhebung: 60 Minuten
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja.
  • Nur für verknüpfte Nutzer gemeldet: Ja
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "signalStrengthDbm": integer,
  "lanIpAddress": string,
  "gatewayIpAddress": string,
  "transmissionBitRateMbps": string,
  "receivingBitRateMbps": string,
  "transmissionPowerDbm": integer,
  "encryptionOn": boolean,
  "wifiLinkQuality": string,
  "wifiPowerManagementEnabled": boolean,
  "guid": string,
  "connectionState": enum (NetworkConnectionState),
  "connectionType": enum (NetworkType)
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe Zeitpunkt, zu dem der Netzwerkstatus gemeldet wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

Nur Ausgabe Häufigkeit der Stichprobenerhebung für den Bericht

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
signalStrengthDbm

integer

Nur Ausgabe Signalstärke für drahtlose Netzwerke, gemessen in Dezibel.
lanIpAddress

string

Nur Ausgabe LAN-IP-Adresse.
gatewayIpAddress

string

Nur Ausgabe Gateway-IP-Adresse.
transmissionBitRateMbps

string (int64 format)

Nur Ausgabe Übertragungsbitrate in Megabit pro Sekunde.
receivingBitRateMbps

string (int64 format)

Nur Ausgabe Empfangsbitrate, gemessen in Megabit pro Sekunde.
transmissionPowerDbm

integer

Nur Ausgabe Übertragungsleistung in Dezibel.
encryptionOn

boolean

Nur Ausgabe Gibt an, ob der WLAN-Verschlüsselungsschlüssel deaktiviert ist.
wifiPowerManagementEnabled

boolean

Nur Ausgabe WLAN-Energiesparmodus aktiviert
guid

string

Nur Ausgabe GUID der Netzwerkverbindung.
connectionState

enum (NetworkConnectionState)

Nur Ausgabe Aktueller Verbindungsstatus des Netzwerks.
connectionType

enum (NetworkType)

Nur Ausgabe Netzwerkverbindungstyp.

NetworkType

Netzwerkverbindungstypen.

Enums
NETWORK_TYPE_UNSPECIFIED Typ der Netzwerkverbindung nicht angegeben
CELLULAR Mobilfunkverbindung.
ETHERNET Ethernet-Netzwerkverbindung.
TETHER Tethering-Verbindung mit Tethering
VPN VPN-Netzwerkverbindung.
WIFI WLAN-Verbindung

NetworkDiagnosticsReport

Ergebnisse von Netzwerktests zur Bestimmung des Zustands der Netzwerkverbindung des Geräts, z. B. ob die HTTPS-Latenz hoch oder normal ist

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe Zeitstempel der Erfassung der Diagnose.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
httpsLatencyData

object (HttpsLatencyRoutineData)

Nur Ausgabe HTTPS-Latenztestdaten.

OsUpdateStatus

Enthält Informationen zum aktuellen Status des Betriebssystemupdates.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceOsUpdateStatus gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_OS_REPORT
JSON-Darstellung 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Felder
updateState

enum (UpdateState)

Nur Ausgabe Aktueller Status des Betriebssystemupdates.
newPlatformVersion

string

Nur Ausgabe Neue Plattformversion des Betriebssystem-Images, das heruntergeladen und angewendet wird. Er wird nur festgelegt, wenn der Updatestatus OS_IMAGE_DOWNLOAD_IN_PROGRESS oder OS_UPDATE_NEED_REBOOT ist. Beachten Sie, dass dies in einigen Grenzfällen als Dummy-Wert „0.0.0.0“ für OS_UPDATE_NEED_REBOOT-Status verwendet werden kann, z.B. wenn die Update-Engine ohne Neustart neu gestartet wird.
newRequestedPlatformVersion

string

Nur Ausgabe Neue angeforderte Plattformversion von der ausstehenden aktualisierten Kiosk-App.
lastUpdateTime

string (Timestamp format)

Nur Ausgabe Zeitstempel der letzten erfolgreichen Aktualisierung.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastUpdateCheckTime

string (Timestamp format)

Nur Ausgabe Zeitstempel der letzten Aktualisierungsprüfung.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastRebootTime

string (Timestamp format)

Nur Ausgabe Zeitstempel des letzten Neustarts.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

UpdateState

Status des Betriebssystemupdates

Enums
UPDATE_STATE_UNSPECIFIED Status nicht angegeben.
OS_IMAGE_DOWNLOAD_NOT_STARTED Der Download des Betriebssystems wurde nicht gestartet.
OS_IMAGE_DOWNLOAD_IN_PROGRESS Das Betriebssystem hat den Download auf dem Gerät gestartet.
OS_UPDATE_NEED_REBOOT Das Gerät muss neu gestartet werden, um den Upload abzuschließen.

GraphicsInfo

Informationen zum Grafiksubsystem.

  • Dieses Feld enthält Geräteinformationen. Diese sind statisch und ändern sich im Laufe der Zeit nicht.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceGraphicsStatus gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_GRAPHICS_INFO
JSON-Darstellung 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Felder
adapterInfo

object (GraphicsAdapterInfo)

Nur Ausgabe Informationen zur Grafikkarte (GPU)
eprivacySupported

boolean

Nur Ausgabe Ob der Bildschirm für ePrivacy unterstützt wird oder nicht
displayDevices[]

object (DisplayDevice)

Nur Ausgabe Informationen zu den Bildschirmen des Geräts.
touchScreenInfo

object (TouchScreenInfo)

Nur Ausgabe Informationen zu den internen Touchscreens des Geräts.

GraphicsAdapterInfo

Informationen zu einer Grafikkarte (GPU)

JSON-Darstellung 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
Felder
adapter

string

Nur Ausgabe Name des Adapters. Beispiel: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
driverVersion

string

Nur Ausgabe Version des GPU-Treibers.
deviceId

string (int64 format)

Nur Ausgabe Gibt die Geräte-ID der Grafikkarte an.

DisplayDevice

Informationen zu einem Anzeigegerät.

JSON-Darstellung 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer
}
Felder
displayName

string

Nur Ausgabe Gerätename anzeigen
displayWidthMm

integer

Nur Ausgabe Anzeigebreite in Millimetern.
displayHeightMm

integer

Nur Ausgabe Anzeigehöhe in Millimeter.
internal

boolean

Nur Ausgabe Ist Display intern oder nicht.
manufacturerId

string

Nur Ausgabe Hersteller-ID aus drei Buchstaben.
modelId

integer

Nur Ausgabe Produktcode des Herstellers.
manufactureYear

integer

Nur Ausgabe Herstellungsjahr.

TouchScreenInfo

Informationen auf dem Touchscreen des Geräts.

JSON-Darstellung 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
Felder
touchpadLibrary

string

Nur Ausgabe Name der Touchpad-Bibliothek, der vom Eingabe-Stack verwendet wird.
devices[]

object (TouchScreenDevice)

Nur Ausgabe Liste der internen Touchscreen-Geräte.

TouchScreenDevice

Informationen zu einem internen Touchscreen-Gerät.

JSON-Darstellung 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
Felder
displayName

string

Nur Ausgabe Anzeigename des Touchscreens
touchPointCount

integer

Nur Ausgabe Anzahl der auf dem Gerät unterstützten Touchpoints.
stylusCapable

boolean

Nur Ausgabe Das Gerät mit Touchscreen kann Eingabestifte verwenden oder nicht.

GraphicsStatusReport

Informationen zum Grafiksubsystem.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceGraphicsInfo gesteuert.
  • Häufigkeit der Datenerhebung: 3 Stunden.
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_GRAPHICS_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe Zeitpunkt, zu dem die Grafikdaten gemeldet wurden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
displays[]

object (DisplayInfo)

Nur Ausgabe Informationen zu den Bildschirmen für das Gerät.

DisplayInfo

Informationen für ein Display.

JSON-Darstellung 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string
}
Felder
deviceId

string (int64 format)

Nur Ausgabe Gibt die Geräte-ID der Grafikkarte an.
resolutionWidth

integer

Nur Ausgabe Breite der Auflösung in Pixeln.
resolutionHeight

integer

Nur Ausgabe Höhe der Auflösung in Pixeln.
refreshRate

integer

Nur Ausgabe Aktualisierungsrate in Hz.
isInternal

boolean

Nur Ausgabe Gibt an, ob das Display intern ist oder nicht.
displayName

string

Nur Ausgabe Gerätename anzeigen

BatteryInfo

Informationen zum Akku.

  • Dieses Feld enthält Geräteinformationen. Diese sind statisch und ändern sich im Laufe der Zeit nicht.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_BATTERY_INFO
JSON-Darstellung 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
Felder
serialNumber

string

Nur Ausgabe Seriennummer des Akkus.
manufacturer

string

Nur Ausgabe Batteriehersteller.
designCapacity

string (int64 format)

Nur Ausgabe Ausgelegte Kapazität (mAmpere-Stunden)
designMinVoltage

integer

Nur Ausgabe Entworfene minimale Ausgangsspannung (mV)
manufactureDate

object (Date)

Nur Ausgabe Das Datum, an dem der Akku hergestellt wurde.
technology

string

Nur Ausgabe Technologie des Akkus. Beispiel: Li-Ion

BatteryStatusReport

Statusdaten für den Akku.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_BATTERY_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe Zeitstempel, der angibt, wann die Stichprobe auf dem Gerät erfasst wurde

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
serialNumber

string

Nur Ausgabe Seriennummer des Akkus.
sample[]

object (BatterySampleReport)

Nur Ausgabe Stichprobendaten für den Akku sind in absteigender Reihenfolge (reportTime) sortiert.
batteryHealth

enum (BatteryHealth)

Nur Ausgabe Akkuzustand.
fullChargeCapacity

string (int64 format)

Nur Ausgabe Volle Ladekapazität (mAmpere-Stunden).
cycleCount

integer

Nur Ausgabe Anzahl der Ladezyklen.

BatterySampleReport

Stichprobendaten für Akku.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe Zeitstempel, der angibt, wann die Stichprobe auf dem Gerät erfasst wurde

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
voltage

string (int64 format)

Nur Ausgabe Akkuspannung (Millivolt).
remainingCapacity

string (int64 format)

Nur Ausgabe Verbleibende Akkukapazität (Amperestunden).
temperature

integer

Nur Ausgabe Temperatur in Celsius Grad.
dischargeRate

integer

Nur Ausgabe Die Entladerate der Batterie, gemessen in mW. Ein positiver Wert, wenn der Akku entladen wird, ein negativer, wenn der Akku geladen wird.
chargeRate

integer

Nur Ausgabe Akkustand in %.
current

string (int64 format)

Nur Ausgabe Akkustrom (mA).
status

string

Nur Ausgabe Akkustatus wurde von sysfs gelesen. Beispiel: Entladung

BatteryHealth

Zeigt den aktuellen Zustand des Akkus an.

  • Dieser Status ist keine Anzeige und kein Hinweis auf einen defekten Akku. Sie wird berechnet, indem die aktuelle volle Ladekapazität durch die Entwurfskapazität geteilt wird.
  • Der Hersteller legt die Integrität des Akkus und die Garantiebestimmungen selbst fest.
Enums
BATTERY_HEALTH_UNSPECIFIED Gesundheitszustand unbekannt.
BATTERY_HEALTH_NORMAL Akku ist fehlerfrei, volle Ladekapazität / Designkapazität > 80%
BATTERY_REPLACE_SOON Der Akku ist mäßig fehlerhaft und sollte bald ersetzt werden, volle Ladekapazität / Designkapazität zwischen 75 und 80 %
BATTERY_REPLACE_NOW Akku ist fehlerhaft und sollte ersetzt werden, volle Ladekapazität / Ausschöpfungskapazität unter 75%

StorageInfo

Statusdaten für Speicher.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceStorageStatus gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_STORAGE_INFO
JSON-Darstellung 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Felder
volume[]

object (DiskVolume)

Informationen zu Laufwerks-Volumes
availableDiskBytes

string (int64 format)

Der auf dem Gerät verfügbare Speicherplatz für Nutzerdaten in Byte.
totalDiskBytes

string (int64 format)

Der Gesamtspeicherplatz für Nutzerdaten auf dem Gerät in Byte.

DiskVolume

Informationen zu Laufwerks-Volumes

JSON-Darstellung 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
Felder
volumeId

string

Laufwerk-Volume-ID.
storageFreeBytes

string (int64 format)

Freier Speicherplatz in Byte.
storageTotalBytes

string (int64 format)

Gesamtspeicherplatz in Byte.

StorageStatusReport

Statusdaten für Speicher.

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceStorageStatus gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_STORAGE_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe Zeitstempel, der angibt, wann die Stichprobe auf dem Gerät erfasst wurde

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
disk[]

object (DiskInfo)

Nur Ausgabe Berichte auf der Festplatte.

DiskInfo

Status des einzelnen Speichergeräts.

JSON-Darstellung 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "sizeBytes": string,
  "type": string,
  "health": string,
  "volumeIds": [
    string
  ],
  "bytesReadThisSession": string,
  "bytesWrittenThisSession": string,
  "readTimeThisSession": string,
  "writeTimeThisSession": string,
  "ioTimeThisSession": string,
  "discardTimeThisSession": string
}
Felder
serialNumber

string

Nur Ausgabe Seriennummer des Laufwerks.
manufacturer

string

Nur Ausgabe Datenträgerhersteller.
model

string

Nur Ausgabe Laufwerkmodell.
sizeBytes

string (int64 format)

Nur Ausgabe Laufwerkgröße
type

string

Nur Ausgabe Laufwerkstyp: eMMC / NVMe / ATA / SCSI.
health

string

Nur Ausgabe Laufwerkzustand.
volumeIds[]

string

Nur Ausgabe Laufwerks-Volumes
bytesReadThisSession

string (int64 format)

Nur Ausgabe Anzahl der seit dem letzten Start gelesenen Byte.
bytesWrittenThisSession

string (int64 format)

Nur Ausgabe Anzahl der seit dem letzten Start geschriebenen Byte.
readTimeThisSession

string (Duration format)

Nur Ausgabe Zeitaufwand für das Lesen von der Festplatte seit dem letzten Start.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
writeTimeThisSession

string (Duration format)

Nur Ausgabe Zeitaufwand für das Schreiben auf das Laufwerk seit dem letzten Start.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
ioTimeThisSession

string (Duration format)

Nur Ausgabe Zählt, wie lange das Laufwerk und die Warteschlange ausgelastet waren. Im Gegensatz zu den oben genannten Feldern werden parallele Anfragen also nicht mehrfach gezählt.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
discardTimeThisSession

string (Duration format)

Nur Ausgabe Zeit für das Verwerfen seit dem letzten Start. Beim Verwerfen werden nicht mehr verwendete Blöcke gelöscht. Wird auf Kernels ab 4.18 unterstützt.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

ThunderboltInfo

Informationen zum Thunderbolt-Bus.

  • Dieses Feld enthält Geräteinformationen. Diese sind statisch und ändern sich im Laufe der Zeit nicht.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceSecurityStatus gesteuert.
  • Häufigkeit der Datenerhebung: beim Gerätestart
  • Standardmäßige Häufigkeit der Datenberichte: Beim Gerätestart
    • Richtliniensteuerung: Nein
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja.
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_BUS_DEVICE_INFO
JSON-Darstellung 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Felder
securityLevel

enum (ThunderboltSecurityLevel)

Sicherheitsniveau des Thunderbolt-Bus.

ThunderboltSecurityLevel

Sicherheitsniveau des Thunderbolt-Bus.

Enums
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED Thunderbolt-Sicherheitsstufe ist nicht festgelegt.
THUNDERBOLT_SECURITY_NONE_LEVEL Alle Geräte werden automatisch über die Firmware verbunden. Es ist keine Genehmigung durch den Nutzer erforderlich.
THUNDERBOLT_SECURITY_USER_LEVEL Der Nutzer wird gefragt, ob das Gerät verbunden werden darf.
THUNDERBOLT_SECURITY_SECURE_LEVEL Der Nutzer wird gefragt, ob das Gerät verbunden werden darf. Darüber hinaus erhält das Gerät eine Identitätsbestätigung, die der erwarteten Abfrage entspricht. Diese basiert auf einem zufälligen Schlüssel, der in das Schlüsselattribut „sysfs“ geschrieben wurde.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL Die Firmware erstellt automatisch Tunnel für Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL Die Firmware erstellt automatisch Tunnel für den USB-Controller und den Displayport in einem Dock. Alle dem Dock nachgeschalteten PCIe-Verbindungen werden entfernt.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL PCIE-Tunneling ist deaktiviert.

BootPerformanceReport

Leistungsbericht zum Start eines Geräts

  • Dieses Feld enthält Telemetriedaten, die sich im Laufe der Zeit mit der Nutzung des Geräts ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceBootMode gesteuert.
  • Häufigkeit der Datenerhebung: bei jedem Startereignis
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja.
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_OS_REPORT
JSON-Darstellung 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
Felder
bootUpDuration

string (Duration format)

Gesamtzeit für den Start.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
bootUpTime

string (Timestamp format)

Der Zeitstempel des Zeitpunkts, zu dem das Gerät eingeschaltet wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
shutdownDuration

string (Duration format)

Gesamtzeit seit Beginn des Herunterfahrens bis zum Ausschalten.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
shutdownTime

string (Timestamp format)

Der Zeitstempel beim Herunterfahren.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
shutdownReason

enum (ShutdownReason)

Der Grund für das Herunterfahren.
reportTime

string (Timestamp format)

Zeitstempel für den Zeitpunkt, zu dem der Bericht erfasst wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

ShutdownReason

Der Grund für das Herunterfahren.

Enums
SHUTDOWN_REASON_UNSPECIFIED Es ist kein Grund für das Herunterfahren angegeben.
USER_REQUEST Vom Nutzer initiiert.
SYSTEM_UPDATE Systemupdate gestartet.
LOW_BATTERY Wegen niedrigem Akkustand ausschalten.
OTHER Aus anderen Gründen herunterfahren.

HeartbeatStatusReport

Heartbeat-Statusbericht für ein Gerät

  • Für Kioske verfügbar
  • Dieses Feld gibt den Online-/Offline-/Unbekannten Status eines Geräts an und wird nur angezeigt, wenn sich der Status geändert hat (z. B. Online -> Offline).
  • Daten für dieses Feld werden über die Richtlinie HeartbeatEnabled gesteuert. Weitere Informationen
  • Heartbeat-Frequenz: 2 Min.
    • Hinweis: Wenn ein Gerät offline geht, kann es bis zu 12 Minuten dauern, bis der Onlinestatus des Geräts aktualisiert wird.
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: N/A
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "state": enum (State)
}
Felder
reportTime

string (Timestamp format)

Zeitstempel, der angibt, wann eine Statusänderung erkannt wurde

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
state

enum (State)

Status, in den das Gerät geändert wurde

Status

Gerätestatus

Enums
STATE_UNSPECIFIED Status nicht angegeben
UNKNOWN Gerät ist nicht für die Heartbeat-Überwachung geeignet
ONLINE Gerät ist online
OFFLINE Gerät ist offline

KioskAppStatusReport

Statusbericht zu Kiosk-Apps eines Geräts.

  • Für Kioske verfügbar
  • Dieses Feld enthält die App-ID und die Versionsnummer, die auf einem Kioskgerät ausgeführt werden, sowie den Zeitstempel der letzten Aktualisierung des Berichts.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceSessionStatus gesteuert.
  • Häufigkeit der Datenerfassung: Nur beim Upload
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniensteuerung: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_APPS_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Felder
reportTime

string (Timestamp format)

Zeitstempel für die Erfassung des Berichts

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
appId

string

App-ID der Kiosk-App, z. B. „mdmkkicfmmkgmpkmkdikhlbggogpicma“
appVersion

string

Versionsnummer der Kiosk-App, z. B. „1.10.118“

RuntimeCountersReport

Von der CPU abgerufene Laufzeitzähler. Derzeit wird die Telemetrie der Laufzeitzähler nur von Intel vPro PSR ab der 14. Generation unterstützt.

JSON-Darstellung 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
Felder
reportTime

string (Timestamp format)

Zeitstempel für den Zeitpunkt, zu dem der Bericht erfasst wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
uptimeRuntimeDuration

string (Duration format)

Laufzeit insgesamt. Derzeit immer S0-Laufzeit von Intel vPro PSR.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
enterSleepCount

string (int64 format)

Häufigkeit, mit der das Gerät in den Ruhemodus versetzt wurde. Derzeit über die PSR abgerufen, Zählung von S0 bis S3.
enterHibernationCount

string (int64 format)

Häufigkeit, mit der das Gerät in den Ruhezustand versetzt wurde. Derzeit über die PSR abgerufen, Zählung von S0 bis S4.
enterPoweroffCount

string (int64 format)

Gibt an, wie oft das Gerät abgeschaltet wurde. Derzeit über die PSR abgerufen, Zählung von S0 bis S5.

Methoden

get

 Telemetriegerät abrufen.

list

 Hiermit werden alle Telemetriegeräte aufgelistet.