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 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

state

enum (State)

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

commandExpireTime

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

commandResult

object (DirectoryChromeosdevicesCommandResult)

명령어 실행 결과입니다.

payload

string

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

CommandType

기기에서 실행해야 하는 명령 유형을 설정합니다.

열거형
COMMAND_TYPE_UNSPECIFIED 명령어 유형이 지정되지 않았습니다.
REBOOT 기기를 재부팅합니다. 키오스크 및 관리 게스트 세션 기기에만 발행할 수 있습니다.
TAKE_A_SCREENSHOT 기기의 스크린샷을 찍습니다. 기기가 키오스크 모드일 때만 사용할 수 있습니다.
SET_VOLUME 기기의 볼륨을 설정합니다. 키오스크 및 관리 게스트 세션 기기에만 발행할 수 있습니다.
WIPE_USERS 기기에서 모든 사용자를 초기화합니다. 기기에서 이 명령어를 실행하면 모든 사용자 프로필 데이터가 삭제되지만 기기 정책 및 등록은 유지됩니다.
REMOTE_POWERWASH 파워 워시를 수행하여 기기를 완전 삭제합니다. 기기에서 이 명령어를 실행하면 사용자 정책, 기기 정책, 등록 정책을 포함한 모든 데이터가 삭제됩니다. 경고: 이렇게 하면 강제 등록 또는 자동 등록 대상이 아닌 한 기기가 등록 이전의 공장 출시 상태로 되돌아갑니다. 이 작업은 되돌릴 수 없으므로 주의해서 사용하세요.
DEVICE_START_CRD_SESSION Chrome 원격 데스크톱 세션을 시작합니다.
CAPTURE_LOGS 키오스크 기기의 시스템 로그를 캡처합니다. 로그는 chromeosdevicesdeviceFiles 필드에 있는 downloadUrl 링크에서 다운로드할 수 있습니다.
FETCH_SUPPORT_PACKET 기기에서 원격으로 지원 패킷을 가져옵니다. 지원 패킷은 ChromeOS 기기의 다양한 시스템 로그 및 디버그 데이터가 포함된 ZIP 보관 파일입니다. 지원 패킷은 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 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

errorMessage

string

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

commandResultPayload

string

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

  • DEVICE_START_CRD_SESSION: 페이로드는 { "url": url } 형식의 문자열화된 JSON 객체입니다. 이 URL은 Chrome 원격 데스크톱 세션 링크를 제공합니다.

CommandResultType

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

열거형
COMMAND_RESULT_TYPE_UNSPECIFIED 명령어 결과가 지정되지 않았습니다.
IGNORED 이 명령어는 더 이상 사용되지 않으므로 무시되었습니다.
FAILURE 명령어를 실행할 수 없습니다.
SUCCESS 명령어가 성공적으로 실행되었습니다.

방법

get

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