REST Resource: customer.devices.chromeos.commands

Recurso: DirectoryChromeosdevicesCommand

Información sobre un comando que se emitió a un dispositivo.

Representación JSON 
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
Campos
commandId

string (int64 format)

ID único de un comando de dispositivo.
type

enum (CommandType)

Es el tipo del comando.
issueTime

string (Timestamp format)

La marca de tiempo en la que el administrador emitió el comando.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
state

enum (State)

Indica el estado del comando.
commandExpireTime

string (Timestamp format)

La hora a la que vencerá el comando. Si el dispositivo no ejecuta el comando en ese plazo, caducará.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
commandResult

object (DirectoryChromeosdevicesCommandResult)

El resultado de la ejecución del comando.
payload

string

La carga útil que especificó el comando, si corresponde.

CommandType

Establece el tipo de comando que el dispositivo debe ejecutar.

Enumeradores
COMMAND_TYPE_UNSPECIFIED No se especificó el tipo de comando.
REBOOT Reinicia el dispositivo. Solo se puede emitir para dispositivos de kiosco y de sesión de invitado administrada.
TAKE_A_SCREENSHOT Toma una captura de pantalla del dispositivo. Solo está disponible si el dispositivo está en modo kiosco.
SET_VOLUME Establece el volumen del dispositivo. Solo se puede emitir para dispositivos de kiosco y de sesión de invitado administrada.
WIPE_USERS Limpiar a todos los usuarios del dispositivo. Si ejecutas este comando en el dispositivo, se quitarán todos los datos del perfil del usuario, pero se conservarán la política de dispositivo y la inscripción.
REMOTE_POWERWASH Limpia el dispositivo con un Powerwash. Si ejecutas este comando en el dispositivo, se quitarán todos los datos, incluidas las políticas del usuario, las políticas del dispositivo y las políticas de inscripción. Advertencia: Se restablecerá el estado de fábrica del dispositivo sin inscripción, a menos que esté sujeto a una inscripción automática o forzada. Usa esta función con cuidado, ya que es una acción irreversible.
DEVICE_START_CRD_SESSION Inicia una sesión de Escritorio remoto de Chrome.
CAPTURE_LOGS Captura los registros del sistema de un dispositivo de kiosco. Los registros se pueden descargar desde el vínculo DownloadUrl presente en el campo deviceFiles de chromeosdevices
FETCH_SUPPORT_PACKET Recupera el paquete de asistencia desde un dispositivo de forma remota. El paquete de asistencia es un archivo ZIP que contiene varios registros del sistema y datos de depuración de un dispositivo ChromeOS. Puedes descargar el paquete de asistencia desde el vínculo DownloadURL presente en el campo deviceFiles de chromeosdevices.

Estado

Representa el estado del comando emitido.

Enumeradores
STATE_UNSPECIFIED No se especificó el estado del comando.
PENDING Un comando no vencido que aún no se envió al cliente.
EXPIRED El cliente no ejecutó el comando dentro del tiempo esperado.
CANCELLED El administrador cancela el comando mientras se encuentra en el estado PENDING.
SENT_TO_CLIENT El comando se envió al cliente.
ACKED_BY_CLIENT El cliente respondió que recibió el comando.
EXECUTED_BY_CLIENT El cliente ejecutó (sin) éxito el comando.

DirectoryChromeosdevicesCommandResult

Es el resultado de la ejecución de un comando.

Representación JSON 
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
Campos
result

enum (CommandResultType)

El resultado del comando.
executeTime

string (Timestamp format)

La hora en la que el comando se ejecutó o no se pudo ejecutar.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
errorMessage

string

El mensaje de error con una breve explicación de por qué el comando falló. Solo está presente si el comando falló.
commandResultPayload

string

Es la carga útil del resultado del comando. Los siguientes comandos responden con una carga útil:

  • DEVICE_START_CRD_SESSION: La carga útil es un objeto JSON en cadena con el formato: { "url": url }. La URL proporciona un vínculo a la sesión del Escritorio remoto de Chrome.

CommandResultType

Es el tipo del resultado del comando.

Enumeradores
COMMAND_RESULT_TYPE_UNSPECIFIED El resultado del comando no se especificó.
IGNORED Se ignoró el comando y se dio de baja.
FAILURE No se pudo ejecutar correctamente el comando.
SUCCESS El comando se ejecutó correctamente.

Métodos

get

 Obtiene los datos de un comando específico emitido al dispositivo.