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.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
Поля
deviceIds[]

string

Необходимый. Список идентификаторов устройств ChromeOS, которые необходимо изменить. Максимум 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

Дополнительную информацию см. в руководстве по авторизации .

Чейнджромеосдевицестатусактион

Действие, которое необходимо выполнить, чтобы изменить статус устройства 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 после отключения. Повторно включает устройство, как только оно больше не потеряно или восстановлено. Это позволяет использовать устройство снова. В зависимости от обновления, связанного с устройством, для этого может потребоваться одна лицензия из пула лицензий. Это означает, что если доступных лицензий недостаточно, операция завершится неудачно.

Чанжехромосдевицестатусресулт

Результат операции изменения состояния одного устройства 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.

result поля объединения.

result может быть только одним из следующих:

error

object ( Status )

Ошибка результата операции в случае сбоя.

response

object ( ChangeChromeOsDeviceStatusSucceeded )

Устройство может успешно изменить свой статус.

Положение дел

Тип Status определяет логическую модель ошибок, подходящую для различных сред программирования, включая API REST и API RPC. Он используется gRPC . Каждое сообщение Status содержит три части данных: код ошибки, сообщение об ошибке и сведения об ошибке.

Подробнее об этой модели ошибок и о том, как с ней работать, можно узнать в API Design Guide .

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" } .

ИзменениеChromeOsDeviceStatusSucceeded

Этот тип не имеет полей.

Ответ на успешное изменение статуса устройства ChromeOS.