REST Resource: customer.devices.chromeos.commands

Risorsa: DirectoryChromeosdevicesCommand

Informazioni relative a un comando emesso su 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)

Timestamp dell'emissione del comando da parte dell'amministratore.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 in cui scadrà il comando. Se il dispositivo non esegue il comando entro questo periodo di tempo, il comando scadrà.

Un timestamp nel formato RFC3339 UTC "Zulu" 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

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 inviato ai dispositivi kiosk e alle sessioni Ospite gestite, nonché ai normali dispositivi 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 inviato solo ai dispositivi kiosk e alle sessioni Ospite gestite.
WIPE_USERS Cancellare tutti gli utenti dal dispositivo. L'esecuzione di questo comando nel dispositivo rimuoverà tutti i dati del profilo utente, ma manterrà i criteri relativi ai dispositivi e la registrazione.
REMOTE_POWERWASH Pulisce il dispositivo eseguendo un lavaggio intensivo. L'esecuzione di questo comando nel dispositivo comporterà la rimozione di tutti i dati, inclusi i criteri relativi agli utenti, i criteri relativi ai dispositivi e i criteri di registrazione. Avviso: verranno ripristinati i dati di fabbrica del dispositivo senza registrazione, a meno che il dispositivo non sia soggetto a registrazione forzata o automatica. Da utilizzare con cautela, poiché si tratta di un'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_SUPPORT_PACKET Recupera pacchetto di assistenza da un dispositivo remoto. Il pacchetto di assistenza è un archivio ZIP contenente vari log di sistema e dati di debug da 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 era specificato.
PENDING Un comando non scaduto non ancora inviato al client.
EXPIRED Il comando non è stato eseguito dal client nel tempo previsto.
CANCELLED Il comando è 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 l'esecuzione del comando non è riuscita.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 l'esecuzione del comando non è riuscita.

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 sotto forma di stringa 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 perché obsoleto.
FAILURE Impossibile eseguire il comando.
SUCCESS Il comando è stato eseguito correttamente.

Metodi

get

Recupera i dati di un comando specifico inviato al dispositivo.