Method: chromeosdevices.action

Este item está obsoleto.

Use BatchChangeChromeOsDeviceStatus. Faz uma ação que afeta um dispositivo ChromeOS. Isso inclui desprovisionar, desativar e reativar dispositivos.

Aviso:

• O desprovisionamento de um dispositivo interrompe a sincronização de políticas e remove impressoras no nível do dispositivo. Depois que um dispositivo é desprovisionado, ele precisa ser excluído permanentemente antes de ser registrado de novo.
• Em dispositivos perdidos ou roubados, use a ação de desativar.
• A reativação de um dispositivo desativado consome uma licença dele. Se você não tiver licenças suficientes disponíveis ao concluir a ação de reativação, uma mensagem de erro será exibida.
  Para mais informações sobre desprovisionamento e desativação de dispositivos, acesse a Central de Ajuda.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId	string O ID exclusivo da conta do Google Workspace do cliente. Como administrador da conta, você também pode usar o alias my_customer para representar o customerId da sua conta. O customerId também é retornado como parte do recurso Usuários.
resourceId	string O ID exclusivo do dispositivo. Os resourceIds são retornados na resposta do método chromeosdevices.list.

Corpo da solicitação

O corpo da solicitação contém uma instância de ChromeOsDeviceAction.

Corpo da resposta

Se for bem-sucedida, a resposta será uma resposta HTTP genérica que tem o formato definido pelo método.

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.

ChromeOsDeviceAction

Dados sobre uma atualização do status de um dispositivo Chrome OS.

Representação JSON
{ "action": string, "deprovisionReason": string }

Campos
action	string chromeosdevices.action que vai ser executado no dispositivo Chrome OS. Os valores aceitos são: deprovision: remover do gerenciamento um dispositivo que não está mais ativo, sendo revendido ou enviado para devolução / reparo, use a ação de desprovisionamento para desvinculá-lo do gerenciamento. disable: se você acredita que um dispositivo da sua organização foi perdido ou roubado, é possível desativá-lo para que ninguém mais possa usá-lo. Quando um dispositivo está desativado, tudo o que o usuário pode ver ao ligar o dispositivo Chrome é uma tela informando que ele foi desativado e seus dados de contato sobre para onde devolver o dispositivo. Observação: é preciso concluir a configuração da mensagem para que ela apareça em um dispositivo desativado no Admin Console. reenable: reativar um dispositivo desativado quando um dispositivo perdido for encontrado ou devolvido. Também é possível usar esse recurso se você marcar acidentalmente um dispositivo Chrome como desativado. Observação: a ação de reativação só pode ser realizada em dispositivos marcados como desativados. pre_provisioned_disable: um dispositivo pré-provisionado que não pode ser registrado. Um administrador pode mudar o status para "pre_provision_reenable" para reativar o dispositivo e permitir o registro sem toque. Observação: a partir desse estado, o dispositivo pode ser desprovisionado. pre_provisioned_reenable: o dispositivo é pré-provisionado por OEMs. Os dispositivos nesse estado estão qualificados para o registro sem toque.
deprovisionReason	string Usado apenas quando a ação é desprovisionada. Com a ação de desprovisionamento, este campo é obrigatório. Observação: o motivo do desprovisionamento é auditado porque pode afetar as licenças dos clientes com assinaturas permanentes. Os valores aceitos são: different_model_replacement: use se você estiver fazendo upgrade ou substituindo seu dispositivo por um modelo mais recente do mesmo dispositivo. retiring_device: use se for revender, doar ou remover permanentemente o dispositivo do uso. same_model_replacement: use se um problema de hardware for encontrado em um dispositivo e ele estiver sendo substituído pelo mesmo modelo ou uma substituição de modelo semelhante de um fornecedor / fabricante de assistência técnica. upgrade_transfer: use se você pretende substituir seus dispositivos prontos para a nuvem por Chromebooks dentro de um ano.