Method: customer.devices.chromeos.batchChangeStatus

ChromeOS 기기 일괄 처리의 상태를 변경합니다. ChromeOS 기기 상태 변경에 관한 자세한 내용은 ChromeOS 기기 수리, 용도 변경 또는 사용 중지하기를 참고하세요.

HTTP 요청

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

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. Google Workspace 계정의 변경할 수 없는 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
필드
deviceIds[]

string

필수 항목입니다. 변경할 ChromeOS 기기의 ID 목록입니다. 최대 50자(영문 기준)입니다.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

필수 항목입니다. ChromeOS 기기에서 상태를 변경하기 위해 수행할 작업입니다.
deprovisionReason

enum (DeprovisionReason)

선택사항입니다. 기기 프로비저닝 해제 이유 'changeChromeOsDeviceStatusAction'인 경우 제공해야 합니다. 'CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION'으로 설정되어 있습니다. 그렇지 않으면 이 필드를 생략합니다.

응답 본문

ChromeOS 기기 배치의 상태 변경에 관한 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
필드
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

요청에 제공된 각 ChromeOS 기기의 결과입니다.

승인 범위

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

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

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

ChangeChromeOsDeviceStatusAction

ChromeOS 기기의 상태를 변경하기 위해 실행할 작업입니다.

열거형
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED 기본값 사용되지 않은 값입니다.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION ChromeOS 기기의 프로비저닝을 해제합니다. 조직에서 더 이상 사용하지 않는 ChromeOS 기기가 있는 경우 기기를 더 이상 관리하지 않도록 프로비저닝을 해제해야 합니다. 기기를 프로비저닝 해제하면 기기에 적용된 모든 정책과 기기 수준 프린터가 삭제되며, 기기를 키오스크로 사용할 수 있는 기능도 삭제됩니다. 기기와 연결된 업그레이드에 따라 이 작업으로 라이선스가 라이선스 풀로 다시 해제될 수 있습니다. 그러면 다른 기기에서 라이선스를 사용할 수 있습니다.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE ChromeOS 기기를 사용 중지합니다. 사용자가 기기를 분실하거나 도난당한 경우 기기가 계속 관리되므로 정책은 계속 수신하지만 아무도 사용할 수 없습니다. 기기와 연결된 업그레이드에 따라 이 작업으로 라이선스가 라이선스 풀로 다시 해제될 수 있습니다. 그러면 다른 기기에서 라이선스를 사용할 수 있습니다.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE ChromeOS 기기가 사용 중지된 후에 다시 사용할 수 있도록 다시 사용 설정합니다. 더 이상 분실되지 않거나 복구된 기기를 다시 사용 설정합니다. 이렇게 하면 기기를 다시 사용할 수 있습니다. 기기와 연결된 업그레이드에 따라 라이선스 풀에서 하나의 라이선스를 사용할 수 있습니다. 즉, 사용 가능한 라이선스가 충분하지 않으면 작업이 실패합니다.

ChangeChromeOsDeviceStatusResult

단일 ChromeOS 기기가 상태 변경 작업의 결과입니다.

JSON 표현 
{
  "deviceId": string,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
필드
deviceId

string

ChromeOS 기기의 고유 ID입니다.

통합 필드 result.

result는 다음 중 하나여야 합니다.
error

object (Status)

실패한 경우 작업의 오류 결과입니다.
response

object (ChangeChromeOsDeviceStatusSucceeded)

기기의 상태가 성공적으로 변경될 수 있습니다.

상태

Status 유형은 REST API, RPC API를 비롯하여 다양한 프로그래밍 환경에 적합한 논리적 오류 모델을 정의하며, gRPC에서 사용됩니다. 각 Status 메시지에는 오류 코드, 오류 메시지, 오류 세부정보라는 3가지 데이터가 포함됩니다.

API 설계 가이드에서 이 오류 모델과 모델 작업 방법에 대해 자세히 알아볼 수 있습니다.

JSON 표현 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
필드
code

integer

상태 코드로, google.rpc.Code의 열거형 값이어야 합니다.
message

string

개발자에게 정보를 제공하는 오류 메시지로, 영어로 작성되어야 합니다. 사용자에게 표시되는 모든 오류 메시지는 현지화되어 google.rpc.Status.details 필드에 전송되거나, 클라이언트 측에서 현지화되어야 합니다.
details[]

object

오류 세부정보를 설명하는 메시지 목록입니다. API에서 사용할 일반적인 메시지 유형 집합이 있습니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }

ChangeChromeOsDeviceStatusSucceeded

이 유형에는 필드가 없습니다.

ChromeOS 기기 상태 변경이 성공한 경우의 응답입니다.