리소스: 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 |
리소스의 eETag입니다. |
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 |
(읽기 전용) MAC 주소입니다. Chromebook의 내부 이더넷 포트에서 사용되며 온보드 네트워크 (이더넷) 인터페이스에 사용됩니다. 형식은 구분자(대문자) 없이 12자리 16진수입니다. 이는 일부 기기에만 적용됩니다. |
dockMacAddress |
(읽기 전용) 기기가 연결된 도킹 스테이션의 내장 MAC 주소입니다. 도크에서 사용하도록 할당된 MAC 주소 (Media Access Control 주소)를 팩토리에서 설정합니다. 특히 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 유형입니다. |
OsUpdateStatus
현재 OS 업데이트 상태에 관한 정보가 포함됩니다.
JSON 표현 |
---|
{
"state": enum ( |
필드 | |
---|---|
state |
OS 업데이트의 업데이트 상태입니다. |
targetOsVersion |
다운로드 및 적용되는 OS 이미지의 새 플랫폼 버전입니다. 업데이트 상태가 UPDATE_STATUS_DOWNLOAD_IN_PROGRESS 또는 UPDATE_STATUS_NEED_REBOOT인 경우에만 설정됩니다. 더미 '0.0.0.0'일 수 있습니다. 일부 극단적인 사례의 경우 UPDATE_STATUS_NEED_REBOOT 업데이트 엔진이 재부팅 없이 다시 시작됩니다. |
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 |
기기에 연간 키오스크 업그레이드가 있습니다. |
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 유형 Chrome OS입니다. |
메서드 |
|
---|---|
(deprecated) |
대신 BatchChangeChromeOsDeviceStatus를 사용합니다. |
|
Chrome OS 기기의 속성을 검색합니다. |
|
계정 내에서 페이지로 나눈 Chrome OS 기기 목록을 검색합니다. |
|
여러 Chrome OS 기기를 조직 단위로 이동하거나 삽입합니다. |
|
annotatedUser , annotatedLocation , notes , orgUnitPath , annotatedAssetId 등 기기의 업데이트 가능한 속성을 업데이트합니다. |
|
annotatedUser , annotatedLocation , notes , orgUnitPath , annotatedAssetId 등 기기의 업데이트 가능한 속성을 업데이트합니다. |