리소스: ChromeOsDevice
Google Chrome 기기는 ChromeOS에서 실행됩니다. 일반적인 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 ( |
필드 | |
---|---|
deviceId |
Chrome 기기의 고유 ID입니다. |
serialNumber |
기기를 사용 설정할 때 입력한 Chrome 기기 일련번호입니다. 이 값은 관리 콘솔의 ChromeOS 기기 탭에 있는 일련번호와 동일합니다. |
status |
기기의 상태입니다. 사용 가능한 값:
|
lastSync |
기기를 관리 콘솔의 정책 설정과 마지막으로 동기화한 날짜와 시간입니다. 값은 ISO 8601 날짜 및 시간 형식입니다. 시간은 |
supportEndDate |
기기가 지원되는 최종 날짜입니다. 이는 Google에서 직접 구매한 기기에만 적용됩니다. 값은 ISO 8601 날짜 및 시간 형식입니다. 시간은 |
annotatedUser |
관리자가 기기 사용자에게 추가한 메모입니다. 최대 길이는 100자(영문 기준)입니다. 빈 값을 사용할 수 있습니다. |
annotatedLocation |
관리자가 기기의 주소 또는 위치에 주석을 추가했습니다. 최대 길이는 |
notes |
관리자가 이 기기에 추가한 메모입니다. 이 속성은 list 메서드의 |
model |
기기의 모델 정보입니다. 기기에 이 정보가 없으면 이 속성이 응답에 포함되지 않습니다. |
meid |
휴대기기의 3G 모바일 카드의 휴대기기 식별자 (MEID) 또는 국제 모바일 기기 식별 번호 (IMEI)입니다. MEID/IMEI는 일반적으로 이동통신사의 포스트페이 서비스 요금제에 기기를 추가할 때 사용됩니다. 기기에 이 정보가 없으면 이 속성이 응답에 포함되지 않습니다. MEID/IMEI 목록을 내보내는 방법에 관한 자세한 내용은 개발자 가이드를 참고하세요. |
orderNumber |
기기의 주문 번호입니다. Google에서 직접 구매한 기기에만 주문 번호가 있습니다. |
willAutoRenew |
지원 종료일 후 기기의 지원이 자동으로 갱신되는지 여부를 결정합니다. 읽기 전용 속성입니다. |
osVersion |
Chrome 기기의 운영체제 버전입니다. |
platformVersion |
Chrome 기기의 플랫폼 버전입니다. |
firmwareVersion |
Chrome 기기의 펌웨어 버전입니다. |
macAddress |
기기의 무선 MAC 주소입니다. 기기에 이 정보가 없으면 응답에 포함되지 않습니다. |
bootMode |
기기의 부팅 모드입니다. 사용할 수 있는 값은 다음과 같습니다.
|
lastEnrollmentTime |
기기가 마지막으로 등록된 날짜 및 시간입니다. 값은 ISO 8601 날짜 및 시간 형식입니다. 시간은 |
kind |
리소스 유형 Chromeosdevices 리소스의 경우 값은 |
recentUsers[] |
최근 기기 사용자 목록으로, 마지막 로그인 시간별로 내림차순으로 표시됩니다. |
recentUsers[].type |
사용자 유형입니다. 사용 가능한 값:
|
recentUsers[].email |
사용자의 이메일 주소 사용자 유형이 |
activeTimeRanges[] |
활성 시간 범위 목록 (읽기 전용) |
activeTimeRanges[].activeTime |
사용 시간(밀리초)입니다. |
activeTimeRanges[].date |
사용 날짜입니다. |
ethernetMacAddress |
이더넷 네트워크 인터페이스의 기기 MAC 주소입니다. |
annotatedAssetId |
관리자가 주석 처리하거나 등록 시 지정한 자산 식별자입니다. |
etag |
리소스의 ETag입니다. |
diskVolumeReports[] |
마운트된/연결된 볼륨에 관한 디스크 공간 및 기타 정보에 관한 보고서입니다. |
diskVolumeReports[].volumeInfo[] |
디스크 볼륨 |
diskVolumeReports[].volumeInfo[].volumeId |
볼륨 ID |
diskVolumeReports[].volumeInfo[].storageTotal |
총 디스크 공간[바이트] |
diskVolumeReports[].volumeInfo[].storageFree |
디스크 여유 공간[바이트] |
systemRamTotal |
기기의 총 RAM(단위: 바이트) |
cpuStatusReports[] |
CPU 사용률 및 온도 보고서 (읽기 전용) |
cpuStatusReports[].reportTime |
신고가 접수된 날짜 및 시간입니다. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
CPU 온도 샘플 목록입니다. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
온도(섭씨) |
cpuStatusReports[].cpuTemperatureInfo[].label |
CPU 라벨 |
cpuInfo[] |
기기의 CPU 사양에 관한 정보입니다. |
cpuInfo[].model |
CPU 모델 이름입니다. |
cpuInfo[].architecture |
CPU 아키텍처입니다. |
cpuInfo[].maxClockSpeedKhz |
최대 CPU 클록 속도(kHz)입니다. |
cpuInfo[].logicalCpus[] |
논리적 CPU 정보 |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
정책에 따라 CPU가 실행될 수 있는 최대 주파수입니다. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
CPU가 실행 중인 현재 주파수입니다. |
cpuInfo[].logicalCpus[].idleDuration |
마지막 부팅 이후 유휴 시간입니다. 소수점 아래가 최대 9자리까지이고 ' |
cpuInfo[].logicalCpus[].cStates[] |
C-상태는 CPU의 전원 소비 상태를 나타냅니다. 자세한 내용은 CPU 제조업체에서 게시한 문서를 참고하세요. |
cpuInfo[].logicalCpus[].cStates[].displayName |
주 이름입니다. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
마지막 재부팅 이후 이 상태에서 보낸 시간입니다. 소수점 아래가 최대 9자리까지이고 ' |
deviceFiles[] |
다운로드할 기기 파일 목록입니다 (읽기 전용). |
deviceFiles[].name |
파일 이름 |
deviceFiles[].type |
파일 형식 |
deviceFiles[].downloadUrl |
파일 다운로드 URL |
deviceFiles[].createTime |
파일이 생성된 날짜 및 시간 |
systemRamFreeReports[] |
사용 가능한 RAM 메모리 양에 관한 보고서 (읽기 전용) |
systemRamFreeReports[].reportTime |
신고가 접수된 날짜 및 시간입니다. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
마지막으로 알려진 네트워크를 포함합니다 (읽기 전용). |
lastKnownNetwork[].ipAddress |
IP 주소 |
lastKnownNetwork[].wanIpAddress |
WAN IP 주소입니다. |
autoUpdateExpiration |
(읽기 전용) 기기에서 Chrome 업데이트 또는 지원을 더 이상 받지 않는 시점의 타임스탬프입니다. 대신 'autoUpdateThrough'를 사용하세요. |
ethernetMacAddress0 |
(읽기 전용) Chromebook의 내부 이더넷 포트 및 온보드 네트워크 (이더넷) 인터페이스에 사용되는 MAC 주소입니다. 형식은 구분자(대문자) 없이 12자리 16진수입니다. 이 기능은 일부 기기에서만 관련이 있습니다. |
dockMacAddress |
(읽기 전용) 기기가 연결된 도킹 스테이션의 내장 MAC 주소입니다. 공장에서 도크에 할당된 미디어 액세스 제어 주소 (MAC 주소)를 설정합니다. MAC 패스 스루 기기 정책용으로 예약되어 있습니다. 형식은 구분자(대문자) 없이 12자리 16진수입니다. 이 기능은 일부 기기에서만 관련이 있습니다. |
manufactureDate |
(읽기 전용) 기기가 제조된 날짜입니다(yyyy-mm-dd 형식). |
orgUnitPath |
기기와 연결된 조직 단위의 이름이 포함된 전체 상위 경로입니다. 경로 이름은 대소문자를 구분하지 않습니다. 상위 조직 단위가 최상위 조직인 경우 슬래시( |
tpmVersionInfo |
신뢰할 수 있는 플랫폼 모듈 (TPM) (읽기 전용) |
tpmVersionInfo.family |
TPM 제품군 TPM 2.0 스타일 인코딩을 사용합니다(예: |
tpmVersionInfo.specLevel |
TPM 사양 수준입니다. TPM 2.0의 경우 라이브러리 사양을, TPM 1.2의 경우 기본 사양을 참고하세요. |
tpmVersionInfo.manufacturer |
TPM 제조업체 코드입니다. |
tpmVersionInfo.tpmModel |
TPM 모델 번호입니다. |
tpmVersionInfo.firmwareVersion |
TPM 펌웨어 버전입니다. |
tpmVersionInfo.vendorSpecific |
공급업체 ID와 같은 공급업체별 정보 |
screenshotFiles[] |
다운로드할 스크린샷 파일 목록입니다. 유형은 항상 'SCREENSHOT_FILE'입니다. (읽기 전용) |
screenshotFiles[].name |
파일 이름 |
screenshotFiles[].type |
파일 형식 |
screenshotFiles[].downloadUrl |
파일 다운로드 URL |
screenshotFiles[].createTime |
파일이 생성된 날짜 및 시간 |
orgUnitId |
조직 단위의 고유 ID입니다. orgUnitPath는 orgUnitId의 사람이 읽을 수 있는 버전입니다. 경로 내에서 조직 단위의 이름을 변경하면 orgUnitPath가 변경될 수 있지만, 하나의 조직 단위에서는 orgUnitId를 변경할 수 없습니다. 이 속성은 API를 사용하여 업데이트할 수 있습니다. 기기의 조직 구조를 만드는 방법에 관한 자세한 내용은 관리 고객센터를 참고하세요. |
osUpdateStatus |
기기의 OS 업데이트 상태입니다. |
firstEnrollmentTime |
기기가 처음 등록된 날짜 및 시간입니다. |
lastDeprovisionTimestamp |
(읽기 전용) 기기가 마지막으로 프로비저닝 해제된 날짜 및 시간입니다. |
deprovisionReason |
(읽기 전용) 프로비저닝 해제 이유입니다. |
deviceLicenseType |
출력 전용입니다. 기기 라이선스 유형입니다. |
backlightInfo[] |
출력 전용입니다. 기기의 백라이트 정보를 포함합니다. |
autoUpdateThrough |
출력 전용입니다. 기기에서 Chrome 업데이트 또는 지원을 더 이상 받지 못하게 되는 타임스탬프입니다. |
extendedSupportEligible |
출력 전용입니다. 기기에 연장 지원 선택이 필요한지 여부입니다. |
extendedSupportStart |
출력 전용입니다. 자동 업데이트의 연장 지원 정책이 시작된 기기의 날짜입니다. |
extendedSupportEnabled |
출력 전용입니다. 기기에서 연장 지원 정책이 사용 설정되어 있는지 여부입니다. |
fanInfo[] |
출력 전용입니다. 기기의 팬 정보입니다. |
chromeOsType |
출력 전용입니다. 기기의 ChromeOS 유형입니다. |
diskSpaceUsage |
출력 전용입니다. 기기에 사용 가능한 디스크 공간과 현재 사용 중인 디스크 공간입니다. |
OsUpdateStatus
현재 OS 업데이트 상태에 관한 정보를 포함합니다.
JSON 표현 |
---|
{
"state": enum ( |
필드 | |
---|---|
state |
OS 업데이트의 업데이트 상태입니다. |
targetOsVersion |
다운로드되고 적용되는 OS 이미지의 새 플랫폼 버전입니다. 업데이트 상태가 UPDATE_STATUS_DOWNLOAD_IN_PROGRESS 또는 UPDATE_STATUS_NEED_REBOOT인 경우에만 설정됩니다. 일부 특수한 경우(예: 업데이트 엔진이 재부팅 없이 다시 시작되는 경우) UPDATE_STATUS_NEED_REBOOT의 경우 더미 '0.0.0.0'일 수 있습니다. |
targetKioskAppVersion |
대기 중인 업데이트된 키오스크 앱의 새로운 필수 플랫폼 버전입니다. |
updateTime |
OS 업데이트가 마지막으로 완료된 날짜 및 시간입니다. |
updateCheckTime |
마지막 업데이트 확인 날짜 및 시간입니다. |
rebootTime |
마지막 재부팅 날짜 및 시간입니다. |
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 |
기기에 연간 Kiosk 업그레이드가 있습니다. |
BacklightInfo
기기의 백라이트에 관한 정보입니다.
JSON 표현 |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
필드 | |
---|---|
path |
출력 전용입니다. 시스템에서 이 백라이트의 경로입니다. 호출자가 다른 정보와 연관시켜야 하는 경우에 유용합니다. |
maxBrightness |
출력 전용입니다. 백라이트의 최대 밝기입니다. |
brightness |
출력 전용입니다. 백라이트의 현재 밝기입니다(0~maxBrightness). |
FanInfo
기기의 팬에 관한 정보입니다.
JSON 표현 |
---|
{ "speedRpm": integer } |
필드 | |
---|---|
speedRpm |
출력 전용입니다. RPM 단위의 팬 속도입니다. |
ChromeOsType
기기의 ChromeOS 유형입니다.
열거형 | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Chrome OS 유형이 지정되지 않았습니다. |
CHROME_OS_FLEX |
ChromeOS 유형 ChromeOS Flex |
CHROME_OS |
Chrome OS 유형 ChromeOS입니다. |
ByteUsage
현재 사용량(바이트)을 사용하여 데이터 용량을 나타냅니다.
JSON 표현 |
---|
{ "capacityBytes": string, "usedBytes": string } |
필드 | |
---|---|
capacityBytes |
출력 전용입니다. 총 용량 값(바이트)입니다. |
usedBytes |
출력 전용입니다. 현재 사용량 값(단위: 바이트)입니다. |
메서드 |
|
---|---|
(deprecated) |
대신 BatchChangeChromeOsDeviceStatus를 사용하세요. |
|
Chrome OS 기기의 속성을 가져옵니다. |
|
계정 내 Chrome OS 기기의 페이지로 나뉜 목록을 가져옵니다. |
|
여러 ChromeOS 기기를 조직 단위로 이동하거나 삽입합니다. |
|
annotatedUser , annotatedLocation , notes , orgUnitPath , annotatedAssetId 와 같은 기기의 업데이트 가능한 속성을 업데이트합니다. |
|
annotatedUser , annotatedLocation , notes , orgUnitPath , annotatedAssetId 와 같은 기기의 업데이트 가능한 속성을 업데이트합니다. |