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)
}

string

Chrome 裝置的專屬 ID。

string

啟用裝置時所輸入的 Chrome 裝置序號。這個值與管理控制台中「Chrome OS 裝置」分頁的「序號」相同。

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 行動卡的行動裝置設備 ID (MEID) 或國際行動裝置識別碼 (IMEI)。MEID/IMEI 通常用於將裝置新增至無線電信業者的後付方案後。如果裝置沒有這項資訊，回應中就不會包含這個屬性。如要進一步瞭解如何匯出 MEID/IMEI 清單，請參閱開發人員指南。

string

裝置的訂單號碼。只有直接向 Google 購買的裝置才會顯示訂單號碼。

boolean

用於決定裝置會在支援結束日期後自動續約。此為唯讀屬性。

string

Chrome 裝置的作業系統版本。

string

Chrome 裝置的平台版本。

string

Chrome 裝置的韌體版本。

string

裝置的無線 MAC 位址。如果裝置沒有這項資訊，回應中就不會包含這項資訊。

string

裝置的啟動模式。可能的值包括：

• Verified：裝置執行的是有效的 Chrome OS 版本。
• Dev：已啟用裝置的開發人員硬體切換按鈕。裝置在啟動時會啟動指令列殼層。如需開發人員開關的範例，請參閱 Chromebook 開發人員資訊。

string

裝置上次註冊的日期和時間。格式為 ISO 8601 日期和時間格式。時間是完整日期加上時、分、秒 (格式為 YYYY-MM-DDThh:mm:ssTZD)。例如 2010-04-05T17:30:04+01:00。如要進一步瞭解自動和手動註冊，請造訪 Chrome 說明中心。

string

資源類型。Chrome OS 裝置的值為 admin#directory#chromeosdevice。

object

依最近登入時間遞減排序裝置裝置清單。

string

使用者類型。

可接受的值如下：

• USER_TYPE_MANAGED：使用者由網域管理。
• USER_TYPE_UNMANAGED：使用者並非由網域管理。

string

使用者的電子郵件地址。只有在使用者類型為 USER_TYPE_MANAGED 時，系統才會顯示這項資訊。

object

有效時間範圍清單 (唯讀)。

integer

使用時間長度，以毫秒為單位。

string

使用日期。

string

乙太網路網路介面上的 MAC 位址。

string

管理員指定或資產註冊時指定的資產 ID。

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

最大 kHz 的 CPU 時脈速度速度。

object

邏輯 CPU 相關資訊

integer

依政策允許 CPU 執行頻率上限。

integer

CPU 執行目前的頻率。

string (Duration format)

上次啟動後閒置的時間。

效期以秒為單位，最多 9 個小數位數，結尾為「s」。例如："3.5s"。

object

C-State 表示 CPU 的耗電量。如要進一步瞭解 CPU 製造商發布的說明文件，

string

州/省的名稱。

string (Duration format)

上次重新啟動後狀態停留的時間。

效期以秒為單位，最多 9 個小數位數，結尾為「s」。例如："3.5s"。

object

要下載的裝置檔案清單 (唯讀)

string

「File name」

string

檔案類型

string

檔案下載網址

string

檔案的建立日期和時間

object

可用 RAM 記憶體容量的報表 (唯讀)

string

收到報告的日期和時間。

string (int64 format)

object

包含最後已知網路 (唯讀)

string

IP 位址。

string

WAN IP 位址。

string (int64 format)

(唯讀) 裝置將停止接收 Chrome 更新或支援的時間戳記

string

(唯讀) Chromebook 內部乙太網路通訊埠和新手上路網路 (乙太網路) 介面使用的 MAC 位址。格式為 12 (12) 十六進位數字，不含任何分隔符號 (大寫字母)。這項做法僅適用於部分裝置。

string

(唯讀) 裝置插入座架所在的 MAC 位址。恢復原廠設定會將媒體存取控制位址 (MAC 位址) 指派給 Dock 使用。專為 MAC 位址傳遞裝置政策而專門保留。格式為 12 (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

「File name」

string

檔案類型

string

檔案下載網址

string

檔案的建立日期和時間

string

機構單位的專屬 ID。orgUnitPath 是使用者可理解的 orgUnitId 版本。雖然 orgUnitPath 可以重新命名路徑中的機構單位，但某個機構單位無法變更 orgUnitId。您可以使用 API 更新這個屬性。如要進一步瞭解如何為裝置建立機構架構，請參閱管理說明中心。

object (OsUpdateStatus)

OS 裝置狀態的狀態。

string

裝置首次註冊的日期和時間。

string

(唯讀) 裝置上次取消佈建的時間。

enum (DeprovisionReason)

(唯讀) 取消佈建原因。

enum (DeviceLicenseType)

僅供輸出。裝置授權類型。

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

enum (UpdateState)

OS 更新的更新狀態。

string

下載及套用新的 OS 映像檔版本。只有在更新狀態為 UPDATE_STATUS_UPLOAD_IN_PROGRESS 或 UPDATE_STATUS_NEED_REBOOT 時，系統才會設定此參數。請注意，如果是某些更新案例，情況可能為 UPDATE_STATUS_NEED_REBOOT 的虛擬版「0.0.0.0」。舉例來說，系統會在不重新啟動的情況下重新啟動更新引擎。

string

從待處理更新資訊站應用程式所需的新平台版本。

string

上次成功 OS 更新的日期和時間。

string

上次更新檢查的日期和時間。

string

上次重新啟動的日期和時間。