REST Resource: customer.devices.chromeos.commands

Risorsa: DirectoryChromeosdevicesCommand

Informazioni relative a un comando inviato a un dispositivo.

Rappresentazione JSON 
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
Campi
commandId

string (int64 format)

ID univoco di un comando del dispositivo.
type

enum (CommandType)

Il tipo di comando.
issueTime

string (Timestamp format)

Il timestamp di emissione del comando da parte dell'amministratore.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (State)

Indica lo stato del comando.
commandExpireTime

string (Timestamp format)

L'ora in cui il comando scadrà. Se il dispositivo non esegue il comando entro questo periodo di tempo, il comando scadrà.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
commandResult

object (DirectoryChromeosdevicesCommandResult)

Il risultato dell'esecuzione del comando.
payload

string

Il payload specificato dal comando, se presente.

CommandType

Stabilisce il tipo di comando che il dispositivo deve eseguire.

Enum
COMMAND_TYPE_UNSPECIFIED Il tipo di comando non è stato specificato.
REBOOT Riavvia il dispositivo. Possono essere rilasciati a dispositivi kiosk e sessioni Ospite gestite, nonché a dispositivi normali con ChromeOS versione 113 o successive.
TAKE_A_SCREENSHOT Acquisisci uno screenshot del dispositivo. Disponibile solo se il dispositivo è in modalità kiosk.
SET_VOLUME Imposta il volume del dispositivo. Possono essere rilasciati solo a kiosk e dispositivi con sessioni Ospite gestite.
WIPE_USERS Cancella tutti gli utenti dal dispositivo. L'esecuzione di questo comando sul dispositivo rimuoverà tutti i dati dei profili utente, ma manterrà la registrazione e i criteri relativi ai dispositivi.
REMOTE_POWERWASH Cancella i dati del dispositivo eseguendo un powerwash. L'esecuzione di questo comando nel dispositivo rimuove tutti i dati, inclusi i criteri utente, i criteri relativi ai dispositivi e i criteri di registrazione. Avviso: nel dispositivo verranno ripristinate le impostazioni di fabbrica senza registrazione, a meno che il dispositivo non sia soggetto a registrazione automatica o forzata. Utilizza questa opzione con cautela, in quanto si tratta di un'azione irreversibile.
DEVICE_START_CRD_SESSION Avvia una sessione Chrome Remote Desktop.
CAPTURE_LOGS Acquisire i log di sistema di un dispositivo kiosk. I log possono essere scaricati dal link downloadUrl presente nel campo deviceFiles di chromeosdevices
FETCH_CRD_AVAILABILITY_INFO Recupera i tipi di sessioni Chrome Remote Desktop disponibili (private o condivise) che possono essere utilizzati per connettersi da remoto al dispositivo.
FETCH_SUPPORT_PACKET Recupera da remoto il pacchetto di assistenza da un dispositivo. Il pacchetto di assistenza è un archivio zip che contiene vari log di sistema e dati di debug di un dispositivo ChromeOS. Il pacchetto di assistenza può essere scaricato dal link downloadURL presente nel campo deviceFiles di chromeosdevices

Stato

Rappresenta lo stato del comando emesso.

Enum
STATE_UNSPECIFIED Lo stato del comando non è specificato.
PENDING Un comando non scaduto non ancora inviato al cliente.
EXPIRED Il comando non è stato eseguito dal client entro il tempo previsto.
CANCELLED Il comando viene annullato dall'amministratore mentre è in stato PENDING.
SENT_TO_CLIENT Il comando è stato inviato al client.
ACKED_BY_CLIENT Il client ha risposto di aver ricevuto il comando.
EXECUTED_BY_CLIENT Il client ha eseguito il comando (senza) esito positivo.

DirectoryChromeosdevicesCommandResult

Il risultato dell'esecuzione di un comando.

Rappresentazione JSON 
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
Campi
result

enum (CommandResultType)

Il risultato del comando.
executeTime

string (Timestamp format)

L'ora in cui il comando è stato eseguito o non è stato eseguito.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
errorMessage

string

Il messaggio di errore con una breve spiegazione del motivo per cui il comando non è riuscito. Presente solo se il comando non è andato a buon fine.
commandResultPayload

string

Il payload per il risultato del comando. I seguenti comandi rispondono con un payload:

  • DEVICE_START_CRD_SESSION: Il payload è un oggetto JSON convertito in stringa nel formato: { "url": url }. L'URL fornito rimanda alla sessione di Chrome Remote Desktop e richiede l'autenticazione utilizzando solo email associato all'emissione del comando.
  • FETCH_CRD_AVAILABILITY_INFO: il payload è un oggetto JSON convertito in stringa nel formato: { "deviceIdleTimeInSeconds": number, "userSessionType": string, "remoteSupportAvailability": string, "remoteAccessAvailability": string }. Il campo "remoteSupportAvailability" è impostato su "AVAILABLE" se la sessione shared CRD al dispositivo è disponibile. Il campo "remoteAccessAvailability" è impostato su "AVAILABLE" se è disponibile una sessione private CRD per il dispositivo.

CommandResultType

Il tipo di risultato del comando.

Enum
COMMAND_RESULT_TYPE_UNSPECIFIED Il risultato del comando non è stato specificato.
IGNORED Il comando è stato ignorato in quanto obsoleto.
FAILURE Impossibile eseguire il comando correttamente.
SUCCESS Il comando è stato eseguito correttamente.

Metodi

get

 Recupera i dati di un comando specifico inviato al dispositivo.