REST Resource: chromeosdevices

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Recurso: ChromeOsDevice

Los dispositivos Google Chrome se ejecutan en el Sistema operativo Chrome. Para obtener más información sobre las tareas comunes de la API, consulta la Guía para desarrolladores.

Representación JSON
{
  "deviceId": string,
  "serialNumber": string,
  "status": string,
  "lastSync": string,
  "supportEndDate": string,
  "annotatedUser": string,
  "annotatedLocation": string,
  "notes": string,
  "model": string,
  "meid": string,
  "orderNumber": string,
  "willAutoRenew": boolean,
  "osVersion": string,
  "platformVersion": string,
  "firmwareVersion": string,
  "macAddress": string,
  "bootMode": string,
  "lastEnrollmentTime": string,
  "kind": string,
  "recentUsers": [
    {
      "type": string,
      "email": string
    }
  ],
  "activeTimeRanges": [
    {
      "activeTime": integer,
      "date": string
    }
  ],
  "ethernetMacAddress": string,
  "annotatedAssetId": string,
  "etag": string,
  "diskVolumeReports": [
    {
      "volumeInfo": [
        {
          "volumeId": string,
          "storageTotal": string,
          "storageFree": string
        }
      ]
    }
  ],
  "systemRamTotal": string,
  "cpuStatusReports": [
    {
      "reportTime": string,
      "cpuUtilizationPercentageInfo": [
        integer
      ],
      "cpuTemperatureInfo": [
        {
          "temperature": integer,
          "label": string
        }
      ]
    }
  ],
  "cpuInfo": [
    {
      "model": string,
      "architecture": string,
      "maxClockSpeedKhz": integer,
      "logicalCpus": [
        {
          "maxScalingFrequencyKhz": integer,
          "currentScalingFrequencyKhz": integer,
          "idleDuration": string,
          "cStates": [
            {
              "displayName": string,
              "sessionDuration": string
            }
          ]
        }
      ]
    }
  ],
  "deviceFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "systemRamFreeReports": [
    {
      "reportTime": string,
      "systemRamFreeInfo": [
        string
      ]
    }
  ],
  "lastKnownNetwork": [
    {
      "ipAddress": string,
      "wanIpAddress": string
    }
  ],
  "autoUpdateExpiration": string,
  "ethernetMacAddress0": string,
  "dockMacAddress": string,
  "manufactureDate": string,
  "orgUnitPath": string,
  "tpmVersionInfo": {
    "family": string,
    "specLevel": string,
    "manufacturer": string,
    "tpmModel": string,
    "firmwareVersion": string,
    "vendorSpecific": string
  },
  "screenshotFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "orgUnitId": string,
  "osUpdateStatus": {
    object (OsUpdateStatus)
  },
  "firstEnrollmentTime": string
}
Campos
deviceId

string

El ID único del dispositivo Chrome.

serialNumber

string

Es el número de serie del dispositivo Chrome que se ingresó cuando se habilitó el dispositivo. Este valor es el mismo que el Número de serie de la Consola del administrador en la pestaña Dispositivos del Sistema operativo Chrome.

status

string

El estado del dispositivo.

Los valores aceptables son:

  • ACTIVE: El dispositivo está inscrito en el dominio.
  • DELINQUENT: La licencia anual del dominio venció y el dispositivo ya no recibe las políticas ni la configuración. Cuando se compra una licencia nueva, el dispositivo vuelve al estado ACTIVE.
  • PRE_PROVISIONED: Se registró el dispositivo para la inscripción automática. Un dispositivo PRE_PROVISIONED se puede mover a una unidad organizativa diferente o borrar. Una vez que se complete la inscripción, el dispositivo será ACTIVE.
  • DEPROVISIONED: El dispositivo ya no es apto para estar inscrito en el dominio. Se canceló el pedido. Se almacenó en caché la configuración del dispositivo. Si se vuelve a activar el dispositivo, se aplicará la configuración más reciente del sistema a este dispositivo recién activado.
  • DISABLED: El administrador inhabilitó el dispositivo, por lo que no se puede usar.
  • INACTIVE: El dispositivo no está inscrito en el dominio.
  • RETURN_ARRIVED: Llegó la solicitud para reemplazar este dispositivo.
  • RETURN_REQUESTED: Se realizó una solicitud para reemplazar este dispositivo.
  • SHIPPED: El dispositivo se envía desde el inventario de Google. (Obsoleta)
  • UNKNOWN: No se puede determinar el estado del dispositivo.
lastSync

string

La fecha y hora en que se sincronizó por última vez el dispositivo con la configuración de políticas de la Consola del administrador. El valor está en formato de fecha y hora ISO 8601. La hora es la fecha completa con el formato YYYY-MM-DDThh:mm:ssTZD y las horas, los minutos y los segundos. Por ejemplo, 2010-04-05T17:30:04+01:00.

supportEndDate

string

La fecha final en la que se admitirá el dispositivo. Esto solo se aplica a los dispositivos que se compran directamente en Google. El valor está en formato de fecha y hora ISO 8601. La hora es la fecha completa con el formato YYYY-MM-DDThh:mm:ssTZD y las horas, los minutos y los segundos. Por ejemplo, 2010-04-05T17:30:04+01:00.

annotatedUser

string

Indica el usuario del dispositivo, según indica el administrador. La longitud máxima es de 100 caracteres. Se permiten valores vacíos.

annotatedLocation

string

La dirección o ubicación del dispositivo según indica el administrador. La longitud máxima es de 200 caracteres. Se permiten valores vacíos.

notes

string

El administrador agregó notas sobre este dispositivo. Esta propiedad se puede buscar con el parámetro query del método list. La longitud máxima es de 500 caracteres. Se permiten valores vacíos.

model

string

La información del modelo del dispositivo. Si el dispositivo no tiene esta información, esta propiedad no se incluye en la respuesta.

meid

string

El identificador de equipo móvil (MEID) o la identidad internacional de equipo móvil (IMEI) de la tarjeta móvil 3G en un dispositivo móvil. Por lo general, los MEID y los IMEI se utilizan cuando se agrega un dispositivo al plan de servicio de pospago del proveedor de servicios inalámbricos. Si el dispositivo no tiene esta información, esta propiedad no se incluye en la respuesta. Para obtener más información sobre cómo exportar una lista de MEID/IMEI, consulta la Guía para programadores.

orderNumber

string

El número de pedido del dispositivo. Solo los dispositivos que se compraron directamente en Google tienen un número de pedido.

willAutoRenew

boolean

Determina si el dispositivo se renovará automáticamente después de la fecha de finalización. Esta es una propiedad de solo lectura.

osVersion

string

La versión del sistema operativo del dispositivo Chrome.

platformVersion

string

La versión de la plataforma del dispositivo Chrome.

firmwareVersion

string

La versión de firmware del dispositivo Chrome.

macAddress

string

La dirección MAC inalámbrica del dispositivo Si el dispositivo no tiene esta información, no se incluye en la respuesta.

bootMode

string

Es el modo de inicio del dispositivo. Los siguientes son los valores posibles:

  • Verified: El dispositivo ejecuta una versión válida del Sistema operativo Chrome.
  • Dev: Se habilitó el interruptor del hardware para desarrolladores del dispositivo. Cuando se inicia, el dispositivo tiene un shell de línea de comandos. Para ver un ejemplo de un interruptor de desarrollador, consulta la información del desarrollador de Chromebook.
lastEnrollmentTime

string

La fecha y hora en que se inscribió el dispositivo por última vez. El valor está en formato de fecha y hora ISO 8601. La hora es la fecha completa con el formato YYYY-MM-DDThh:mm:ssTZD y las horas, los minutos y los segundos. Por ejemplo, 2010-04-05T17:30:04+01:00. Para obtener más información sobre la inscripción automática y manual, consulte el Centro de ayuda de Chrome.

kind

string

El tipo de recurso. Para el recurso Chromeosdevices, el valor es admin#directory#chromeosdevice.

recentUsers[]

object

Una lista de los usuarios recientes del dispositivo, en orden descendente según la hora del último acceso.

recentUsers[].type

string

El tipo de usuario.

Los valores aceptables son:

  • USER_TYPE_MANAGED: El usuario es administrado por el dominio.
  • USER_TYPE_UNMANAGED: El usuario no es administrado por el dominio.
recentUsers[].email

string

La dirección de correo electrónico del usuario. Esto solo está presente si el tipo de usuario es USER_TYPE_MANAGED.

activeTimeRanges[]

object

Una lista de intervalos de tiempo activos (solo lectura).

activeTimeRanges[].activeTime

integer

Duración de uso en milisegundos.

activeTimeRanges[].date

string

Fecha de uso.

ethernetMacAddress

string

La dirección MAC del dispositivo en la interfaz de red Ethernet.

annotatedAssetId

string

Es el identificador de recurso que el administrador haya especificado o especificado durante la inscripción.

etag

string

ETag del recurso.

diskVolumeReports[]

object

Informes de espacio en disco y otra información sobre volúmenes activados o conectados

diskVolumeReports[].volumeInfo[]

object

Volúmenes de discos

diskVolumeReports[].volumeInfo[].volumeId

string

ID del volumen

diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Espacio total en disco [en bytes]

diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Espacio libre en disco [en bytes]

systemRamTotal

string (int64 format)

Total de RAM en el dispositivo en bytes

cpuStatusReports[]

object

Informes sobre el uso de CPU y la temperatura (solo lectura)

cpuStatusReports[].reportTime

string

Fecha y hora en que se recibió el informe.

cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer

cpuStatusReports[].cpuTemperatureInfo[]

object

Una lista de muestras de temperatura de la CPU.

cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Temperatura en grados Celsius

cpuStatusReports[].cpuTemperatureInfo[].label

string

Etiqueta de la CPU

cpuInfo[]

object

Información sobre las especificaciones de CPU en el dispositivo.

cpuInfo[].model

string

El nombre del modelo de la CPU.

cpuInfo[].architecture

string

La arquitectura de la CPU

cpuInfo[].maxClockSpeedKhz

integer

Es la velocidad máxima de CPU en kHz.

cpuInfo[].logicalCpus[]

object

Información para las CPU lógicas

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Frecuencia máxima en la que la CPU puede ejecutarse según la política.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Frecuencia actual en la que se ejecuta la CPU.

cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Tiempo de inactividad desde el último inicio.

Una duración en segundos con un máximo de 9 dígitos que finalizan en 's' Ejemplo: "3.5s".

cpuInfo[].logicalCpus[].cStates[]

object

Los estados C indican el estado de consumo de energía de la CPU. Para obtener más información, consulta la documentación publicada por el fabricante de la CPU.

cpuInfo[].logicalCpus[].cStates[].displayName

string

Nombre del estado.

cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

Tiempo transcurrido en el estado desde el último reinicio.

Una duración en segundos con un máximo de 9 dígitos que finalizan en 's' Ejemplo: "3.5s".

deviceFiles[]

object

Lista de archivos de dispositivos para descargar (solo lectura)

deviceFiles[].name

string

Nombre del archivo

deviceFiles[].type

string

Tipo de archivo

deviceFiles[].downloadUrl

string

URL de descarga del archivo

deviceFiles[].createTime

string

Fecha y hora en que se creó el archivo

systemRamFreeReports[]

object

Informes de la cantidad de memoria RAM disponible (solo lectura)

systemRamFreeReports[].reportTime

string

Fecha y hora en que se recibió el informe.

systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)

lastKnownNetwork[]

object

Contiene la última red conocida (solo lectura)

lastKnownNetwork[].ipAddress

string

La dirección IP.

lastKnownNetwork[].wanIpAddress

string

La dirección IP de WAN.

autoUpdateExpiration

string (int64 format)

(Solo lectura) La marca de tiempo después de la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome

ethernetMacAddress0

string

Dirección MAC (solo lectura) que utiliza el puerto Ethernet interno de la Chromebook y la interfaz de red integrada (Ethernet). El formato es de doce (12) dígitos hexadecimales sin delimitadores (letras mayúsculas). Esto solo es relevante para algunos dispositivos.

dockMacAddress

string

(Solo lectura) Dirección MAC integrada para la estación de conexión a la que se conectó el dispositivo. Factory configura la dirección de control de acceso a medios (dirección MAC) asignada para que la use un conector. Está reservado específicamente para las políticas de transferencia de MAC. El formato es de doce (12) dígitos hexadecimales sin delimitadores (letras mayúsculas). Esto solo es relevante para algunos dispositivos.

manufactureDate

string

(Solo lectura) Indica la fecha en la que se fabricó el dispositivo en formato aaaa-mm-dd.

orgUnitPath

string

La ruta de acceso completa con el nombre de la unidad organizativa asociada al dispositivo. Los nombres de ruta no distinguen entre mayúsculas y minúsculas. Si la unidad organizativa superior es la organización de nivel superior, se representa como una barra diagonal, /. Esta propiedad se puede actualizar con la API. Si desea obtener más información sobre cómo crear una estructura organizativa para su dispositivo, consulte el Centro de ayuda para la administración.

tpmVersionInfo

object

Módulo de plataforma de confianza (TPM) (solo lectura)

tpmVersionInfo.family

string

Familia TPM. Usamos la codificación de estilo TPM 2.0, p.ej.:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000

tpmVersionInfo.specLevel

string

Nivel de especificación del TPM. Consulta la Especificación de biblioteca para TPM 2.0 y la Especificación principal para TPM 1.2.

tpmVersionInfo.manufacturer

string

Código del fabricante del TPM.

tpmVersionInfo.tpmModel

string

Número de modelo TPM

tpmVersionInfo.firmwareVersion

string

Versión de firmware TPM.

tpmVersionInfo.vendorSpecific

string

Información específica del proveedor, como el ID del proveedor

screenshotFiles[]

object

Una lista de archivos de captura de pantalla para descargar. El tipo siempre es "SCREENSHOT_FILE". (solo lectura)

screenshotFiles[].name

string

Nombre del archivo

screenshotFiles[].type

string

Tipo de archivo

screenshotFiles[].downloadUrl

string

URL de descarga del archivo

screenshotFiles[].createTime

string

Fecha y hora en que se creó el archivo

orgUnitId

string

El ID único de la unidad organizativa. orgUnitPath es la versión legible de orgUnitId. Si bien orgUnitPath puede cambiarse si se cambia el nombre de una unidad organizativa dentro de la ruta, orgUnitId no se puede cambiar para una unidad organizativa. Esta propiedad se puede actualizar con la API. Si desea obtener más información sobre cómo crear una estructura organizativa para su dispositivo, consulte el Centro de ayuda para la administración.

osUpdateStatus

object (OsUpdateStatus)

Es el estado de las actualizaciones del SO del dispositivo.

firstEnrollmentTime

string

Fecha y hora de la primera vez que se registró el dispositivo.

Estado del OsUpdate

Contiene información sobre el estado actual de la actualización del SO.

Representación JSON
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Campos
state

enum (UpdateState)

El estado de actualización de una actualización del SO.

targetOsVersion

string

Se está descargando y aplicando la nueva versión de la plataforma de la imagen de SO. Solo se establece cuando el estado de actualización es UPDATE_STATUS_DOWNLOAD_IN_PROGRESS o UPDATE_STATUS_NEED_REBOOT. Ten en cuenta que podría ser un “dummy 0.0.0.0” para UPDATE_STATUS_NEED_REBOOT en algunos casos extremos, p.ej., el motor de actualización se reinicia sin un reinicio.

targetKioskAppVersion

string

Nueva versión obligatoria de la plataforma de la app de kiosco actualizada y pendiente.

updateTime

string

Fecha y hora de la última actualización exitosa del SO

updateCheckTime

string

Fecha y hora de la última verificación de actualizaciones

rebootTime

string

Fecha y hora del último reinicio.

Actualizar estado

El estado de actualización de una actualización del SO.

Enumeradores
UPDATE_STATE_UNSPECIFIED El estado de la actualización no está especificado.
UPDATE_STATE_NOT_STARTED Hay una actualización pendiente, pero todavía no comenzó.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS Se está descargando la actualización pendiente.
UPDATE_STATE_NEED_REBOOT El dispositivo está listo para instalar la actualización, pero debe reiniciarse.

Métodos

action

Realiza una acción que afecta a un dispositivo con Sistema operativo Chrome.

get

Recupera las propiedades de un dispositivo con Sistema operativo Chrome.

list

Recupera una lista paginada de dispositivos con Chrome OS en una cuenta.

moveDevicesToOu

Mueve o inserta varios dispositivos con Sistema operativo Chrome a una unidad organizativa.

patch

Actualiza las propiedades actualizables de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.

update

Actualiza las propiedades actualizables de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.