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 çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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 geçerlilik süresinin sona ereceği zaman. Cihaz bu süre içinde komutu yürütmezse komutun süresi dolar.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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ütmenin 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, ayrıca ChromeOS 113 veya sonraki sürümleri çalıştıran normal cihazlara verilebilir.
TAKE_A_SCREENSHOT Cihazın ekran görüntüsünü alın. Yalnızca cihaz Kiosk modundaysa 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ı silin. Cihazda bu komutun uygulanması, tüm kullanıcı profili verilerini kaldırır ancak cihaz politikası ve kayıt verilerini muhafaza eder.
REMOTE_POWERWASH Güçlü temizleme işlemi gerçekleştirerek cihazı siler. Cihazda bu komutun 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.
DEVICE_START_CRD_SESSION Chrome Uzaktan Masaüstü oturumu başlatır.
CAPTURE_LOGS Kiosk cihazın sistem günlüklerini kaydedin. Günlükler, chromeosdevices deviceFiles alanındaki downloadUrl bağlantısından indirilebilir.
FETCH_CRD_AVAILABILITY_INFO Cihazdaki CRD'nin (Chrome Uzaktan Masaüstü) kullanılabilirliğini belirleyen bilgileri getirir.
FETCH_SUPPORT_PACKET Bir cihazdan uzaktan destek paketi getirme. Destek paketi, bir ChromeOS cihazdaki ç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

Gönderilen komutun durumunu gösterir.

Sıralamalar
STATE_UNSPECIFIED Komut durumu belirtilmedi.
PENDING Süresi dolmamış ancak istemciye henüz gönderilmemiş bir komut.
EXPIRED Komut, istemci tarafından beklenen sürede yürütülmedi.
CANCELLED Komut, BEKLEMEDE durumundayken yönetici tarafından iptal edilir.
SENT_TO_CLIENT Komut istemciye gönderildi.
ACKED_BY_CLIENT İstemci, komutu aldığını yanıtladı.
EXECUTED_BY_CLIENT İstemci, komutu başarıyla (başarısız) yürütmüştür.

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 çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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 mevcuttur.

commandResultPayload

string

Komut sonucunun yükü. Aşağıdaki komutlar bir yükü yanıt olarak gönderir:

  • DEVICE_START_CRD_SESSION: Yük, { "url": url } şeklindeki dizelenmiş bir JSON nesnesi. URL, Chrome Uzaktan Masaüstü oturumunun bağlantısını sağlar.

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

Cihaz için verilen belirli bir komutun komut verilerini alır.