REST Resource: customer.devices.chromeos.commands

Tài nguyên: DirectoryChromeosdevicesCommand

Thông tin về lệnh được đưa ra cho một thiết bị.

Biểu diễn dưới dạng JSON
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
Trường
commandId

string (int64 format)

Mã nhận dạng duy nhất của một lệnh trên thiết bị.

type

enum (CommandType)

Loại lệnh.

issueTime

string (Timestamp format)

Dấu thời gian khi quản trị viên đưa ra lệnh.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

state

enum (State)

Cho biết trạng thái lệnh.

commandExpireTime

string (Timestamp format)

Thời gian mà lệnh sẽ hết hạn. Nếu thiết bị không thực thi lệnh trong khoảng thời gian này, lệnh đó sẽ hết hạn.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

commandResult

object (DirectoryChromeosdevicesCommandResult)

Kết quả của thực thi lệnh.

payload

string

Tải trọng mà lệnh đã chỉ định, nếu có.

CommandType

Thiết lập loại lệnh mà thiết bị phải thực thi.

Enum
COMMAND_TYPE_UNSPECIFIED Chưa chỉ định loại lệnh.
REBOOT Khởi động lại thiết bị. Chỉ có thể phát hành cho Kiosk và các thiết bị có phiên khách được quản lý.
TAKE_A_SCREENSHOT Chụp ảnh màn hình thiết bị. Chỉ dùng được nếu thiết bị ở chế độ kiosk.
SET_VOLUME Đặt âm lượng cho thiết bị. Chỉ có thể phát hành cho Kiosk và các thiết bị có phiên khách được quản lý.
WIPE_USERS Xóa tất cả người dùng khỏi thiết bị. Việc thực thi lệnh này trong thiết bị sẽ xoá tất cả dữ liệu hồ sơ người dùng, nhưng vẫn giữ nguyên chính sách thiết bị và dữ liệu đăng ký.
REMOTE_POWERWASH Lau sạch thiết bị bằng cách rửa điện. Thực thi lệnh này trong thiết bị sẽ xóa tất cả dữ liệu, bao gồm cả chính sách người dùng, chính sách thiết bị và chính sách đăng ký. Cảnh báo: Thao tác này sẽ hoàn nguyên thiết bị về trạng thái ban đầu mà không có lượt đăng ký, trừ phi thiết bị buộc phải đăng ký tự động hoặc bắt buộc. Hãy thận trọng khi sử dụng vì đây là hành động không thể huỷ được sau khi thực hiện!
DEVICE_START_CRD_SESSION Bắt đầu phiên Chrome Remote Desktop.
CAPTURE_LOGS Ghi lại nhật ký hệ thống của thiết bị kiosk. Bạn có thể tải nhật ký xuống từ đường liên kết downloadUrl có trong trường deviceFiles của chromeos thiết bị
FETCH_SUPPORT_PACKET Tìm nạp gói hỗ trợ từ một thiết bị từ xa. Gói hỗ trợ là một tệp lưu trữ zip chứa nhiều nhật ký hệ thống và dữ liệu gỡ lỗi từ thiết bị ChromeOS. Bạn có thể tải gói hỗ trợ xuống từ đường liên kết downloadURL trong trường deviceFiles của chromeosdevices

Tiểu bang

Biểu thị trạng thái của lệnh đã đưa ra.

Enum
STATE_UNSPECIFIED Chưa chỉ định trạng thái lệnh.
PENDING Một lệnh chưa hết hạn chưa được gửi cho khách hàng.
EXPIRED Ứng dụng không thực thi lệnh được trong thời gian dự kiến.
CANCELLED Quản trị viên đã huỷ lệnh này khi ở trạng thái ĐANG CHỜ XỬ LÝ.
SENT_TO_CLIENT Lệnh đã được gửi đến ứng dụng.
ACKED_BY_CLIENT Ứng dụng đã phản hồi rằng đã nhận được lệnh.
EXECUTED_BY_CLIENT Máy khách đã thực thi lệnh (không) thành công.

DirectoryChromeosdevicesCommandResult

Kết quả của việc thực thi một lệnh.

Biểu diễn dưới dạng JSON
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
Trường
result

enum (CommandResultType)

Kết quả của lệnh.

executeTime

string (Timestamp format)

Thời điểm thực thi hoặc không thực thi lệnh được.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

errorMessage

string

Thông báo lỗi kèm theo nội dung giải thích ngắn gọn về lý do lệnh không thành công. Chỉ hiển thị nếu lệnh không thành công.

commandResultPayload

string

Tải trọng cho kết quả lệnh. Các lệnh sau phản hồi với một tải trọng dữ liệu:

  • DEVICE_START_CRD_SESSION: Tải trọng là một đối tượng JSON dạng chuỗi có dạng: { "url": url }. URL này cung cấp đường liên kết đến phiên Chrome Remote Desktop.

CommandResultType

Loại kết quả lệnh.

Enum
COMMAND_RESULT_TYPE_UNSPECIFIED Chưa chỉ định kết quả của lệnh.
IGNORED Lệnh này đã bị bỏ qua vì đã lỗi thời.
FAILURE Không thể thực thi thành công lệnh.
SUCCESS Lệnh đã được thực thi thành công.

Phương thức

get

Lấy dữ liệu về lệnh mà một lệnh cụ thể đưa ra cho thiết bị.