Muda o status de um lote de dispositivos ChromeOS. Saiba como mudar o estado de um dispositivo ChromeOS em Consertar, reutilizar ou desativar dispositivos ChromeOS.
Solicitação HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
customerId |
Obrigatório. ID imutável da conta do Google Workspace. |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "deviceIds": [ string ], "changeChromeOsDeviceStatusAction": enum ( |
Campos | |
---|---|
deviceIds[] |
Obrigatório. Lista dos IDs dos dispositivos ChromeOS que vão ser alterados. No máximo 50. |
changeChromeOsDeviceStatusAction |
Obrigatório. A ação a ser realizada no dispositivo ChromeOS para mudar o status dele. |
deprovisionReason |
Opcional. O motivo por trás de um desprovisionamento de dispositivo. Precisa ser fornecido se "changeChromeOsDeviceStatusAction" estiver definido como "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION". Caso contrário, omita esse campo. |
Corpo da resposta
Resposta da mudança do status de um lote de dispositivos ChromeOS.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"changeChromeOsDeviceStatusResults": [
{
object ( |
Campos | |
---|---|
changeChromeOsDeviceStatusResults[] |
Os resultados de cada um dos dispositivos ChromeOS fornecidos na solicitação. |
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/admin.directory.device.chromeos
Para mais informações, consulte o Guia de autorização.
ChangeChromeOsDeviceStatusAction
A ação a ser realizada para mudar o status de um dispositivo ChromeOS.
Enums | |
---|---|
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED |
Valor padrão. O valor não é utilizado. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION |
Desprovisiona um dispositivo ChromeOS. Desprovisione dispositivos ChromeOS que não são mais usados na organização para que eles não sejam mais gerenciados. O desprovisionamento remove todas as políticas que estavam no dispositivo, bem como as impressoras no nível do dispositivo e a capacidade de usá-lo como um quiosque. Dependendo do upgrade associado ao dispositivo, essa ação pode liberar a licença de volta para o pool, permitindo que você a use em outro dispositivo. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE |
Desativa um dispositivo ChromeOS. Use essa ação se um usuário perder o dispositivo ou se ele for roubado. Assim, o dispositivo ainda será gerenciado e receberá políticas, mas ninguém poderá usá-lo. Dependendo do upgrade associado ao dispositivo, essa ação pode liberar a licença de volta para o pool, permitindo que você a use em outro dispositivo. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE |
Reativa o uso de um dispositivo ChromeOS após a desativação. Reativar o dispositivo assim que ele não for mais perdido ou recuperado. Isso permite que o dispositivo seja usado novamente. Dependendo do upgrade associado ao dispositivo, isso pode consumir uma licença do pool. Isso significa que, se não houver licenças suficientes disponíveis, a operação falhará. |
ChangeChromeOsDeviceStatusResult
O resultado de um único dispositivo ChromeOS para uma operação de mudança de estado.
Representação JSON |
---|
{ "deviceId": string, // Union field |
Campos | |
---|---|
deviceId |
O ID exclusivo do dispositivo ChromeOS. |
Campo de união
|
|
error |
Resultado do erro da operação em caso de falha. |
response |
O status do dispositivo pode ser alterado. |
Status
O tipo Status
define um modelo de erro lógico que é adequado a diferentes ambientes de programação, incluindo APIs REST e RPC. É usado por gRPC (em inglês). Cada mensagem Status
contém três partes de dados: código do erro, mensagem de erro e detalhes do erro.
É possível descobrir mais sobre esse modelo de erro e como trabalhar com ele no Guia de design de API.
Representação JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Campos | |
---|---|
code |
O código de status, que precisa ser um valor de enumeração de |
message |
Uma mensagem de erro em inglês para o desenvolvedor. Qualquer mensagem de erro para o usuário precisa ser localizada e enviada no campo |
details[] |
Uma lista de mensagens com os detalhes do erro. Há um conjunto comum de tipos de mensagens para as APIs usarem. Um objeto contendo campos de um tipo arbitrário. Um campo adicional |
ChangeChromeOsDeviceStatusSucceeded
Esse tipo não tem campos.
Resposta para uma mudança de status do dispositivo ChromeOS.