Method: chromeosdevices.action

Este elemento es obsoleto.

En su lugar, usa BatchChangeChromeOsDeviceStatus. Realiza una acción que afecta a un dispositivo con Sistema operativo Chrome. Esto incluye desaprovisionar, inhabilitar y volver a habilitar dispositivos.

Advertencia:

• Si desaprovisiona un dispositivo, la política de dispositivo dejará de sincronizarse y se quitarán las impresoras a nivel del dispositivo. Después de desaprovisionar un dispositivo, se debe limpiarlo antes de volver a inscribirlo.
• Debes inhabilitar la opción para inhabilitar dispositivos perdidos o robados.
• Si vuelves a habilitar un dispositivo inhabilitado, se consumirá una licencia de dispositivo. Si no tienes suficientes licencias disponibles cuando completes la acción para volver a habilitarla, recibirás un mensaje de error.
  Para obtener más información sobre el desaprovisionamiento y la inhabilitación de 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. customerId también se muestra como parte del Recurso de usuarios.
resourceId	string El ID único del dispositivo. Los objetos 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.

Alcances 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 con ChromeOS.

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

Campos
action	string chromeosdevices.action a realizar en el dispositivo con Sistema operativo Chrome. Los valores aceptables son: deprovision: Quita de la administración un dispositivo que ya no esté activo, que se revenda o que se envíe para su devolución o reparación. Usa la acción de desaprovisionamiento para desvincularlo de la administración. disable: Si crees que un dispositivo de tu organización se perdió o fue robado, puedes inhabilitarlo para que nadie más pueda usarlo. Cuando un dispositivo está inhabilitado, todo lo que el usuario puede ver cuando enciende el dispositivo Chrome es una pantalla que le informa que se inhabilitó y la información de contacto deseada para saber dónde devolver el dispositivo. Nota: La configuración del mensaje para que aparezca en un dispositivo inhabilitado debe completarse en la Consola del administrador. reenable: Vuelve a habilitar un dispositivo inhabilitado cuando se encuentra uno extraviado o se devuelve uno perdido. 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: Es un dispositivo aprovisionado de forma previa que no se puede inscribir. Un administrador puede volver a habilitar el dispositivo para permitir la inscripción automática cambiando el estado a "pre_provision_reenable". Nota: En este estado, es posible desaprovisionar el dispositivo. pre_provisioned_reenable: Los OEM aprovisionan el dispositivo previamente. Los dispositivos en este estado son aptos para la inscripción automática.
deprovisionReason	string Solo se usa cuando se desaprovisiona la acción. Con la acción de desaprovisionamiento, este campo es obligatorio. Nota: El motivo de desaprovisionamiento se audita porque podría tener implicaciones en las licencias de los clientes con suscripciones perpetuas. Los valores aceptables son: different_model_replacement: Úsalo si quieres actualizar o reemplazar tu dispositivo por un modelo más reciente del mismo. retiring_device: Úsalo si revendes, donas o quitas el dispositivo de forma permanente. same_model_replacement: Úsalo si se encontró un problema de hardware en un dispositivo y se reemplaza por el mismo modelo o un reemplazo a un modelo similar de un proveedor o fabricante de reparaciones. upgrade_transfer: Úsalo si reemplazas tus dispositivos listos para la nube por Chromebooks en el plazo de un año.