REST Resource: chromeosdevices

리소스: ChromeOsDevice

Chrome 기기는 Chrome OS에서 실행됩니다. 일반적인 API 작업에 관한 자세한 내용은 개발자 가이드를 참고하세요.

JSON 표현
{
  "deviceId": string,
  "serialNumber": string,
  "status": string,
  "lastSync": string,
  "supportEndDate": string,
  "annotatedUser": string,
  "annotatedLocation": string,
  "notes": string,
  "model": string,
  "meid": string,
  "orderNumber": string,
  "willAutoRenew": boolean,
  "osVersion": string,
  "platformVersion": string,
  "firmwareVersion": string,
  "macAddress": string,
  "bootMode": string,
  "lastEnrollmentTime": string,
  "kind": string,
  "recentUsers": [
    {
      "type": string,
      "email": string
    }
  ],
  "activeTimeRanges": [
    {
      "activeTime": integer,
      "date": string
    }
  ],
  "ethernetMacAddress": string,
  "annotatedAssetId": string,
  "etag": string,
  "diskVolumeReports": [
    {
      "volumeInfo": [
        {
          "volumeId": string,
          "storageTotal": string,
          "storageFree": string
        }
      ]
    }
  ],
  "systemRamTotal": string,
  "cpuStatusReports": [
    {
      "reportTime": string,
      "cpuUtilizationPercentageInfo": [
        integer
      ],
      "cpuTemperatureInfo": [
        {
          "temperature": integer,
          "label": string
        }
      ]
    }
  ],
  "cpuInfo": [
    {
      "model": string,
      "architecture": string,
      "maxClockSpeedKhz": integer,
      "logicalCpus": [
        {
          "maxScalingFrequencyKhz": integer,
          "currentScalingFrequencyKhz": integer,
          "idleDuration": string,
          "cStates": [
            {
              "displayName": string,
              "sessionDuration": string
            }
          ]
        }
      ]
    }
  ],
  "deviceFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "systemRamFreeReports": [
    {
      "reportTime": string,
      "systemRamFreeInfo": [
        string
      ]
    }
  ],
  "lastKnownNetwork": [
    {
      "ipAddress": string,
      "wanIpAddress": string
    }
  ],
  "autoUpdateExpiration": string,
  "ethernetMacAddress0": string,
  "dockMacAddress": string,
  "manufactureDate": string,
  "orgUnitPath": string,
  "tpmVersionInfo": {
    "family": string,
    "specLevel": string,
    "manufacturer": string,
    "tpmModel": string,
    "firmwareVersion": string,
    "vendorSpecific": string
  },
  "screenshotFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "orgUnitId": string,
  "osUpdateStatus": {
    object (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ]
}
입력란
deviceId

string

Chrome 기기의 고유 ID입니다.

serialNumber

string

기기가 사용 설정되었을 때 입력된 Chrome 기기 일련번호입니다. 이 값은 관리 콘솔의 Chrome OS 기기 탭에 있는 일련번호와 동일합니다.

status

string

기기의 상태입니다.

사용 가능한 값:

  • ACTIVE: 기기가 도메인에 등록되었습니다.
  • DELINQUENT: 도메인의 연간 라이선스가 만료되어 기기에 더 이상 정책 및 설정이 적용되지 않습니다. 새 라이선스를 구매하면 기기가 ACTIVE 상태로 돌아갑니다.
  • PRE_PROVISIONED: 기기가 제로터치 등록에 등록되었습니다. PRE_PROVISIONED 기기를 다른 조직 단위로 이동하거나 삭제할 수 있습니다. 등록이 완료되면 기기는 ACTIVE 상태가 됩니다.
  • DEPROVISIONED: 기기를 더 이상 도메인에 등록할 수 없습니다. 주문이 취소되었습니다. 기기의 설정이 기기에 캐시되었습니다. 기기가 다시 활성화되면 최신 시스템 설정이 새로 활성화된 기기에 적용됩니다.
  • DISABLED: 관리자가 기기를 사용 중지하여 사용할 수 없습니다.
  • INACTIVE: 기기가 도메인에 등록되지 않았습니다.
  • RETURN_ARRIVED: 기기 교체 요청이 접수되었습니다.
  • RETURN_REQUESTED: 이 기기 교체 요청이 접수되었습니다.
  • SHIPPED: 기기가 Google 인벤토리에서 발송됩니다. (지원 중단됨)
  • UNKNOWN: 기기 상태를 확인할 수 없습니다.
lastSync

string

기기가 관리 콘솔의 정책 설정과 마지막으로 동기화된 날짜 및 시간입니다. 값은 ISO 8601 날짜 및 시간 형식으로 되어 있습니다. 시간은 완전한 날짜에 시, 분, 초를 더한 형식(YYYY-MM-DDThh:mm:ssTZD 형식)입니다. 2010-04-05T17:30:04+01:00를 예로 들 수 있습니다.

supportEndDate

string

기기가 지원되는 최종 날짜입니다. 이는 Google에서 직접 구매한 기기에만 적용됩니다. 값은 ISO 8601 날짜 및 시간 형식으로 되어 있습니다. 시간은 완전한 날짜에 시, 분, 초를 더한 형식(YYYY-MM-DDThh:mm:ssTZD 형식)입니다. 2010-04-05T17:30:04+01:00를 예로 들 수 있습니다.

annotatedUser

string

관리자가 명시한 기기의 사용자입니다. 최대 길이는 100자(영문 기준)입니다. 빈 값도 허용됩니다.

annotatedLocation

string

관리자가 명시한 기기의 주소 또는 위치입니다. 최대 길이는 200자(영문 기준)입니다. 빈 값도 허용됩니다.

notes

string

관리자가 이 기기에 대한 메모를 추가했습니다. 이 속성은 list 메서드의 query 매개변수를 사용하여 검색할 수 있습니다. 최대 길이는 500자(영문 기준)입니다. 빈 값도 허용됩니다.

model

string

기기의 모델 정보입니다. 기기에 이 정보가 없으면 이 속성은 응답에 포함되지 않습니다.

meid

string

휴대기기에 있는 3G 모바일 카드의 MEID (Mobile Equipment Identifier) 또는 IMEI (International Mobile Equipment Identity)입니다. MEID/IMEI는 일반적으로 무선 이동통신사의 후불 서비스 요금제에 기기를 추가할 때 사용됩니다. 기기에 이 정보가 없으면 이 속성은 응답에 포함되지 않습니다. MEID/IMEI 목록을 내보내는 방법을 자세히 알아보려면 개발자 가이드를 참고하세요.

orderNumber

string

기기의 주문 번호입니다. Google에서 직접 구매한 기기에만 주문 번호가 있습니다.

willAutoRenew

boolean

지원 종료일 이후에 기기에서 지원을 자동으로 갱신할지 결정합니다. 읽기 전용 속성입니다.

osVersion

string

Chrome 기기의 운영체제 버전입니다.

platformVersion

string

Chrome 기기의 플랫폼 버전입니다.

firmwareVersion

string

Chrome 기기의 펌웨어 버전입니다.

macAddress

string

기기의 무선 MAC 주소입니다. 기기에 이 정보가 없으면 응답에 포함되지 않습니다.

bootMode

string

기기의 부팅 모드입니다. 사용할 수 있는 값은 다음과 같습니다.

  • Verified: 기기에서 유효한 버전의 Chrome OS를 실행하고 있습니다.
  • Dev: 기기의 개발자 하드웨어 스위치가 사용 설정되었습니다. 부팅되면 기기에는 명령줄 셸이 있습니다. 개발자 전환 예시를 보려면 Chromebook 개발자 정보를 참고하세요.
lastEnrollmentTime

string

기기가 마지막으로 등록된 날짜 및 시간입니다. 값은 ISO 8601 날짜 및 시간 형식으로 되어 있습니다. 시간은 완전한 날짜에 시, 분, 초를 더한 형식(YYYY-MM-DDThh:mm:ssTZD 형식)입니다. 2010-04-05T17:30:04+01:00를 예로 들 수 있습니다. 자동 및 수동 등록에 대한 자세한 내용은 Chrome 고객센터를 참고하세요.

kind

string

리소스 유형 Chromeosdevices 리소스의 값은 admin#directory#chromeosdevice입니다.

recentUsers[]

object

최근 로그인 시간을 기준으로 최근 기기 사용자 목록(내림차순)

recentUsers[].type

string

사용자 유형입니다.

사용 가능한 값:

  • USER_TYPE_MANAGED: 도메인에서 사용자를 관리합니다.
  • USER_TYPE_UNMANAGED: 도메인에서 관리하지 않는 사용자입니다.
recentUsers[].email

string

사용자의 이메일 주소 사용자 유형이 USER_TYPE_MANAGED인 경우에만 존재합니다.

activeTimeRanges[]

object

활성 시간 범위 목록입니다 (읽기 전용).

activeTimeRanges[].activeTime

integer

사용 기간(밀리초)입니다.

activeTimeRanges[].date

string

사용 날짜입니다.

ethernetMacAddress

string

이더넷 네트워크 인터페이스에 있는 기기의 MAC 주소입니다.

annotatedAssetId

string

관리자가 명시하거나 등록 시 지정한 자산 식별자입니다.

etag

string

리소스의 ETag입니다.

diskVolumeReports[]

object

디스크 공간 및 마운트된 볼륨/연결된 볼륨에 대한 기타 정보에 대한 보고서입니다.

diskVolumeReports[].volumeInfo[]

object

디스크 볼륨

diskVolumeReports[].volumeInfo[].volumeId

string

볼륨 ID

diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

총 디스크 공간[바이트 단위]

diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

사용 가능한 디스크 공간[바이트 단위]

systemRamTotal

string (int64 format)

기기의 총 RAM(바이트)

cpuStatusReports[]

object

CPU 사용률 및 온도 보고서 (읽기 전용)

cpuStatusReports[].reportTime

string

보고서가 수신된 날짜 및 시간입니다.

cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer

cpuStatusReports[].cpuTemperatureInfo[]

object

CPU 온도 샘플 목록입니다.

cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

섭씨 온도입니다.

cpuStatusReports[].cpuTemperatureInfo[].label

string

CPU 라벨

cpuInfo[]

object

기기의 CPU 사양 관련 정보입니다.

cpuInfo[].model

string

CPU 모델 이름입니다.

cpuInfo[].architecture

string

CPU 아키텍처

cpuInfo[].maxClockSpeedKhz

integer

최대 CPU 클록 속도(kHz)입니다.

cpuInfo[].logicalCpus[]

object

논리 CPU 정보

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

정책에 따라 CPU 실행이 허용되는 최대 빈도입니다.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

CPU가 실행되는 현재 주파수입니다.

cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

마지막 부팅 이후 유휴 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

cpuInfo[].logicalCpus[].cStates[]

object

C 상태는 CPU의 전력 소모량 상태를 나타냅니다. 자세한 내용은 CPU 제조업체에서 게시한 문서를 참조하세요.

cpuInfo[].logicalCpus[].cStates[].displayName

string

주 이름입니다.

cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

마지막 재부팅 이후 상태에서 소요된 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

deviceFiles[]

object

다운로드할 기기 파일 목록 (읽기 전용)

deviceFiles[].name

string

파일 이름

deviceFiles[].type

string

파일 형식

deviceFiles[].downloadUrl

string

파일 다운로드 URL

deviceFiles[].createTime

string

파일이 생성된 날짜 및 시간

systemRamFreeReports[]

object

사용 가능한 RAM 메모리 양 보고서 (읽기 전용)

systemRamFreeReports[].reportTime

string

보고서가 수신된 날짜 및 시간입니다.

systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)

lastKnownNetwork[]

object

마지막으로 알려진 네트워크 포함 (읽기 전용)

lastKnownNetwork[].ipAddress

string

IP 주소입니다.

lastKnownNetwork[].wanIpAddress

string

WAN IP 주소입니다.

autoUpdateExpiration

string (int64 format)

(읽기 전용) 기기에서 Chrome 업데이트 또는 지원 수신을 중지하는 타임스탬프

ethernetMacAddress0

string

Chromebook의 내부 이더넷 포트와 온보드 네트워크(이더넷) 인터페이스에서 사용하는 (읽기 전용) MAC 주소입니다. 형식은 구분자가 없는 12자리 16진수입니다(대문자). 이는 일부 기기에만 적용됩니다.

dockMacAddress

string

(읽기 전용) 기기가 연결된 도킹 스테이션의 내장 MAC 주소입니다. 팩토리에서는 도크에서 사용하도록 할당된 MAC 주소 (Media Access Control)를 설정합니다. 특히 MAC 패스 스루 기기 정책을 위해 예약되어 있습니다. 형식은 구분자가 없는 12자리 16진수입니다(대문자). 이는 일부 기기에만 적용됩니다.

manufactureDate

string

(읽기 전용) 기기 제조 날짜(yyyy-mm-dd 형식)

orgUnitPath

string

기기와 연결된 조직 단위의 이름이 있는 전체 상위 경로입니다. 경로 이름은 대소문자를 구분하지 않습니다. 상위 조직 단위가 최상위 조직인 경우 슬래시(/)로 표시됩니다. API를 사용하여 이 속성을 업데이트할 수 있습니다. 기기의 조직 구조를 만드는 방법에 관한 자세한 내용은 관리 고객센터를 참고하세요.

tpmVersionInfo

object

TPM (신뢰할 수 있는 플랫폼 모듈) (읽기 전용)

tpmVersionInfo.family

string

TPM 제품군 Google에서는 TPM 2.0 형식 인코딩을 사용합니다.예를 들면 다음과 같습니다.
TPM 1.2: '1.2' -> 312e3200
TPM 2.0: '2.0' -> 322e3000

tpmVersionInfo.specLevel

string

TPM 사양 수준입니다. TPM 2.0의 라이브러리 사양 및 TPM 1.2의 기본 사양을 참조하세요.

tpmVersionInfo.manufacturer

string

TPM 제조업체 코드입니다.

tpmVersionInfo.tpmModel

string

TPM 모델 번호입니다.

tpmVersionInfo.firmwareVersion

string

TPM 펌웨어 버전

tpmVersionInfo.vendorSpecific

string

공급업체별 정보(예: 공급업체 ID)

screenshotFiles[]

object

다운로드할 스크린샷 파일의 목록입니다. 유형은 항상 'SCREENSHOT_FILE'입니다. (읽기 전용)

screenshotFiles[].name

string

파일 이름

screenshotFiles[].type

string

파일 형식

screenshotFiles[].downloadUrl

string

파일 다운로드 URL

screenshotFiles[].createTime

string

파일이 생성된 날짜 및 시간

orgUnitId

string

조직 단위의 고유 ID입니다. orgUnitPath는 사람이 읽을 수 있는 orgUnitId 버전입니다. orgUnitPath는 경로 내의 조직 단위의 이름을 변경하여 변경될 수 있지만, orgUnitId는 하나의 조직 단위에 대해 변경할 수 없습니다. API를 사용하여 이 속성을 업데이트할 수 있습니다. 기기의 조직 구조를 만드는 방법에 관한 자세한 내용은 관리 고객센터를 참고하세요.

osUpdateStatus

object (OsUpdateStatus)

기기의 OS 업데이트 상태입니다.

firstEnrollmentTime

string

기기가 처음 등록된 날짜 및 시간입니다.

lastDeprovisionTimestamp

string

(읽기 전용) 기기의 마지막 프로비저닝 해제 날짜 및 시간입니다.

deprovisionReason

enum (DeprovisionReason)

(읽기 전용) 프로비저닝 해제 이유

deviceLicenseType

enum (DeviceLicenseType)

출력 전용. 기기 라이선스 유형입니다.

backlightInfo[]

object (BacklightInfo)

출력 전용. 기기의 백라이트 정보를 포함합니다.

OsUpdateStatus

현재 OS 업데이트 상태와 관련된 정보가 포함됩니다.

JSON 표현
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
입력란
state

enum (UpdateState)

OS 업데이트의 업데이트 상태입니다.

targetOsVersion

string

다운로드 및 적용되는 OS 이미지의 새 플랫폼 버전 업데이트 상태가 UPDATE_STATUS_DOWNLOAD_IN_PROGRESS 또는 UPDATE_STATUS_NEED_REBOOT인 경우에만 설정됩니다. 일부 특이 사례의 경우 UPDATE_STATUS_NEED_REBOOT에 대한 더미 '0.0.0.0'이 될 수 있습니다(예: 업데이트 엔진이 재부팅 없이 다시 시작됨).

targetKioskAppVersion

string

업데이트 대기 중인 키오스크 앱의 새로운 필수 플랫폼 버전

updateTime

string

OS가 마지막으로 업데이트된 날짜 및 시간입니다.

updateCheckTime

string

마지막 업데이트 확인 날짜 및 시간입니다.

rebootTime

string

마지막 재부팅 날짜 및 시간입니다.

UpdateState

OS 업데이트의 업데이트 상태입니다.

열거형
UPDATE_STATE_UNSPECIFIED 업데이트 상태가 지정되지 않았습니다.
UPDATE_STATE_NOT_STARTED 대기 중인 업데이트가 있지만 시작되지 않았습니다.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS 대기 중인 업데이트를 다운로드하는 중입니다.
UPDATE_STATE_NEED_REBOOT 기기에서 업데이트를 설치할 준비가 되었지만 재부팅해야 합니다.

DeprovisionReason

ChromeOS 기기의 프로비저닝을 해제하는 이유입니다.

열거형
DEPROVISION_REASON_UNSPECIFIED 프로비저닝 해제 이유를 알 수 없습니다.
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT 동일 모델 교체 RMA (Return Merchandise Authorization)가 있거나, 고장 난 기기를 보증에 따라 동일한 기기 모델로 교체하려고 합니다.
DEPROVISION_REASON_UPGRADE

기기가 업그레이드되었습니다.

DEPROVISION_REASON_DOMAIN_MOVE

기기의 도메인이 변경됨

DEPROVISION_REASON_SERVICE_EXPIRATION

기기의 서비스가 만료되었습니다.

DEPROVISION_REASON_OTHER

더 이상 지원되지 않는 레거시 이유로 기기의 프로비저닝이 해제되었습니다.

DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT 다른 모델 교체 이 기기를 업그레이드된 모델 또는 최신 기기 모델로 교체합니다.
DEPROVISION_REASON_RETIRING_DEVICE 요소군에서 사용 중지됩니다. 기기를 기부, 폐기 또는 처분합니다.
DEPROVISION_REASON_UPGRADE_TRANSFER ChromeOS Flex 업그레이드 이전. 1년 이내에 Chromebook으로 교체할 ChromeOS Flex 기기입니다.
DEPROVISION_REASON_NOT_REQUIRED 이유는 필요하지 않습니다. 예를 들어 라이선스가 고객의 라이선스 풀로 반환되었습니다.
DEPROVISION_REASON_REPAIR_CENTER 수리 서비스 센터에서 기기의 프로비저닝을 해제했습니다. RMA 진행 중에는 수리 서비스 센터에서만 설정할 수 있습니다.

DeviceLicenseType

이 기기의 라이선스 유형입니다.

열거형
DEVICE_LICENSE_TYPE_UNSPECIFIED 라이선스 유형을 알 수 없습니다.
ENTERPRISE 기기에는 영구 Chrome Enterprise 업그레이드가 번들로 함께 제공됩니다.
ENTERPRISE_UPGRADE 기기에 연간 독립형 Chrome Enterprise 업그레이드가 있습니다.
EDUCATION_UPGRADE 기기에는 영구 독립형 Chrome Education 업그레이드가 있습니다.
EDUCATION 기기에는 영구 Chrome Education 업그레이드가 번들로 함께 제공됩니다.
KIOSK_UPGRADE 기기에 연간 Kiosk 업그레이드가 있습니다.

BacklightInfo

기기의 백라이트에 관한 정보입니다.

JSON 표현
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
입력란
path

string

출력 전용. 시스템에 있는 이 백라이트의 경로입니다. 발신자를 다른 정보와 관련시켜야 하는 경우 유용합니다.

maxBrightness

integer

출력 전용. 백라이트의 최대 밝기입니다.

brightness

integer

출력 전용. 백라이트의 현재 밝기입니다(0~maxBrightness).

방법

action
(deprecated)

대신 BatchChangeChromeOsDeviceStatus를 사용하세요.

get

ChromeOS 기기의 속성을 검색합니다.

list

계정 내에서 페이지로 나눈 Chrome OS 기기 목록을 검색합니다.

moveDevicesToOu

조직 단위로 여러 Chrome OS 기기를 이동하거나 삽입합니다.

patch

기기의 업데이트 가능한 속성(예: annotatedUser, annotatedLocation, notes, orgUnitPath, annotatedAssetId)을 업데이트합니다.

update

기기의 업데이트 가능한 속성(예: annotatedUser, annotatedLocation, notes, orgUnitPath, annotatedAssetId)을 업데이트합니다.