REST Resource: customer.devices.chromeos.commands

المورد: DirectoryChromeosdevicesCommand

تشير هذه السمة إلى معلومات حول أمر تم إصداره لأحد الأجهزة.

تمثيل JSON
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
الحقول
commandId

string (int64 format)

معرّف فريد لأمر جهاز.

type

enum (CommandType)

نوع الأمر.

issueTime

string (Timestamp format)

الطابع الزمني لوقت إصدار الأمر من قِبل المشرف.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

state

enum (State)

يشير إلى حالة الأمر.

commandExpireTime

string (Timestamp format)

وقت انتهاء صلاحية الأمر. إذا لم ينفِّذ الجهاز الأمر خلال هذه الفترة، ستنتهي صلاحية الأمر.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

commandResult

object (DirectoryChromeosdevicesCommandResult)

هي نتيجة تنفيذ الأمر.

payload

string

تمثّل هذه السمة الحمولة التي حدّدها الأمر، إن توفّرت.

CommandType

تحدد نوع الأمر الذي يجب أن ينفذه الجهاز.

عمليات التعداد
COMMAND_TYPE_UNSPECIFIED لم يتم تحديد نوع الأمر.
REBOOT إعادة تشغيل الجهاز يمكن إصداره إلى Kiosk وأجهزة جلسة الضيف المُدارة والأجهزة العادية التي تعمل بالإصدار 113 من ChromeOS أو الإصدارات الأحدث.
TAKE_A_SCREENSHOT خُذ لقطة شاشة للجهاز. لا يتوفّر هذا الإعداد إلا إذا كان الجهاز في وضع Kiosk.
SET_VOLUME اضبط مستوى صوت الجهاز. لا يمكن إصداره إلا على Kiosk وأجهزة جلسة الضيف المُدارة.
WIPE_USERS حجب بيانات جميع المستخدمين من الجهاز. سيؤدي تنفيذ هذا الأمر في الجهاز إلى إزالة جميع بيانات الملفات الشخصية للمستخدم، ولكنه سيحتفظ بسياسة الجهاز وتسجيله.
REMOTE_POWERWASH يمكنك حجب بيانات الجهاز عن طريق إجراء عملية غسل كهربائي. سيؤدي تنفيذ هذا الأمر في الجهاز إلى إزالة جميع البيانات، بما في ذلك سياسات المستخدم وسياسات الأجهزة وسياسات التسجيل. تحذير: سيعيد هذا الإجراء الجهاز إلى حالته الأصلية بدون التسجيل، ما لم يخضع الجهاز للتسجيل التلقائي أو الإجباري. يُرجى توخي الحذر عند استخدام هذا الإجراء لأنّه لا يمكن التراجع عنه.
DEVICE_START_CRD_SESSION يؤدي هذا الاختصار إلى بدء جلسة "سطح المكتب البعيد من Chrome".
CAPTURE_LOGS احتفِظ بسجلّات النظام لجهاز Kiosk. يمكن تنزيل السجلّات من رابط downloadUrl المتوفّر في الحقل deviceFiles على chromeosdevices.
FETCH_SUPPORT_PACKET استرجاع حزمة الدعم من جهاز عن بُعد حزمة الدعم هي أرشيف مضغوط يحتوي على سجلات نظام مختلفة وبيانات تصحيح الأخطاء من جهاز ChromeOS. يمكن تنزيل حزمة الدعم من رابط downloadURL المتوفر في الحقل deviceFiles ضمن chromeosdevices

الحالة

يُمثِّل حالة الأمر الصادر.

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديد حالة الأمر.
PENDING أمر غير منتهي الصلاحية لم يتم إرساله بعد إلى العميل.
EXPIRED لم ينفّذ العميل الأمر خلال الوقت المتوقع.
CANCELLED ألغى المشرف الأمر أثناء وجوده في "معلّق".
SENT_TO_CLIENT تم إرسال الأمر إلى العميل.
ACKED_BY_CLIENT ورد العميل بأنه تلقى الأمر.
EXECUTED_BY_CLIENT نفّذ العميل الأمر (غير) بنجاح.

DirectoryChromeosdevicesCommandResult

هي نتيجة تنفيذ أمر.

تمثيل JSON
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
الحقول
result

enum (CommandResultType)

هي نتيجة الأمر.

executeTime

string (Timestamp format)

وقت تنفيذ الأمر أو تعذّر تنفيذه.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

errorMessage

string

رسالة الخطأ التي تتضمّن شرحًا موجزًا لسبب تعذُّر تنفيذ الأمر. ولا يظهر إلا في حال تعذُّر الأمر.

commandResultPayload

string

الحمولة لنتيجة الأمر. تستجيب الأوامر التالية باستخدام حمولة:

  • DEVICE_START_CRD_SESSION: البيانات الأساسية هي كائن JSON تم ضبطه على شكل سلسلة بالتنسيق التالي: { "url": url }. وسيوفّر عنوان URL رابطًا يؤدي إلى جلسة تطبيق "سطح المكتب البعيد من Chrome".

CommandResultType

نوع نتيجة الأمر.

عمليات التعداد
COMMAND_RESULT_TYPE_UNSPECIFIED لم يتم تحديد نتيجة الأمر.
IGNORED تم تجاهل الأمر باعتباره قديمًا.
FAILURE تعذَّر تنفيذ الأمر بنجاح.
SUCCESS تم تنفيذ الأمر بنجاح.

الطُرق

get

يحصل على بيانات الأمر الذي يصدره أمر محدد للجهاز.