리소스: 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 ( |
입력란 | |
---|---|
deviceId |
Chrome 기기의 고유 ID입니다. |
serialNumber |
기기가 사용 설정되었을 때 입력된 Chrome 기기 일련번호입니다. 이 값은 관리 콘솔의 Chrome OS 기기 탭에 있는 일련번호와 동일합니다. |
status |
기기의 상태입니다. 사용 가능한 값:
|
lastSync |
기기가 관리 콘솔의 정책 설정과 마지막으로 동기화된 날짜 및 시간입니다. 값은 ISO 8601 날짜 및 시간 형식으로 되어 있습니다. 시간은 완전한 날짜에 시, 분, 초를 더한 형식( |
supportEndDate |
기기가 지원되는 최종 날짜입니다. 이는 Google에서 직접 구매한 기기에만 적용됩니다. 값은 ISO 8601 날짜 및 시간 형식으로 되어 있습니다. 시간은 완전한 날짜에 시, 분, 초를 더한 형식( |
annotatedUser |
관리자가 명시한 기기의 사용자입니다. 최대 길이는 100자(영문 기준)입니다. 빈 값도 허용됩니다. |
annotatedLocation |
관리자가 명시한 기기의 주소 또는 위치입니다. 최대 길이는 |
notes |
관리자가 이 기기에 대한 메모를 추가했습니다. 이 속성은 list 메서드의 |
model |
기기의 모델 정보입니다. 기기에 이 정보가 없으면 이 속성은 응답에 포함되지 않습니다. |
meid |
휴대기기에 있는 3G 모바일 카드의 MEID (Mobile Equipment Identifier) 또는 IMEI (International Mobile Equipment Identity)입니다. 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 업데이트 또는 지원 수신을 중지하는 타임스탬프 |
ethernetMacAddress0 |
Chromebook의 내부 이더넷 포트와 온보드 네트워크(이더넷) 인터페이스에서 사용하는 (읽기 전용) MAC 주소입니다. 형식은 구분자가 없는 12자리 16진수입니다(대문자). 이는 일부 기기에만 적용됩니다. |
dockMacAddress |
(읽기 전용) 기기가 연결된 도킹 스테이션의 내장 MAC 주소입니다. 팩토리에서는 도크에서 사용하도록 할당된 MAC 주소 (Media Access Control)를 설정합니다. 특히 MAC 패스 스루 기기 정책을 위해 예약되어 있습니다. 형식은 구분자가 없는 12자리 16진수입니다(대문자). 이는 일부 기기에만 적용됩니다. |
manufactureDate |
(읽기 전용) 기기 제조 날짜(yyyy-mm-dd 형식) |
orgUnitPath |
기기와 연결된 조직 단위의 이름이 있는 전체 상위 경로입니다. 경로 이름은 대소문자를 구분하지 않습니다. 상위 조직 단위가 최상위 조직인 경우 슬래시( |
tpmVersionInfo |
TPM (신뢰할 수 있는 플랫폼 모듈) (읽기 전용) |
tpmVersionInfo.family |
TPM 제품군 Google에서는 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[] |
출력 전용. 기기의 백라이트 정보를 포함합니다. |
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 (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 |
출력 전용. 시스템에 있는 이 백라이트의 경로입니다. 발신자를 다른 정보와 관련시켜야 하는 경우 유용합니다. |
maxBrightness |
출력 전용. 백라이트의 최대 밝기입니다. |
brightness |
출력 전용. 백라이트의 현재 밝기입니다(0~maxBrightness). |
방법 |
|
---|---|
(deprecated) |
대신 BatchChangeChromeOsDeviceStatus를 사용하세요. |
|
ChromeOS 기기의 속성을 검색합니다. |
|
계정 내에서 페이지로 나눈 Chrome OS 기기 목록을 검색합니다. |
|
조직 단위로 여러 Chrome OS 기기를 이동하거나 삽입합니다. |
|
기기의 업데이트 가능한 속성(예: annotatedUser , annotatedLocation , notes , orgUnitPath , annotatedAssetId )을 업데이트합니다. |
|
기기의 업데이트 가능한 속성(예: annotatedUser , annotatedLocation , notes , orgUnitPath , annotatedAssetId )을 업데이트합니다. |