Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Verwenden Sie stattdessen BatchChangeChromeOsDeviceStatus. Es wird eine Aktion ausgeführt, die sich auf ein ChromeOS-Gerät auswirkt. Dazu gehört auch die Deaktivierung und Reaktivierung von Geräten.
HTTP-Anfrage
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Die eindeutige ID für das Google Workspace-Konto des Kunden. Als Kontoadministrator können Sie auch den Alias my_customer verwenden, um die customerId Ihres Kontos zu repräsentieren. Die customerId wird auch als Teil der Ressource „Nutzer“ zurückgegeben.
resourceId
string
Die eindeutige ID des Geräts. Die resourceIds werden in der Antwort der chromeosdevices.list-Methode zurückgegeben.
Daten zu einer Aktualisierung des Status eines ChromeOS-Geräts.
JSON-Darstellung
{"action": string,"deprovisionReason": string}
Felder
action
string
chromeosdevices.action, die auf dem ChromeOS-Gerät ausgeführt werden soll.
Akzeptable Werte sind:
deprovision: Wenn Sie ein Gerät aus der Verwaltung entfernen möchten, das nicht mehr aktiv ist, weiterverkauft wird oder zur Rückgabe oder Reparatur eingesendet wird, verwenden Sie die Aktion „Bereitstellung aufheben“, um die Verknüpfung mit der Verwaltung aufzuheben.
disable: Wenn Sie der Meinung sind, dass ein Gerät in Ihrer Organisation verloren gegangen ist oder gestohlen wurde, können Sie es deaktivieren, damit es von niemand anderem verwendet werden kann. Wenn ein Gerät deaktiviert ist, sieht der Nutzer beim Einschalten des Chrome-Geräts nur einen Bildschirm, auf dem ihm mitgeteilt wird, dass es deaktiviert wurde, und Ihre gewünschten Kontaktdaten, unter denen das Gerät zurückgegeben werden kann.
reenable: Deaktivierte Geräte wieder aktivieren, wenn ein verlegtes Gerät gefunden oder ein verlorenes Gerät zurückgegeben wird. Sie können diese Funktion auch verwenden, wenn Sie ein Chrome-Gerät versehentlich als deaktiviert markiert haben.
pre_provisioned_disable: Ein vorab bereitgestelltes Gerät, das nicht registriert werden kann. Ein Administrator kann das Gerät wieder aktivieren, um die Zero-Touch-Registrierung zuzulassen, indem er den Status in „pre_provisioned_reenable“ ändert. Hinweis: In diesem Status kann die Bereitstellung des Geräts aufgehoben werden.
pre_provisioned_reenable: Das Gerät wird vom OEM vorab bereitgestellt. Geräte in diesem Status sind für die Zero-Touch-Registrierung geeignet.
deprovisionReason
string
Wird nur verwendet, wenn die Aktion die Deaktivierung ist. Bei der Deaktivierung ist dieses Feld erforderlich.
Akzeptable Werte sind:
different_model_replacement: Verwenden Sie diese Option, wenn Sie Ihr Gerät durch ein neueres Modell desselben Geräts ersetzen.
retiring_device: Verwenden Sie diese Option, wenn Sie das Gerät weiterverkaufen, spenden oder die Nutzung dauerhaft beenden.
same_model_replacement: Verwenden Sie diese Option, wenn bei einem Gerät ein Hardwareproblem aufgetreten ist und es durch dasselbe Modell oder ein ähnliches Modell von einem Reparaturanbieter / Hersteller ersetzt wird.
upgrade_transfer: Verwenden Sie diese Option, wenn Sie Ihre CloudReady-Geräte innerhalb eines Jahres durch Chromebooks ersetzen.
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: chromeosdevices.action\n\n| This item is deprecated!\nUse [BatchChangeChromeOsDeviceStatus](https://developers.google.com/workspace/admin/directory/reference/rest/v1/customer.devices.chromeos/batchChangeStatus) instead. Takes an action that affects a Chrome OS Device. This includes deprovisioning, disabling, and re-enabling devices.\n| **Warning:**\n|\n| \u003cbr /\u003e\n|\n| - Deprovisioning a device will stop device policy syncing and remove device-level printers. After a device is deprovisioned, it must be wiped before it can be re-enrolled.\n| - Lost or stolen devices should use the disable action.\n| - Re-enabling a disabled device will consume a device license. If you do not have sufficient licenses available when completing the re-enable action, you will receive an error. \n| For more information about deprovisioning and disabling devices, visit the [help center](https://support.google.com/chrome/a/answer/3523633).\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). |\n| `resourceId` | `string` The unique ID of the device. The `resourceId`s are returned in the response from the [chromeosdevices.list](https://developers.google.com/workspace/admin/directory/v1/reference/chromeosdevices/list) method. |\n\n### Request body\n\nThe request body contains an instance of [ChromeOsDeviceAction](/workspace/admin/directory/reference/rest/v1/chromeosdevices/action#ChromeOsDeviceAction).\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.device.chromeos`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nChromeOsDeviceAction\n--------------------\n\nData about an update to the status of a Chrome OS device.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ``` { \"action\": string, \"deprovisionReason\": string } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `action` | `string` \u003cbr /\u003e chromeosdevices.action to be taken on the Chrome OS device. Acceptable values are: - `deprovision`: Remove a device from management that is no longer active, being resold, or is being submitted for return / repair, use the deprovision action to dissociate it from management. - `disable`: If you believe a device in your organization has been lost or stolen, you can disable the device so that no one else can use it. When a device is disabled, all the user can see when turning on the Chrome device is a screen telling them that it's been disabled, and your desired contact information of where to return the device.**Note**: Configuration of the message to appear on a disabled device must be completed within the Admin Console. - `reenable`: Re-enable a disabled device when a misplaced device is found or a lost device is returned. You can also use this feature if you accidentally mark a Chrome device as disabled.**Note**: The re-enable action can only be performed on devices marked as disabled. - `pre_provisioned_disable`: A pre-provisioned device that cannot enroll. An admin can re-enable the device to allow Zero-Touch Enrollment by changing the status to \"pre_provisioned_reenable\". **Note**: From this state the device can be deprovisioned. - `pre_provisioned_reenable`: Device is pre-provisioned by OEMs. Devices in this state are eligible for Zero-Touch Enrollment. |\n| `deprovisionReason` | `string` \u003cbr /\u003e Only used when the action is deprovision. With the deprovision action, this field is required. \u003cbr /\u003e | **Note**: The deprovision reason is audited because it might have implications on licenses for perpetual subscription customers. \u003cbr /\u003e Acceptable values are: - `different_model_replacement`: Use if you're upgrading or replacing your device with a newer model of the same device. - `retiring_device`: Use if you're reselling, donating, or permanently removing the device from use. - `same_model_replacement`: Use if a hardware issue was encountered on a device and it is being replaced with the same model or a like-model replacement from a repair vendor / manufacturer. - `upgrade_transfer`: Use if you're replacing your Cloud Ready devices with Chromebooks within one year. |"]]
