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)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType)
}
필드
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
(deprecated)

string (int64 format)

(읽기 전용) 이 타임스탬프가 경과하면 기기에서 Chrome 업데이트 또는 지원을 중단합니다. 'autoUpdateThrough'를 사용하세요. 하세요.

ethernetMacAddress0

string

(읽기 전용) MAC 주소입니다. Chromebook의 내부 이더넷 포트에서 사용되며 온보드 네트워크 (이더넷) 인터페이스에 사용됩니다. 형식은 구분자(대문자) 없이 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 제품군입니다. 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)

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

autoUpdateThrough

string

출력 전용입니다. 기기에서 더 이상 Chrome 업데이트 또는 지원을 받지 못하는 타임스탬프입니다.

extendedSupportEligible

boolean

출력 전용입니다. 기기에 연장 지원 선택이 필요한지 여부입니다.

extendedSupportStart

string

출력 전용입니다. 자동 업데이트 연장 지원 정책이 시작되는 기기의 날짜입니다.

extendedSupportEnabled

boolean

출력 전용입니다. 기기에서 연장 지원 정책의 사용 설정 여부입니다.

fanInfo[]

object (FanInfo)

출력 전용입니다. 기기의 팬 정보입니다.

chromeOsType

enum (ChromeOsType)

출력 전용입니다. 기기의 ChromeOS 유형입니다.

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인 경우에만 설정됩니다. 더미 '0.0.0.0'일 수 있습니다. 일부 극단적인 사례의 경우 UPDATE_STATUS_NEED_REBOOT 업데이트 엔진이 재부팅 없이 다시 시작됩니다.

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)을 받았거나 보증에 따라 고장 난 기기를 동일한 기기 모델로 교체합니다.
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 기기에 연간 키오스크 업그레이드가 있습니다.

BacklightInfo

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

JSON 표현
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
필드
path

string

출력 전용입니다. 시스템에 있는 이 백라이트의 경로입니다. 호출자가 다른 정보와 연관시켜야 할 때 유용합니다.

maxBrightness

integer

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

brightness

integer

출력 전용입니다. 백라이트의 현재 밝기로, 0에서 maxBrightness 사이입니다.

FanInfo

기기 팬에 관한 정보입니다.

JSON 표현
{
  "speedRpm": integer
}
필드
speedRpm

integer

출력 전용입니다. 팬 속도(RPM)입니다.

ChromeOsType

기기의 ChromeOS 유형입니다.

열거형
CHROME_OS_TYPE_UNSPECIFIED Chrome OS 유형이 지정되지 않았습니다.
CHROME_OS_FLEX Chrome OS 유형 Chrome OS Flex입니다.
CHROME_OS Chrome OS 유형 Chrome OS입니다.

메서드

action
(deprecated)

대신 BatchChangeChromeOsDeviceStatus를 사용합니다.

get

Chrome OS 기기의 속성을 검색합니다.

list

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

moveDevicesToOu

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

patch

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

update

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