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)

관리자가 명령어를 실행한 시점의 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
state

enum (State)

명령어 상태를 나타냅니다.
commandExpireTime

string (Timestamp format)

명령어가 만료되는 시간입니다. 이 시간 내에 기기에서 명령어를 실행하지 않으면 명령어는 만료됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
commandResult

object (DirectoryChromeosdevicesCommandResult)

명령어 실행 결과입니다.
payload

string

명령어에서 지정한 페이로드입니다(있는 경우).

CommandType

기기가 실행해야 하는 명령어의 유형을 설정합니다.

열거형
COMMAND_TYPE_UNSPECIFIED 명령 유형이 지정되지 않았습니다.
REBOOT 기기를 재부팅합니다. ChromeOS 버전 113 이상을 실행하는 키오스크 및 관리 게스트 세션 기기, 일반 기기에 발급할 수 있습니다.
TAKE_A_SCREENSHOT 기기의 스크린샷을 찍습니다. 기기가 키오스크 모드인 경우에만 사용할 수 있습니다.
SET_VOLUME 기기의 볼륨을 설정합니다. 키오스크 및 관리 게스트 세션 기기에만 발급할 수 있습니다.
WIPE_USERS 기기에서 모든 사용자를 삭제합니다. 기기에서 이 명령어를 실행하면 모든 사용자 프로필 데이터가 삭제되지만 기기 정책 및 등록은 유지됩니다.
REMOTE_POWERWASH 파워 워시를 실행하여 기기를 초기화합니다. 기기에서 이 명령어를 실행하면 사용자 정책, 기기 정책, 등록 정책을 비롯한 모든 데이터가 삭제됩니다. 경고: 기기가 강제 또는 자동 등록 대상이 아닌 경우 기기가 등록되지 않은 공장 상태로 되돌아갑니다. 되돌릴 수 없는 작업이므로 주의해서 사용하세요.
DEVICE_START_CRD_SESSION Chrome 원격 데스크톱 세션을 시작합니다.
CAPTURE_LOGS 키오스크 기기의 시스템 로그를 캡처합니다. 로그는 chromeosdevices의 deviceFiles 필드에 있는 downloadUrl 링크에서 다운로드할 수 있습니다.
FETCH_CRD_AVAILABILITY_INFO 기기에 원격으로 연결하는 데 사용할 수 있는 Chrome 원격 데스크톱 세션의 사용 가능한 유형(비공개 또는 공유)을 가져옵니다.
FETCH_SUPPORT_PACKET 기기에서 지원 패킷을 원격으로 가져옵니다. 지원 패킷은 ChromeOS 기기의 다양한 시스템 로그와 디버그 데이터가 포함된 zip 보관 파일입니다. 지원 패킷은 chromeosdevices의 deviceFiles 필드에 있는 downloadURL 링크에서 다운로드할 수 있습니다.

주

발급된 명령어의 상태를 나타냅니다.

열거형
STATE_UNSPECIFIED 명령어 상태가 지정되지 않았습니다.
PENDING 만료되지 않았으며 아직 클라이언트에 전송되지 않은 명령어입니다.
EXPIRED 클라이언트가 예상 시간 내에 명령어를 실행하지 않았습니다.
CANCELLED 대기 중인 동안 관리자가 명령어를 취소했습니다.
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)

명령어가 실행되었거나 실행되지 않은 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
errorMessage

string

명령어가 실패한 이유에 대한 간단한 설명이 포함된 오류 메시지입니다. 명령어가 실패한 경우에만 표시됩니다.
commandResultPayload

string

명령어 결과의 페이로드입니다. 다음 명령어는 페이로드로 응답합니다.

  • DEVICE_START_CRD_SESSION: 페이로드는 { 'url': url } 형식의 문자열화된 JSON 객체입니다. 제공된 URL은 Chrome 원격 데스크톱 세션으로 연결되며 명령 발급과 연결된 email만 사용하여 인증해야 합니다.
  • FETCH_CRD_AVAILABILITY_INFO: 페이로드는 { "deviceIdleTimeInSeconds": number, "userSessionType": string, "remoteSupportAvailability": string, "remoteAccessAvailability": string } 형식의 문자열화된 JSON 객체입니다. 기기에 대한 shared CRD 세션을 사용할 수 있는 경우 'remoteSupportAvailability' 필드가 'AVAILABLE'로 설정됩니다. 기기에 대한 private CRD 세션을 사용할 수 있는 경우 'remoteAccessAvailability' 필드가 'AVAILABLE'로 설정됩니다.

CommandResultType

명령어 결과의 유형입니다.

열거형
COMMAND_RESULT_TYPE_UNSPECIFIED 명령어 결과가 지정되지 않았습니다.
IGNORED 이 명령어는 지원 중단되어 무시되었습니다.
FAILURE 명령어를 실행할 수 없습니다.
SUCCESS 명령어가 실행되었습니다.

메서드

get

 기기에 실행된 특정 명령어의 명령어 데이터를 가져옵니다.