Method: chromeosdevices.action

Este elemento es obsoleto.

En su lugar, usa BatchChangeChromeOsDeviceStatus. Realiza una acción que afecta a un dispositivo ChromeOS. Esto incluye la aprovisionación, inhabilitación y habilitación de dispositivos.

Advertencia:

• Si se desaprovisiona un dispositivo, la política del dispositivo se dejará de sincronizar, y se quitarán las impresoras a nivel del dispositivo. Después de desaprovisionar un dispositivo, se debe limpiar antes de volver a inscribirlo.
• Los dispositivos perdidos o robados deben usar la acción de inhabilitación.
• Si vuelves a habilitar un dispositivo inhabilitado, se consumirá una licencia del dispositivo. Si no tienes suficientes licencias disponibles cuando completes la acción de volver a habilitar, recibirás un error.
  Para obtener más información sobre cómo inhabilitar y desvincular dispositivos, visita el Centro de ayuda.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId	string El ID único de la cuenta de Google Workspace del cliente. Como administrador de la cuenta, también puedes usar el alias my_customer para representar el customerId de tu cuenta. El customerId también se muestra como parte del recurso Usuarios.
resourceId	string Es el ID único del dispositivo. Los resourceId se muestran en la respuesta del método chromeosdevices.list.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ChromeOsDeviceAction.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, la respuesta es una respuesta HTTP genérica, y el método define su formato.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Guía de autorización.

ChromeOsDeviceAction

Datos sobre una actualización del estado de un dispositivo ChromeOS.

Representación JSON
{ "action": string, "deprovisionReason": string }

Campos
action	string chromeosdevices.action que se realizará en el dispositivo ChromeOS. Los valores aceptables son: deprovision: Para quitar de la administración un dispositivo que ya no está activo, se está revendiendo o se enviará para su devolución o reparación, usa la acción de desaprovisionamiento para desvincularlo de la administración. disable: Si crees que se perdió o se robó un dispositivo de tu organización, puedes inhabilitarlo para que nadie más pueda usarlo. Cuando un dispositivo está inhabilitado, lo único que el usuario puede ver cuando lo enciende es una pantalla que le indica que está inhabilitado y la información de contacto que deseas para devolverlo. Nota: La configuración del mensaje que aparecerá en un dispositivo inhabilitado se debe completar en la Consola del administrador. reenable: Vuelve a habilitar un dispositivo inhabilitado cuando se encuentra un dispositivo perdido o se devuelve un dispositivo que estaba en el lugar equivocado. También puedes usar esta función si marcas accidentalmente un dispositivo Chrome como inhabilitado. Nota: La acción de volver a habilitar solo se puede realizar en dispositivos marcados como inhabilitados. pre_provisioned_disable: Un dispositivo aprovisionado previamente que no se puede inscribir Un administrador puede volver a habilitar el dispositivo para permitir la inscripción sin contacto cambiando el estado a "pre_provisioned_reenable". Nota: Desde este estado, se puede desaprovisionar el dispositivo. pre_provisioned_reenable: Los OEMs aprovisionan el dispositivo de forma previa. Los dispositivos en este estado son aptos para la inscripción automática.
deprovisionReason	string Solo se usa cuando la acción es deprovisionar. Con la acción de baja, este campo es obligatorio. Nota: El motivo de la baja se audita porque podría tener consecuencias en las licencias de los clientes con suscripciones perpetuas. Los valores aceptables son: different_model_replacement: Úsalo si actualizas o reemplazas tu dispositivo por un modelo más reciente. retiring_device: Úsalo si vas a revender, donar o quitar de uso el dispositivo de forma permanente. same_model_replacement: Se usa si se encontró un problema de hardware en un dispositivo y se reemplaza por el mismo modelo o un modelo similar de un proveedor o fabricante de reparaciones. upgrade_transfer: Úsalo si reemplazarás tus dispositivos CloudReady por Chromebooks en el plazo de un año.