리소스: 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 |
출력 전용입니다. 기기에서 사용 가능하고 현재 사용 중인 디스크 공간의 양입니다. |
osVersionCompliance |
출력 전용입니다. OS 버전의 기기 정책 준수 상태입니다. |
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 업그레이드가 있습니다. |
ENTERPRISE_UPGRADE_PERPETUAL |
기기가 독립형 영구 Chrome Enterprise 업그레이드인 Chrome Enterprise 라이선스를 사용하고 있음을 나타냅니다. |
ENTERPRISE_UPGRADE_FIXED_TERM |
기기가 독립형 고정 기간 Chrome Enterprise 업그레이드인 Chrome Enterprise 라이선스를 사용하고 있음을 나타냅니다. |
EDUCATION_UPGRADE_PERPETUAL |
기기가 독립형 영구 Chrome Education 업그레이드(일명 Chrome EDU 영구 라이선스)를 사용하고 있음을 나타냅니다. |
EDUCATION_UPGRADE_FIXED_TERM |
기기가 독립형 고정 기간 Chrome Education 업그레이드(일명 Chrome EDU 고정 기간 라이선스)를 사용하고 있음을 나타냅니다. |
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 |
Chrome OS 유형 Chrome OS Flex |
CHROME_OS |
Chrome OS를 입력합니다. |
ByteUsage
현재 사용량이 바이트 단위로 표시된 데이터 용량을 나타냅니다.
JSON 표현 |
---|
{ "capacityBytes": string, "usedBytes": string } |
필드 | |
---|---|
capacityBytes |
출력 전용입니다. 총 용량 값(바이트)입니다. |
usedBytes |
출력 전용입니다. 현재 사용량 값(바이트)입니다. |
규정 준수
OS 버전의 기기 정책 준수 상태입니다.
열거형 | |
---|---|
COMPLIANCE_UNSPECIFIED |
규정 준수 상태가 지정되지 않았습니다. |
COMPLIANT |
규정 준수 상태가 '준수'입니다. |
PENDING |
규정 준수 상태가 대기 중입니다. |
NOT_COMPLIANT |
규정 준수 상태가 규정 미준수입니다. |
메서드 |
|
---|---|
(deprecated) |
대신 BatchChangeChromeOsDeviceStatus를 사용하세요. |
|
ChromeOS 기기의 속성을 가져옵니다. |
|
계정 내 ChromeOS 기기의 페이지로 구분된 목록을 가져옵니다. |
|
여러 ChromeOS 기기를 조직 단위로 이동하거나 삽입합니다. |
|
annotatedUser , annotatedLocation , notes , orgUnitPath , annotatedAssetId 과 같은 기기의 업데이트 가능한 속성을 업데이트합니다. |
|
annotatedUser , annotatedLocation , notes , orgUnitPath , annotatedAssetId 과 같은 기기의 업데이트 가능한 속성을 업데이트합니다. |