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 기기 상태 변경에 대한 응답입니다.