Method: customer.devices.chromeos.batchChangeStatus

Bir grup ChromeOS cihazın durumunu değiştirir. ChromeOS cihaz durumunu değiştirme hakkında daha fazla bilgi için ChromeOS cihazları onarma, yeniden kullanma veya kullanımdan kaldırma hakkında daha fazla bilgi edinin.

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

string

Zorunlu. Google Workspace hesabının sabit kimliği.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
Alanlar
deviceIds[]

string

Zorunlu. Değiştirilecek ChromeOS cihazların kimliklerinin listesi. Maksimum 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

Zorunlu. ChromeOS cihazda, durumunu değiştirmek için yapılacak işlem.
deprovisionReason

enum (DeprovisionReason)

İsteğe bağlı. Cihazın temel hazırlığının kaldırılmasının nedeni. "changeChromeOsDeviceStatusAction" ise sağlanmalıdır "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION" olarak ayarlandı. Aksi takdirde bu alanı atlayın.

Yanıt gövdesi

Bir grup ChromeOS cihazın durumunun değiştirilmesine verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
Alanlar
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

İ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ılavuzunu inceleyin.

ChangeChromeOsDeviceStatusAction

ChromeOS cihazın durumunu değiştirmek için yapılacak 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 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 ve cihaz düzeyindeki yazıcılar kaldırılır. Ayrıca cihaz bundan böyle kiosk olarak kullanılamaz. Cihazla ilişkili yükseltmeye bağlı olarak bu işlem, lisansı tekrar lisans havuzuna verebilir; Bu, lisansı farklı bir cihazda kullanmanıza olanak tanır.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE ChromeOS cihazı devre dışı bırakır. Bir kullanıcı cihazı kaybederse veya cihaz çalınırsa bu işlemi kullanın. Bu durumda cihaz hâlâ yönetilebilir durumda olur. Bu durumda cihaz politikaları almaya devam eder ancak kimse cihazı kullanamaz. Cihazla ilişkili yükseltmeye bağlı olarak bu işlem, lisansı tekrar lisans havuzuna verebilir; Bu, lisansı farklı bir cihazda kullanmanıza olanak tanır.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Bir ChromeOS cihazı devre dışı bırakıldıktan sonra kullanılacak şekilde yeniden etkinleştirir. Cihaz, kaybolduğunda veya kurtarıldıktan sonra yeniden etkinleştirilir. Bu işlem, cihazın tekrar kullanılmasına olanak sağlar. Cihazla ilişkilendirilen yükseltmeye bağlı olarak, lisans havuzundan bir lisans kullanılabilir. Diğer bir deyişle, 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 result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
Alanlar
deviceId

string

ChromeOS cihazın benzersiz kimliği.

Birleştirme alanı result.

result şunlardan yalnızca biri olabilir:
error

object (Status)

Başarısız olması durumunda işlemin hata sonucu.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Cihazın durumu başarıyla 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 modelini 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ı.

API Tasarım Kılavuzu'nda bu hata modeli ve bu hata modeliyle nasıl çalışılacağı hakkında daha fazla bilgi edinebilirsiniz.

JSON gösterimi 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Alanlar
code

integer

google.rpc.Code olması gereken durum kodu.
message

string

Geliştiricilere yönelik, İngilizce olması gereken bir hata mesajı. Kullanıcılara yönelik tüm hata mesajları yerelleştirilip google.rpc.Status.details alanında gönderilmeli veya istemci tarafından yerelleştirilmelidir.
details[]

object

Hata ayrıntılarını içeren mesajların listesi. API'lerin kullandığı bir dizi mesaj türü vardır.

Rastgele türden alanlar içeren nesne. Ek bir "@type" alanı, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

Bu türde alan yok.

ChromeOS cihaz durumundaki başarılı bir değişiklik için verilen yanıt.