Method: chromeosdevices.action

대신 BatchChangeChromeOsDeviceStatus를 사용합니다. Chrome OS 기기에 영향을 미치는 작업을 수행합니다. 여기에는 기기 프로비저닝 해제, 사용 중지, 다시 사용 설정이 포함됩니다.

HTTP 요청

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
customerId

string

고객의 Google Workspace 계정의 고유 ID입니다. 계정 관리자는 my_customer 별칭을 사용하여 계정의 customerId를 나타낼 수도 있습니다. customerId사용자 리소스의 일부로 반환되기도 합니다.

resourceId

string

기기의 고유 ID입니다. resourceIdchromeosdevices.list 메서드의 응답으로 반환됩니다.

요청 본문

요청 본문에 ChromeOsDeviceAction의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답은 형식이 메서드에 의해 정의되는 일반 HTTP 응답입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

자세한 내용은 승인 가이드를 참조하세요.

ChromeOsDeviceAction

Chrome OS 기기 상태 업데이트에 관한 데이터입니다.

JSON 표현
{
  "action": string,
  "deprovisionReason": string
}
필드
action

string

ChromeOS 기기에서 취할 chromeosdevices.action

사용 가능한 값:

  • deprovision: 더 이상 활성 상태가 아니거나 재판매 중인 기기 또는 반품 / 수리를 위해 제출된 기기를 관리에서 삭제합니다. 프로비저닝 해제 작업을 사용하여 관리에서 연결 해제합니다.
  • disable: 조직의 기기가 분실 또는 도난당했다고 생각되면 다른 사람이 사용할 수 없도록 기기를 사용 중지할 수 있습니다. 기기가 사용 중지되면 Chrome 기기를 켤 때 사용자에게 기기가 사용 중지되었다는 메시지와 기기를 반품할 위치에 대한 원하는 연락처 정보가 표시됩니다.
  • reenable: 분실한 기기를 찾았거나 기기를 반품한 경우 사용 중지된 기기를 다시 사용 설정합니다. 실수로 Chrome 기기를 사용 중지된 것으로 표시한 경우에도 이 기능을 사용할 수 있습니다.
  • pre_provisioned_disable: 등록할 수 없는 사전 프로비저닝된 기기입니다. 관리자는 상태를 'pre_provisioned_reenable'로 변경하여 기기를 다시 사용 설정하여 제로터치 등록을 허용할 수 있습니다. 참고: 이 상태에서는 기기의 프로비저닝을 해제할 수 있습니다.
  • pre_provisioned_reenable: 기기가 OEM에서 사전 프로비저닝되었습니다. 이 상태의 기기는 제로터치 등록을 사용할 수 있습니다.
deprovisionReason

string

작업이 프로비저닝 해제되는 경우에만 사용됩니다. 프로비저닝 해제 작업을 사용하려면 이 필드가 필요합니다.

사용 가능한 값:

  • different_model_replacement: 동일한 기기의 최신 모델로 기기를 업그레이드하거나 교체하는 경우 사용합니다.
  • retiring_device: 기기를 재판매, 기부 또는 폐기하는 경우에 사용합니다.
  • same_model_replacement: 기기에서 하드웨어 문제가 발생하여 수리업체 / 제조업체에서 동일한 모델 또는 유사한 모델로 교체하는 경우 사용합니다.
  • upgrade_transfer: 1년 이내에 Cloud Ready 기기를 Chromebook으로 교체하는 경우 사용합니다.