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

L'ID univoco del dispositivo Chrome.

string

Il numero di serie del dispositivo Chrome inserito al momento dell'attivazione del dispositivo. Questo valore corrisponde al numero di serie della Console di amministrazione nella scheda Dispositivi ChromeOS.

string

Lo stato del dispositivo.

I valori accettati sono:

• ACTIVE: il dispositivo è registrato nel dominio.
• DELINQUENT: la licenza annuale per il dominio è scaduta e il dispositivo non riceve più criteri e impostazioni. Quando si acquista una nuova licenza, il dispositivo torna allo stato ACTIVE.
• PRE_PROVISIONED: il dispositivo è stato registrato per la registrazione zero-touch. È possibile spostare un dispositivo PRE_PROVISIONED in un'altra unità organizzativa o eliminarlo. Al termine della registrazione il dispositivo sarà ACTIVE.
• DEPROVISIONED: il dispositivo non è più idoneo per la registrazione nel dominio. L'ordine è stato annullato. Le impostazioni del dispositivo sono state memorizzate nella cache. Se il dispositivo viene riattivato, al dispositivo appena attivato vengono applicate le impostazioni di sistema più recenti.
• DISABLED: il dispositivo è stato disattivato dall'amministratore e non può essere utilizzato.
• INACTIVE: il dispositivo non è registrato nel dominio.
• RETURN_ARRIVED: la richiesta di sostituzione di questo dispositivo è arrivata.
• RETURN_REQUESTED: è stata effettuata una richiesta di sostituzione di questo dispositivo.
• SHIPPED: il dispositivo viene spedito dall'inventario di Google. (Deprecato)
• UNKNOWN: non è possibile determinare lo stato del dispositivo.

string

La data e l'ora dell'ultima sincronizzazione del dispositivo con le impostazioni dei criteri nella Console di amministrazione. Il valore è nel formato di data e ora ISO 8601. L'ora è la data completa più ore, minuti e secondi nel modulo YYYY-MM-DDThh:mm:ssTZD. Ad esempio: 2010-04-05T17:30:04+01:00.

string

La data finale in cui il dispositivo sarà supportato. Questo vale solo per i dispositivi acquistati direttamente da Google. Il valore è nel formato di data e ora ISO 8601. L'ora è la data completa più ore, minuti e secondi nel modulo YYYY-MM-DDThh:mm:ssTZD. Ad esempio: 2010-04-05T17:30:04+01:00.

string

L'utente del dispositivo come indicato dall'amministratore. La lunghezza massima è di 100 caratteri. Sono consentiti valori vuoti.

string

L'indirizzo o la posizione del dispositivo in base a quanto indicato dall'amministratore. La lunghezza massima è di 200 caratteri. Sono consentiti valori vuoti.

string

Note su questo dispositivo aggiunte dall'amministratore. Questa proprietà può essere cercata con il parametro query del metodo list. La lunghezza massima è di 500 caratteri. Sono consentiti valori vuoti.

string

Le informazioni sul modello del dispositivo. Se il dispositivo non dispone di queste informazioni, la proprietà non è inclusa nella risposta.

string

Il codice MEID (Mobile Equipment Identifier) o l'IMEI (International Mobile Equipment Identity) della scheda mobile 3G in un dispositivo mobile. In genere, un MEID/IMEI viene utilizzato quando si aggiunge un dispositivo al piano di servizio con pagamento posticipato di un operatore wireless. Se il dispositivo non dispone di queste informazioni, la proprietà non è inclusa nella risposta. Per maggiori informazioni su come esportare un elenco MEID/IMEI, consulta la Guida per gli sviluppatori.

string

Il numero d'ordine del dispositivo. Solo i dispositivi acquistati direttamente da Google hanno un numero d'ordine.

boolean

Determina se il dispositivo rinnoverà automaticamente il supporto dopo la data di fine del supporto. Questa è una proprietà di sola lettura.

string

La versione del sistema operativo del dispositivo Chrome.

string

La versione della piattaforma del dispositivo Chrome.

string

La versione del firmware del dispositivo Chrome.

string

L'indirizzo MAC wireless del dispositivo. Se il dispositivo non dispone di queste informazioni, queste non vengono incluse nella risposta.

string

La modalità di avvio del dispositivo. I valori possibili sono:

• Verified: sul dispositivo è in esecuzione una versione valida di ChromeOS.
• Dev: l'interruttore hardware sviluppatore del dispositivo è attivo. All'avvio, il dispositivo ha una shell della riga di comando. Per un esempio di passaggio per sviluppatori, consulta le informazioni per gli sviluppatori di Chromebook.

string

La data e l'ora dell'ultima registrazione del dispositivo. Il valore è nel formato di data e ora ISO 8601. L'ora è la data completa più ore, minuti e secondi nel modulo YYYY-MM-DDThh:mm:ssTZD. Ad esempio: 2010-04-05T17:30:04+01:00. Per ulteriori informazioni sulla registrazione automatica e manuale, consulta il Centro assistenza Chrome.

string

Il tipo di risorsa. Per la risorsa Dispositivi Chrome, il valore è admin#directory#chromeosdevice.

object

Un elenco degli utenti recenti del dispositivo, in ordine decrescente, in base all'ora dell'ultimo accesso.

string

Il tipo di utente.

I valori accettati sono:

• USER_TYPE_MANAGED: l'utente è gestito dal dominio.
• USER_TYPE_UNMANAGED: l'utente non è gestito dal dominio.

string

L'indirizzo email dell'utente. È presente solo se il tipo di utente è USER_TYPE_MANAGED.

object

Un elenco di intervalli di tempo attivi (sola lettura).

integer

Durata di utilizzo in millisecondi.

string

Data di utilizzo.

string

L'indirizzo MAC del dispositivo sull'interfaccia di rete Ethernet.

string

L'identificatore della risorsa come indicato da un amministratore o specificato durante la registrazione.

string

ETag della risorsa.

object

Report sullo spazio su disco e altre informazioni sui volumi montati/connessi.

object

Volumi di dischi

string

ID volume

string (int64 format)

Spazio totale su disco [in byte]

string (int64 format)

Spazio libero su disco [in byte]

string (int64 format)

RAM totale sul dispositivo in byte

object

Report sull'utilizzo e sulla temperatura della CPU (sola lettura)

string

Data e ora in cui è stato ricevuto il report.

integer

object

Un elenco di campioni di temperatura della CPU.

integer

Temperatura in gradi Celsius.

string

Etichetta CPU

object

Informazioni sulle specifiche della CPU del dispositivo.

string

Il nome del modello CPU.

string

L'architettura della CPU.

integer

La velocità di clock massima della CPU in kHz.

object

Informazioni per le CPU logiche

integer

Frequenza massima alla quale è consentita l'esecuzione della CPU, in base al criterio.

integer

Frequenza attuale a cui è in esecuzione la CPU.

string (Duration format)

Tempo di inattività dall'ultimo avvio.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

object

Gli stati C indicano lo stato del consumo energetico della CPU. Per ulteriori informazioni, consulta la documentazione pubblicata dal produttore.

string

Nome dello stato.

string (Duration format)

Tempo trascorso nello stato dall'ultimo riavvio.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

object

Un elenco di file del dispositivo da scaricare (sola lettura)

string

Nome file

string

Tipo di file

string

URL per il download del file

string

Data e ora in cui è stato creato il file

object

Report sulle quantità di memoria RAM disponibile (sola lettura)

string

Data e ora in cui è stato ricevuto il report.

string (int64 format)

object

Contiene l'ultima rete nota (sola lettura)

string

L'indirizzo IP.

string

L'indirizzo IP della rete WAN.

string (int64 format)

(Sola lettura) Il timestamp dopo il quale il dispositivo non riceverà più aggiornamenti o assistenza di Chrome. Usa invece "autoUpdatethrough".

string

Indirizzo MAC (sola lettura) utilizzato dalla porta Ethernet interna del Chromebook e per l'interfaccia di rete di bordo (Ethernet). Il formato è di dodici (12) cifre esadecimali senza delimitatore (lettere maiuscole). Questo vale solo per alcuni dispositivi.

string

(Sola lettura) Indirizzo MAC integrato per la docking station a cui si è connesso il dispositivo. L'impostazione di fabbrica consente di impostare l'indirizzo MAC (Media Access Control) per l'utilizzo da parte di un dock. È riservato specificamente ai criteri relativi ai dispositivi pass-through MAC. Il formato è di dodici (12) cifre esadecimali senza delimitatore (lettere maiuscole). Questo vale solo per alcuni dispositivi.

string

(Sola lettura) La data di produzione del dispositivo nel formato aaaa-mm-gg.

string

Il percorso principale completo con il nome dell'unità organizzativa associato al dispositivo. I nomi dei percorsi non fanno distinzione tra maiuscole e minuscole. Se l'unità organizzativa principale è l'organizzazione di primo livello, è rappresentata da una barra (/). Questa proprietà può essere aggiornata utilizzando l'API. Per ulteriori informazioni su come creare una struttura organizzativa per il tuo dispositivo, consulta il Centro assistenza per gli amministratori.

object

Trusted Platform Module (TPM) (sola lettura)

string

Famiglia TPM. Utilizziamo la codifica di stile TPM 2.0, ad esempio:
TPM 1,2: "1,2" -> 312e3200
TPM 2,0: "2,0" -> 322e3000

string

Livello di specifica TPM. Consultare Specifiche della libreria per TPM 2.0 e Specifiche principali per TPM 1.2.

string

Codice produttore TPM.

string

Numero di modello del TPM.

string

Versione firmware TPM.

string

Informazioni specifiche del fornitore, come l'ID fornitore.

object

Un elenco di file di screenshot da scaricare. Il tipo è sempre "SCREENSHOT_FILE". (Sola lettura)

string

Nome file

string

Tipo di file

string

URL per il download del file

string

Data e ora in cui è stato creato il file

string

L'ID univoco dell'unità organizzativa. orgUnitPath è la versione leggibile di orgUnitId. Mentre orgUnitPath può cambiare rinominando un'unità organizzativa all'interno del percorso, orgUnitId non è modificabile per un'unità organizzativa. Questa proprietà può essere aggiornata utilizzando l'API. Per ulteriori informazioni su come creare una struttura organizzativa per il tuo dispositivo, consulta il Centro assistenza per gli amministratori.

object (OsUpdateStatus)

Lo stato degli aggiornamenti del sistema operativo per il dispositivo.

string

La data e l'ora della prima registrazione del dispositivo.

string

(Sola lettura) Data e ora dell'ultimo deprovisioning del dispositivo.

enum (DeprovisionReason)

(Sola lettura) Motivo del deprovisioning.

enum (DeviceLicenseType)

Solo output. Tipo di licenza del dispositivo.

object (BacklightInfo)

Solo output. Contiene informazioni sulla retroilluminazione del dispositivo.

string

Solo output. Il timestamp dopo il quale il dispositivo non riceverà più aggiornamenti o assistenza di Chrome.

boolean

Solo output. Se il dispositivo richiede o meno l'attivazione del supporto esteso.

string

Solo output. Data del dispositivo nell'ora di inizio dei criteri di supporto esteso per gli aggiornamenti automatici.

boolean

Solo output. Se i criteri di supporto esteso sono abilitati sul dispositivo.

object (FanInfo)

Solo output. Informazioni sulla ventola del dispositivo.

enum (ChromeOsType)

Solo output. Tipo di ChromeOS del dispositivo.

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

enum (UpdateState)

Lo stato di un aggiornamento del sistema operativo.

string

Nuova versione della piattaforma dell'immagine del sistema operativo che viene scaricata e applicata. È impostata solo quando lo stato dell'aggiornamento è UPDATE_STATUS_DOWNLOAD_IN_PROGRESS o UPDATE_STATUS_NEED_REBOOT. Nota che questo potrebbe essere un "0.0.0.0" fittizio per UPDATE_STATUS_NEED_REBOOT per alcuni casi limite, ad esempio il motore di aggiornamento viene riavviato senza un riavvio.

string

Nuova versione della piattaforma richiesta dall'app kiosk aggiornata in attesa.

string

Data e ora dell'ultimo aggiornamento del sistema operativo riuscito.

string

La data e l'ora dell'ultimo controllo dell'aggiornamento.

string

Data e ora dell'ultimo riavvio.

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

string

Solo output. Percorso della retroilluminazione del sistema. Utile se il chiamante deve essere correlato ad altre informazioni.

integer

Solo output. Luminosità massima per la retroilluminazione.

integer

Solo output. Luminosità corrente della retroilluminazione, compresa tra 0 e maxBrightness.

{
  "speedRpm": integer
}

integer

Solo output. Velocità della ventola in rpm.