REST Resource: customer.devices.chromeos.commands

Tài nguyên: DirectoryChromeosdevicesCommand

Thông tin liên quan đến một lệnh được phát đến 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 của lệnh.

commandExpireTime

string (Timestamp format)

Thời gian hết hạn lệnh. 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ả 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 xác định loại lệnh.
REBOOT Khởi động lại thiết bị. Có thể cấp cho các thiết bị sử dụng kiosk và phiên khách được quản lý, cũng như các thiết bị thông thường chạy ChromeOS phiên bản 113 trở lên.
TAKE_A_SCREENSHOT Chụp ảnh màn hình thiết bị. Chỉ dùng được nếu thiết bị đang ở Chế độ kiosk.
SET_VOLUME Đặt âm lượng cho thiết bị. Chỉ có thể cấp cho các thiết bị có phiên khách được quản lý và Kiosk.
WIPE_USERS Xoá sạch 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 lệnh này sẽ giữ lại chính sách thiết bị và trạng thái đăng ký.
REMOTE_POWERWASH Xóa thiết bị bằng cách rửa điện. Việc thực thi lệnh này trên 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ẽ đưa thiết bị về trạng thái ban đầu mà không có dữ liệu đăng ký, trừ phi thiết bị bị đăng ký bắt buộc hoặc tự động. Hãy thận trọng khi sử dụng vì đây là thao tác không thể huỷ được!
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 qua đường liên kết downloadUrl có trong trường deviceFiles của chromeosdevices
FETCH_SUPPORT_PACKET Tìm nạp từ xa gói hỗ trợ từ một thiết bị. 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ừ một thiết bị ChromeOS. Bạn có thể tải gói hỗ trợ xuống từ đường liên kết DownloadURL có trong trường deviceFiles của chromeosdevices

Tiểu bang

Biểu thị trạng thái của lệnh đã phát hành.

Enum
STATE_UNSPECIFIED Trạng thái của lệnh chưa được xác định.
PENDING Một lệnh chưa hết hạn chưa được gửi đến máy khách.
EXPIRED Ứng dụng không thực thi lệnh này 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 này đã được gửi đến máy khách.
ACKED_BY_CLIENT Máy khách đã phản hồi rằng máy khách đã nhận được lệnh này.
EXECUTED_BY_CLIENT Máy khách đã (không) thực thi lệnh này 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 gian thực thi lệnh hoặc không thực thi được 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".

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ực hiện được. Chỉ hiển thị nếu lệnh này không thành công.

commandResultPayload

string

Tải trọng cho kết quả lệnh. Các lệnh sau đây phản hồi bằng một tải trọng:

  • 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 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 xác định kết quả lệnh.
IGNORED Lệnh này đã bị bỏ qua do lỗi thời.
FAILURE Không thực thi được lệnh này.
SUCCESS Lệnh đã được thực thi thành công.

Phương thức

get

Lấy dữ liệu lệnh qua một lệnh cụ thể được đưa ra đến thiết bị.