Method: chromeosdevices.action

Zamiast niego użyj parametru BatchChangeChromeOsDeviceStatus. Podejmuje działanie wpływające na urządzenie z Chrome OS. Obejmuje to wyrejestrowywanie, wyłączanie i ponowne włączanie urządzeń.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Unikalny identyfikator konta Google Workspace klienta. Jako administrator konta możesz też używać aliasu my_customer do reprezentowania domeny customerId na Twoim koncie. Zasób customerId jest też zwracany w ramach zasobu Użytkownicy.

resourceId

string

Unikalny identyfikator urządzenia. Obiekty resourceId są zwracane w odpowiedzi z metody chromeosdevices.list.

Treść żądania

Treść żądania zawiera wystąpienie elementu ChromeOsDeviceAction.

Treść odpowiedzi

Jeśli operacja się uda, odpowiedzią będzie ogólna odpowiedź HTTP, której format jest zdefiniowany przez metodę.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

ChromeOsDeviceAction

Dane na temat aktualizacji stanu urządzenia z Chrome OS.

Zapis JSON
{
  "action": string,
  "deprovisionReason": string
}
Pola
action

string

chromeosdevices.action do wykonania na urządzeniu z Chrome OS.

Akceptowane wartości:

  • deprovision: usuń z systemu zarządzania urządzenie, które nie jest już aktywne, jest odsprzedane lub jest przesyłane do zwrotu albo naprawy. Użyj działania wyrejestrowania, aby usunąć powiązanie urządzenia z zarządzaniem.
  • disable: jeśli uważasz, że urządzenie z Twojej organizacji zostało zgubione lub skradzione, możesz je wyłączyć, by nikt inny nie mógł z niego korzystać. Gdy urządzenie z Chrome jest wyłączone, po jego włączeniu użytkownik widzi tylko ekran z informacją o tym, że zostało wyłączone, oraz wybrane informacje kontaktowe dotyczące miejsca zwrotu urządzenia.
  • reenable: możesz ponownie włączyć wyłączone urządzenie w przypadku znalezienia utraconego urządzenia lub jego zwrotu. Z tej funkcji możesz też skorzystać, jeśli przypadkowo oznaczysz urządzenie z Chrome jako wyłączone.
  • pre_provisioned_disable: urządzenie przygotowane do obsługi administracyjnej, którego nie można zarejestrować. Administrator może ponownie włączyć na urządzeniu rejestrację typu zero-touch, zmieniając jego stan na „pre_provisioned_reenable”. Uwaga: w tym stanie urządzenie można wyrejestrować.
  • pre_provisioned_reenable: urządzenie zostało przygotowane do obsługi administracyjnej przez dostawców OEM. Urządzenia w tym stanie kwalifikują się do rejestracji typu zero-touch.
deprovisionReason

string

Używany tylko podczas wyrejestrowania działania. Po wykonaniu czynności wyrejestrowania to pole jest wymagane.

Akceptowane wartości:

  • different_model_replacement: użyj, jeśli wymieniasz urządzenie na nowszy model lub nowszy model.
  • retiring_device: użyj, jeśli sprzedajesz urządzenie, przekazujesz je w ramach darowizny lub wycofujesz je z użycia na stałe.
  • same_model_replacement: użyj, jeśli w urządzeniu wystąpił problem ze sprzętem i jest ono wymieniane na ten sam model lub na zamiennik zgodny z modelem dostarczonym przez dostawcę naprawy.
  • upgrade_transfer: użyj, jeśli w ciągu roku wymieniasz urządzenia działające w chmurze na Chromebooki.