REST Resource: customer.devices.chromeos.commands

資源:DirectoryChromeosdevicesCommand

對裝置發出指令的相關資訊。

JSON 表示法
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
欄位
commandId

string (int64 format)

裝置指令的專屬 ID。

type

enum (CommandType)

指令的類型。

issueTime

string (Timestamp format)

管理員發出指令的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

state

enum (State)

表示指令狀態。

commandExpireTime

string (Timestamp format)

指令的到期時間。如果裝置未在這段時間內執行指令,指令就會失效。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

commandResult

object (DirectoryChromeosdevicesCommandResult)

指令執行的結果。

payload

string

指定指令的酬載 (如果有的話)。

CommandType

建立裝置必須執行的指令類型。

列舉
COMMAND_TYPE_UNSPECIFIED 未指定指令類型。
REBOOT 重新啟動裝置。只能核發給資訊站和受管理的訪客工作階段裝置。
TAKE_A_SCREENSHOT 擷取裝置的螢幕截圖。裝置必須處於 Kiosk 模式,才能使用此功能。
SET_VOLUME 設定裝置音量。只能核發給資訊站和受管理的訪客工作階段裝置。
WIPE_USERS 抹除裝置上的所有使用者。在裝置上執行這個指令將會移除所有使用者個人資料,但會保留裝置政策和註冊資料。
REMOTE_POWERWASH 執行 Powerwash 以便清除裝置資料。如果在裝置上執行這個指令,系統將移除所有資料,包括使用者政策、裝置政策和註冊政策。警告:這項操作會將裝置還原為未註冊的原廠狀態,除非裝置採用強製或自動註冊機制。這項操作無法復原,請謹慎使用!
DEVICE_START_CRD_SESSION 啟動 Chrome 遠端桌面工作階段。
CAPTURE_LOGS 擷取資訊站裝置的系統記錄。您可以從 chromeosdevicesdeviceFiles 欄位中的 downloadUrl 連結中下載記錄
FETCH_SUPPORT_PACKET 從遠端從裝置擷取支援封包。支援封包是 ZIP 封存檔,內含 ChromeOS 裝置上的各種系統記錄及偵錯資料。您可以從 chromeosdevicesdeviceFiles 欄位中的 downloadURL 連結下載支援封包

代表已發出指令的狀態。

列舉
STATE_UNSPECIFIED 未指定指令狀態。
PENDING 有未過期的指令尚未傳送至用戶端。
EXPIRED 用戶端未在預期的時間內執行指令。
CANCELLED 這個指令會在 PENDING 中,由管理員取消。
SENT_TO_CLIENT 指令已傳送至用戶端。
ACKED_BY_CLIENT 用戶端已回應接收到指令。
EXECUTED_BY_CLIENT 用戶端已 (未) 成功執行指令。

DirectoryChromeosdevicesCommandResult

執行指令的結果。

JSON 表示法
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
欄位
result

enum (CommandResultType)

指令的結果。

executeTime

string (Timestamp format)

執行或無法執行指令的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

errorMessage

string

錯誤訊息中會提供指令失敗原因的簡短說明。只有在指令失敗時才會顯示。

commandResultPayload

string

指令結果的酬載。下列指令會以酬載回應:

  • DEVICE_START_CRD_SESSION:酬載是字串化的 JSON 物件,格式為:{ "url": url }。該網址會提供 Chrome 遠端桌面工作階段的連結。

CommandResultType

指令結果的類型。

列舉
COMMAND_RESULT_TYPE_UNSPECIFIED 未指定指令結果。
IGNORED 這個指令已忽略過時。
FAILURE 無法成功執行這個指令,
SUCCESS 指令已順利執行,

方法

get

取得發送給裝置的特定指令指令資料。