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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

state

enum (State)

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

commandExpireTime

string (Timestamp format)

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

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

commandResult

object (DirectoryChromeosdevicesCommandResult)

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

payload

string

الحمولة التي حددها الأمر، إن وجدت.

CommandType

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

عمليات التعداد
COMMAND_TYPE_UNSPECIFIED لم يتم تحديد نوع الأمر.
REBOOT يُرجى إعادة تشغيل الجهاز. لا يمكن إصدار هذا الحساب إلا لأجهزة Kiosk وأجهزة جلسات الضيف المُدارة.
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 استرجاع حزمة الدعم من جهاز عن بُعد حزمة الدعم هي أرشيف ZIP يحتوي على سجلات نظام مختلفة وبيانات تصحيح الأخطاء من جهاز 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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

يحصل على بيانات الأوامر التي يتم إصدارها للجهاز من خلال أمر محدّد.