REST Resource: customer.devices.chromeos.commands

Kaynak: DirectoryChromeosdevicesCommand

Bir cihaza verilen komutla ilgili bilgiler.

JSON gösterimi 
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
Alanlar
commandId

string (int64 format)

Cihaz komutunun benzersiz kimliği.
type

enum (CommandType)

Komutun türü.
issueTime

string (Timestamp format)

Komutun yönetici tarafından verildiği zaman damgası.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
state

enum (State)

Komut durumunu gösterir.
commandExpireTime

string (Timestamp format)

Komutun süresinin dolacağı zaman. Cihaz bu süre içinde komutu yürütmezse komutun süresi dolar.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
commandResult

object (DirectoryChromeosdevicesCommandResult)

Komut yürütme sonucu.
payload

string

Komutun belirttiği yük (varsa).

CommandType

Cihazın yürütmesi gereken komut türünü belirler.

Sıralamalar
COMMAND_TYPE_UNSPECIFIED Komut türü belirtilmedi.
REBOOT Cihazı yeniden başlatın. Kiosk ve yönetilen misafir oturumu cihazlarına ve ChromeOS 113 veya sonraki sürümlerin yüklü olduğu normal cihazlara verilebilir.
TAKE_A_SCREENSHOT Cihazın ekran görüntüsünü alın. Yalnızca cihaz Kiosk Modu'ndaysa kullanılabilir.
SET_VOLUME Cihazın ses düzeyini ayarlayın. Yalnızca kiosk ve yönetilen misafir oturumu cihazlarına verilebilir.
WIPE_USERS Cihazdaki tüm kullanıcıları temizleyin. Bu komutun cihazda yürütülmesi, tüm kullanıcı profili verilerini kaldırır ancak cihaz politikası ve kayıt verilerini muhafaza eder.
REMOTE_POWERWASH Güç yıkama işlemi yaparak cihazı temizler. Bu komutun cihazda yürütülmesi, kullanıcı politikaları, cihaz politikaları ve kayıt politikaları dahil tüm verileri kaldırır. Uyarı: Bu işlemle cihaz, zorunlu veya otomatik kayda tabi olmadığı sürece, fabrika ayarlarına döndürülecek ve kaydı olmayacak. Bu işlem geri alınamaz. Bu nedenle dikkatli olun.
DEVICE_START_CRD_SESSION Chrome Uzaktan Masaüstü oturumu başlatır.
CAPTURE_LOGS Kiosk cihazın sistem günlüklerini yakalayın. Günlükler, chromeosdevices alanının deviceFiles bölümündeki downloadUrl bağlantısından indirilebilir.
FETCH_CRD_AVAILABILITY_INFO Cihaza uzaktan bağlanmak için kullanılabilecek Chrome Uzaktan Masaüstü oturumlarının (özel veya paylaşılan) mevcut türlerini getirir.
FETCH_SUPPORT_PACKET Cihazdan destek paketini uzaktan getirme. Destek paketi, bir ChromeOS cihazındaki çeşitli sistem günlüklerini ve hata ayıklama verilerini içeren bir zip arşividir. Destek paketi, chromeosdevices öğesinin deviceFiles alanındaki downloadURL bağlantısından indirilebilir.

Eyalet

Verilen komutun durumunu gösterir.

Sıralamalar
STATE_UNSPECIFIED Komut durumu belirtilmemiş.
PENDING Geçerliliği dolmamış ve henüz istemciye gönderilmemiş bir komut.
EXPIRED Komut, istemci tarafından beklenen süre içinde yürütülmedi.
CANCELLED Komut, BEKLEMEDE durumundayken yönetici tarafından iptal edildi.
SENT_TO_CLIENT Komut istemciye gönderildi.
ACKED_BY_CLIENT İstemci, komutu aldığını yanıtladı.
EXECUTED_BY_CLIENT İstemci, komutu başarıyla (veya başarısız bir şekilde) yürüttü.

DirectoryChromeosdevicesCommandResult

Bir komutun yürütülmesinin sonucu.

JSON gösterimi 
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
Alanlar
result

enum (CommandResultType)

Komutun sonucu.
executeTime

string (Timestamp format)

Komutun yürütüldüğü veya yürütülemediği zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
errorMessage

string

Komutun neden başarısız olduğuna dair kısa bir açıklama içeren hata mesajı. Yalnızca komut başarısız olduğunda mevcut olur.
commandResultPayload

string

Komut sonucunun yükü. Aşağıdaki komutlar bir yükle yanıt verir:

  • DEVICE_START_CRD_SESSION: Yük, { "url": url } biçiminde dizeleştirilmiş bir JSON nesnesidir. Sağlanan URL, Chrome Uzak Masaüstü oturumuna bağlanır ve yalnızca komutun verilmesiyle ilişkili email kullanılarak kimlik doğrulama gerektirir.
  • FETCH_CRD_AVAILABILITY_INFO: Yük, şu biçimde dizeleştirilmiş bir JSON nesnesidir: { "deviceIdleTimeInSeconds": number, "userSessionType": string, "remoteSupportAvailability": string, "remoteAccessAvailability": string }. "remoteSupportAvailability" alanı, cihaza shared CRD oturumu varsa "AVAILABLE" olarak ayarlanır. Cihaza private CRD oturumu varsa "remoteAccessAvailability" alanı "AVAILABLE" olarak ayarlanır.

CommandResultType

Komut sonucunun türü.

Sıralamalar
COMMAND_RESULT_TYPE_UNSPECIFIED Komut sonucu belirtilmedi.
IGNORED Komut, eski olduğu için yoksayıldı.
FAILURE Komut başarıyla yürütülemedi.
SUCCESS Komut başarıyla yürütüldü.

Yöntemler

get

 Cihaza verilen belirli bir komutun komut verilerini alır.