Bir grup ChromeOS cihazın durumunu değiştirir. ChromeOS cihaz durumunu değiştirme hakkında daha fazla bilgi için ChromeOS cihazları onarıma gönderme, başka amaçlarla kullanıma hazırlama veya kullanımdan kaldırma başlıklı makaleyi inceleyin.
HTTP isteği
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Google Workspace hesabının sabit kimliği. |
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{ "deviceIds": [ string ], "changeChromeOsDeviceStatusAction": enum ( |
Alanlar | |
---|---|
deviceIds[] |
Zorunlu. Değiştirilecek ChromeOS cihazların kimliklerinin listesi. Maksimum 50. |
changeChromeOsDeviceStatusAction |
Zorunlu. ChromeOS cihazda, durumunu değiştirmek için yapılacak işlem. |
deprovisionReason |
İsteğe bağlı. Bir cihazın temel hazırlığının kaldırılmasının nedeni. "changeChromeOsDeviceStatusAction" "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION" olarak ayarlanmışsa sağlanmalıdır. Aksi takdirde bu alanı atlayın. |
Yanıt gövdesi
Bir grup ChromeOS cihazın durumunu değiştirme yanıtı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"changeChromeOsDeviceStatusResults": [
{
object ( |
Alanlar | |
---|---|
changeChromeOsDeviceStatusResults[] |
İstekte sağlanan ChromeOS cihazların her biri için sonuçlar. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/admin.directory.device.chromeos
Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.
ChangeChromeOsDeviceStatusAction
ChromeOS cihazın durumunu değiştirmek için gerçekleştirilen işlem.
Sıralamalar | |
---|---|
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED |
Varsayılan değer. Değer kullanılmıyor. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION |
Bir ChromeOS cihazın temel hazırlığını kaldırır. Kuruluşunuzda artık kullanılmayan ChromeOS cihazlarınız varsa, artık yönetmediğiniz bu cihazların temel hazırlığını kaldırmanız gerekir. Cihazın temel hazırlığı kaldırıldığında cihazdaki tüm politikalar, cihaz düzeyindeki yazıcılar ve cihazı kiosk olarak kullanma özelliği kaldırılır. Cihazla ilişkili yükseltmeye bağlı olarak, bu işlem, lisansın farklı bir cihazda kullanılmasına olanak tanıyan lisans havuzuna geri yüklenebilir. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE |
ChromeOS cihazı devre dışı bırakır. Kullanıcı cihazı kaybederse veya çalınırsa bu işlemi kullanın. Bu durumda, cihaz hâlâ yönetilen cihaz durumunda olacak ve cihaz politikaları almaya devam edecektir ancak cihazı kimse kullanamaz. Cihazla ilişkili yükseltmeye bağlı olarak, bu işlem, lisansın farklı bir cihazda kullanılmasına olanak tanıyan lisans havuzuna geri yüklenebilir. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE |
Devre dışı bırakıldıktan sonra ChromeOS cihazı yeniden etkinleştirir. Cihazınız artık kaybolmadığında veya kurtarıldığında yeniden etkinleştirilir. Bu, cihazın tekrar kullanılmasına olanak tanır. Cihazla ilişkilendirilmiş yükseltme işlemine bağlı olarak, lisans havuzundaki bir lisans kullanılabilir. Bu durumda, yeterli sayıda lisans yoksa işlem başarısız olur. |
ChangeChromeOsDeviceStatusResult
Durumu değiştirme işlemi için tek bir ChromeOS cihazın sonucu.
JSON gösterimi |
---|
{ "deviceId": string, // Union field |
Alanlar | |
---|---|
deviceId |
ChromeOS cihazın benzersiz kimliği. |
|
|
error |
Hata olması durumunda işlemin hata sonucu. |
response |
Cihaz, durumunu başarılı bir şekilde değiştirebilir. |
Durum
Status
türü, REST API'ler ve RPC API'leri dahil olmak üzere farklı programlama ortamları için uygun bir mantıksal hata modeli tanımlar. gRPC tarafından kullanılır. Her Status
mesajı üç veri parçası içerir: hata kodu, hata mesajı ve hata ayrıntıları.
Bu hata modeli ve modelle nasıl çalışılacağı hakkında daha fazla bilgiyi API Tasarım Kılavuzu'nda bulabilirsiniz.
JSON gösterimi |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Alanlar | |
---|---|
code |
|
message |
Geliştiricinin karşılaştığı İngilizce hata mesajı. Kullanıcılara yönelik tüm hata mesajları yerelleştirilip |
details[] |
Hata ayrıntılarını içeren mesajların listesi. API'lerin kullanabileceği yaygın bir dizi mesaj türü vardır. Rastgele türde alanlar içeren bir nesne. |
ChangeChromeOsDeviceStatusSucceeded
Bu türde alan yok.
Başarılı bir ChromeOS cihaz durumu değişikliğinin yanıtı.