REST Resource: customer.devices.chromeos.commands

Recurso: DirectoryChromeosdevicesCommand

Informações relacionadas a um comando emitido para um dispositivo.

Representação JSON
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
Campos
commandId

string (int64 format)

ID exclusivo de um comando do dispositivo.

type

enum (CommandType)

O tipo do comando.

issueTime

string (Timestamp format)

O carimbo de data/hora em que o comando foi emitido pelo administrador.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Indica o estado do comando.

commandExpireTime

string (Timestamp format)

A hora em que o comando vai expirar. Se o dispositivo não executar o comando dentro desse período, ele vai expirar.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

commandResult

object (DirectoryChromeosdevicesCommandResult)

O resultado da execução do comando.

payload

string

O payload especificado pelo comando, se houver.

CommandType

Estabelece o tipo de comando que o dispositivo precisa executar.

Enums
COMMAND_TYPE_UNSPECIFIED O tipo de comando não foi especificado.
REBOOT Reinicialize o dispositivo. Só pode ser emitida para dispositivos de quiosque e Sessão de visitante gerenciada.
TAKE_A_SCREENSHOT Faça uma captura de tela do dispositivo. Disponível apenas se o dispositivo estiver no modo quiosque.
SET_VOLUME Define o volume do dispositivo. Só pode ser emitida para dispositivos de quiosque e Sessão de visitante gerenciada.
WIPE_USERS Apague todos os usuários do dispositivo. Executar esse comando no dispositivo remove todos os dados do perfil do usuário, mas mantém a política e o registro do dispositivo.
REMOTE_POWERWASH Limpa o dispositivo executando um Power wash. Ao executar este comando no dispositivo, todos os dados serão removidos, incluindo as políticas do usuário, do dispositivo e de registro. Aviso: a configuração original do dispositivo será restaurada sem o registro, a menos que ele esteja sujeito ao registro forçado ou automático. Use com cautela, pois essa ação é irreversível.
DEVICE_START_CRD_SESSION Inicia uma sessão da Área de trabalho remota do Google Chrome.
CAPTURE_LOGS Capture os registros do sistema de um dispositivo de quiosque. É possível fazer o download dos registros no link downloadUrl, presente no campo deviceFiles do chromeosdevices
FETCH_SUPPORT_PACKET Busque remotamente o pacote de suporte de um dispositivo. O pacote de suporte é um arquivo ZIP que contém vários registros do sistema e dados de depuração de um dispositivo ChromeOS. É possível fazer o download do pacote de suporte no link downloadURL presente no campo deviceFiles do chromeosdevices

Estado

Representa o estado do comando emitido.

Enums
STATE_UNSPECIFIED O status do comando não foi especificado.
PENDING Um comando não expirado ainda não enviado ao cliente.
EXPIRED O comando não foi executado pelo cliente dentro do tempo esperado.
CANCELLED O comando é cancelado pelo administrador enquanto está em PENDING.
SENT_TO_CLIENT O comando foi enviado ao cliente.
ACKED_BY_CLIENT O cliente respondeu que recebeu o comando.
EXECUTED_BY_CLIENT O cliente executou o comando com sucesso.

DirectoryChromeosdevicesCommandResult

O resultado da execução de um comando.

Representação JSON
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
Campos
result

enum (CommandResultType)

O resultado do comando.

executeTime

string (Timestamp format)

A hora em que o comando foi executado ou falhou na execução.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

errorMessage

string

A mensagem de erro com uma breve explicação do motivo da falha no comando. Presente apenas se o comando falhar.

commandResultPayload

string

O payload do resultado do comando. Os comandos a seguir respondem com um payload:

  • DEVICE_START_CRD_SESSION: o payload é um objeto JSON com string no formato: { "url": url }. O URL fornece um link para a sessão da Área de trabalho remota do Google Chrome.

CommandResultType

O tipo de resultado do comando.

Enums
COMMAND_RESULT_TYPE_UNSPECIFIED O resultado do comando não foi especificado.
IGNORED O comando foi ignorado como obsoleto.
FAILURE Não foi possível executar o comando.
SUCCESS O comando foi executado.

Métodos

get

Recebe dados de comando que um comando específico emitiu para o dispositivo.