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

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 di scadenza del comando. Se il dispositivo non esegue il comando entro questo periodo di tempo, il comando scadrà.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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. Può essere emesso per i dispositivi kiosk e con sessioni Ospite gestite, nonché per i dispositivi normali con ChromeOS 113 o versioni successive.
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 emesso solo per i dispositivi kiosk e con sessioni Ospite gestite.
WIPE_USERS Cancella tutti gli utenti dal dispositivo. L'esecuzione di questo comando nel dispositivo rimuoverà tutti i dati del profilo utente, ma manterrà i criteri e la registrazione relativi al dispositivo.
REMOTE_POWERWASH Cancella i dati del dispositivo eseguendo un reset dei dati di fabbrica. L'esecuzione di questo comando nel dispositivo rimuoverà 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 forzata o automatica. Da usare con cautela, poiché questa azione è irreversibile.
DEVICE_START_CRD_SESSION Avvia una sessione di 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_CRD_AVAILABILITY_INFO Recupera le informazioni che determinano la disponibilità di CRD (Chrome Remote Desktop) sul dispositivo.
FETCH_SUPPORT_PACKET Recuperare il pacchetto di assistenza 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 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 è 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 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 (o meno) 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.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 con stringa nel formato: { "url": url }. L'URL fornisce un link alla sessione di 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 in quanto obsoleto.
FAILURE Impossibile eseguire correttamente il comando.
SUCCESS Il comando è stato eseguito correttamente.

Metodi

get

 Recupera i dati di un comando specifico inviato al dispositivo.