REST Resource: chromeosdevices

{
  "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,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType)
}

string

Chrome 设备的唯一 ID。

string

启用设备时输入的 Chrome 设备序列号。此值与管理控制台 Chrome 操作系统设备标签页中的序列号相同。

string

设备的状态。

可接受的值包括：

• ACTIVE：设备已在网域中注册。
• DELINQUENT：网域的年度许可已到期，设备将无法再接收政策和设置。购买新许可后，设备会恢复为 ACTIVE 状态。
• PRE_PROVISIONED：设备已注册零触摸注册。您可以将 PRE_PROVISIONED 设备移至其他组织部门或将其删除。注册完成后，设备状态将变为ACTIVE。
• DEPROVISIONED：设备不再符合在网域中注册的条件。订单已取消。设备的设置已缓存到设备上。如果再次激活该设备，系统会将最新的系统设置应用于这台新激活的设备。
• DISABLED：设备已被管理员停用，无法使用。
• INACTIVE：设备未在网域中注册。
• RETURN_ARRIVED：我们已收到替换此设备的请求。
• RETURN_REQUESTED：已请求更换此设备。
• SHIPPED：设备由 Google 商品目录发货。（已弃用）
• UNKNOWN：无法确定设备的状态。

string

上次使用管理控制台中的政策设置同步该设备的日期和时间。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒，格式为 YYYY-MM-DDThh:mm:ssTZD。例如 2010-04-05T17:30:04+01:00。

string

支持设备的最终日期。仅适用于直接从 Google 购买的设备。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒，格式为 YYYY-MM-DDThh:mm:ssTZD。例如 2010-04-05T17:30:04+01:00。

string

管理员注明的设备用户。长度上限为 100 个字符。允许为空值。

string

管理员为该设备记录的地址或位置。长度上限为 200 个字符。允许为空值。

string

管理员添加的关于此设备的备注。您可以使用 list 方法的 query 参数搜索此属性。长度上限为 500 个字符。允许为空值。

string

设备的型号信息。如果设备没有此信息，则此属性不会包含在响应中。

string

移动设备上 3G 移动卡的移动设备标识符 (MEID) 或国际移动设备识别码 (IMEI)。将设备添加到无线运营商的后付款服务计划时，通常会用到 MEID/IMEI。如果设备没有此信息，则此属性不会包含在响应中。如需详细了解如何导出 MEID/IMEI 列表，请参阅开发者指南。

string

设备的订单号。只有直接从 Google 购买的设备才有订单号。

boolean

确定设备是否会在支持结束日期之后自动续订支持方案。这是一个只读属性。

string

Chrome 设备的操作系统版本。

string

Chrome 设备的平台版本。

string

Chrome 设备的固件版本。

string

设备的无线 MAC 地址。如果设备没有此信息，则不会包含在响应中。

string

设备的启动模式。可能的值包括：

• Verified：设备运行的是有效版本的 Chrome 操作系统。
• Dev：设备的开发者硬件开关已启用。启动时，设备将有一个命令行 shell。要查看切换开发者的示例，请参阅 Chromebook 开发者信息。

string

上次注册设备的日期和时间。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒，格式为 YYYY-MM-DDThh:mm:ssTZD。例如 2010-04-05T17:30:04+01:00。如需详细了解自动和手动注册，请参阅 Chrome 帮助中心。

string

资源的类型。对于 Chromeosdevices 资源，值为 admin#directory#chromeosdevice。

object

最近使用设备用户的列表（按上次登录时间降序排列）。

string

用户的类型。

可接受的值包括：

• USER_TYPE_MANAGED：用户由网域管理。
• USER_TYPE_UNMANAGED：用户不受网域管理。

string

用户的电子邮件地址。仅当用户类型为 USER_TYPE_MANAGED 时，此字段才会显示。

object

有效时间范围的列表（只读）。

integer

使用时长（以毫秒为单位）。

string

使用日期。

string

该设备在以太网网络接口上的 MAC 地址。

string

管理员标注或注册时指定的资产标识符。

string

资源的 ETag。

object

磁盘可用空间报告，以及装载/连接的卷相关的其他信息。

object

磁盘卷

string

卷 ID

string (int64 format)

总磁盘空间 [以字节为单位]

string (int64 format)

可用磁盘空间 [以字节为单位]

string (int64 format)

设备上的 RAM 总容量（以字节为单位）

object

CPU 利用率和温度报告（只读）

string

收到报告的日期和时间。

integer

object

CPU 温度样本列表。

integer

以摄氏度为单位的温度。

string

CPU 标签

object

有关设备 CPU 规格的信息。

string

CPU 型号名称。

string

CPU 架构。

integer

最高 CPU 时钟速度，以千赫 (kHz) 为单位。

object

逻辑 CPU 的信息

integer

根据政策，CPU 可以运行的最高频率。

integer

CPU 当前的运行频率。

string (Duration format)

自上次启动以来的空闲时间。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

object

C 状态表示 CPU 的功耗状态。如需了解详情，请参阅 CPU 制造商发布的文档。

string

州/省/自治区/直辖市的名称。

string (Duration format)

自上次重新启动以来处于该状态的时间。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

object

要下载的设备文件列表（只读）

string

文件名

string

文件类型

string

文件下载网址

string

文件的创建日期和时间

object

可用 RAM 内存量的报告（只读）

string

收到报告的日期和时间。

string (int64 format)

object

包含最后已知网络（只读）

string

IP 地址。

string

WAN IP 地址。

string (int64 format)

（只读）一个时间戳，在此时间戳过后，设备将停止接收 Chrome 更新或支持服务。请使用“autoUpdateThrough”。

string

（只读）MAC 地址，供 Chromebook 的内部以太网端口和板载网络（以太网）接口使用。格式为十二 (12) 个十六进制数字，不含任何分隔符（大写字母）。这仅与某些设备有关。

string

（只读）设备连接到的坞站的内置 MAC 地址。出厂设置分配供基座使用的媒体访问控制地址（MAC 地址）。它专用于 MAC 传递设备政策。格式为十二 (12) 个十六进制数字，不含任何分隔符（大写字母）。这仅与某些设备有关。

string

（只读）设备的制造日期，格式为 yyyy-mm-dd。

string

包含与设备相关联的组织部门名称的完整父级路径。路径名称不区分大小写。如果上级组织部门是顶级组织，则以正斜杠 / 表示。可以使用 API 更新此属性。要详细了解如何为设备创建组织结构，请访问管理帮助中心。

object

可信平台模块 (TPM)（只读）

string

TPM 系列。我们使用 TPM 2.0 样式的编码，例如：
TPM 1.2：“1.2”->312e3200
TPM 2.0：“2.0”->322E3000

string

TPM 规范级别。请参阅 TPM 2.0 的库规范和 TPM 1.2 的主要规范。

string

TPM 制造商代码。

string

TPM 型号。

string

TPM 固件版本。

string

供应商特定信息，例如供应商 ID。

object

要下载的屏幕截图文件列表。类型始终为“SCREENSHOT_FILE”。（只读）

string

文件名

string

文件类型

string

文件下载网址

string

文件的创建日期和时间

string

组织部门的唯一 ID。orgUnitPath 是人类可读的 orgUnitId 版本。虽然 orgUnitPath 可能会因重命名路径中的组织部门而发生变化，但一个组织部门的 orgUnitId 不可更改。可以使用 API 更新此属性。要详细了解如何为设备创建组织结构，请访问管理帮助中心。

object (OsUpdateStatus)

设备的操作系统更新状态。

string

首次注册设备的日期和时间。

string

（只读）上次取消配置设备的日期和时间。

enum (DeprovisionReason)

（只读）取消配置的原因。

enum (DeviceLicenseType)

仅限输出。设备许可类型。

object (BacklightInfo)

仅限输出。包含设备的背光信息。

string

仅限输出。设备将在该时间戳之后停止接收 Chrome 更新或支持服务的时间戳。

boolean

仅限输出。设备是否需要选择启用延长支持期。

string

仅限输出。设备自动更新延长支持政策生效日期。

boolean

仅限输出。是否在设备上启用了延长支持期政策。

object (FanInfo)

仅限输出。设备的风扇信息。

enum (ChromeOsType)

仅限输出。设备的 ChromeOS 类型。

{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}

enum (UpdateState)

操作系统更新的更新状态。

string

正在下载并应用的操作系统映像的新平台版本。仅当更新状态为 UPDATE_STATUS_DOWNLOAD_IN_PROGRESS 或 UPDATE_STATUS_NEED_REBOOT 时，才会设置此字段。请注意，这可能是虚拟“0.0.0.0”用于 UPDATE_STATUS_NEED_REBOOT 的一些极端情况，例如无需重新启动即可重启更新引擎。

string

待更新的自助服务终端应用的新所需平台版本。

string

上次成功更新操作系统的日期和时间。

string

上次更新检查的日期和时间。

string

上次重新启动的日期和时间。

{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}

string

仅限输出。系统上此背光的路径。如果调用方需要与其他信息相关联，此类型会非常有用。

integer

仅限输出。背光的最大亮度。

integer

仅限输出。背光的当前亮度，介于 0 和 maxBrightness 之间。

{
  "speedRpm": integer
}

integer

仅限输出。风扇转速，以每千次展示收入 (RPM) 为单位。