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 in cui il comando è stato emesso dall'amministratore.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
state

enum (State)

Indica lo stato del comando.
commandExpireTime

string (Timestamp format)

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

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
commandResult

object (DirectoryChromeosdevicesCommandResult)

Il risultato dell'esecuzione del comando.
payload

string

L'eventuale payload specificato dal comando.

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. Può essere inviato solo a dispositivi kiosk e sessioni Ospite gestite.
TAKE_A_SCREENSHOT Acquisisci uno screenshot del dispositivo. Disponibile solo se il dispositivo è in modalità kiosk.
SET_VOLUME Imposta il volume del dispositivo. Può essere inviato solo a dispositivi kiosk e sessioni Ospite gestite.
WIPE_USERS Cancellare tutti gli utenti dal dispositivo. L'esecuzione di questo comando nel dispositivo comporterà la rimozione di tutti i dati del profilo utente, ma i criteri e la registrazione relativi ai dispositivi verranno conservati.
REMOTE_POWERWASH Cancella il dispositivo eseguendo un Powerwash. L'esecuzione di questo comando nel dispositivo comporterà la rimozione di tutti i dati, inclusi i criteri relativi agli utenti, ai dispositivi e ai criteri di registrazione. Avviso: il dispositivo verrà ripristinato allo stato di fabbrica senza registrazione, a meno che il dispositivo non sia soggetto a registrazione forzata o automatica. Da usare con cautela, poiché questa azione è irreversibile.
DEVICE_START_CRD_SESSION Avvia una sessione Chrome Remote Desktop.
CAPTURE_LOGS Acquisisci i log di sistema di un dispositivo kiosk. I log possono essere scaricati dal link downloadUrl presente nel campo deviceFiles di chromeosdevices
FETCH_SUPPORT_PACKET Recupera il pacchetto di supporto da un dispositivo da remoto. Il pacchetto di assistenza è un archivio ZIP che contiene vari log di sistema e dati di debug di un dispositivo ChromeOS. Il pacchetto di supporto 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 è stato specificato.
PENDING Un comando non scaduto non ancora inviato al client.
EXPIRED Il comando non è stato eseguito dal client entro il tempo previsto.
CANCELLED Il comando è stato annullato dall'amministratore mentre è IN ATTESA.
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 (non) correttamente il comando.

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.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
errorMessage

string

Il messaggio di errore con una breve spiegazione del motivo per cui il comando non è riuscito. È presente solo se il comando non è riuscito.
commandResultPayload

string

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

  • DEVICE_START_CRD_SESSION: il payload è un oggetto JSON stringato nel formato { "url": url }. L'URL fornisce un link alla sessione Chrome Remote Desktop.

CommandResultType

Il tipo di risultato del comando.

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

Metodi

get

 Recupera i dati di un comando specifico inviato al dispositivo.