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)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 و3 و6 و9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
state

enum (State)

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

string (Timestamp format)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 و3 و6 و9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
commandResult

object (DirectoryChromeosdevicesCommandResult)

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

string

الحِمل الذي حدّده الأمر، إن وُجد

CommandType

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

عمليات التعداد
COMMAND_TYPE_UNSPECIFIED لم يتم تحديد نوع الأمر.
REBOOT أعِد تشغيل الجهاز. يمكن إصدارها لأجهزة Kiosk وأجهزة جلسات الضيوف المُدارة والأجهزة العادية التي تعمل بالإصدار 113 من نظام التشغيل ChromeOS أو الإصدارات الأحدث.
TAKE_A_SCREENSHOT التقِط لقطة شاشة للجهاز. لا يتوفّر هذا الخيار إلا إذا كان الجهاز في "وضع Kiosk".
SET_VOLUME ضبط مستوى صوت الجهاز لا يمكن إصدارها إلا لأجهزة Kiosk وجلسات الضيوف المُدارة.
WIPE_USERS حجب بيانات جميع المستخدمين من الجهاز سيؤدي تنفيذ هذا الأمر على الجهاز إلى إزالة جميع بيانات الملفات الشخصية للمستخدمين، مع الاحتفاظ بسياسة الجهاز وبيانات التسجيل.
REMOTE_POWERWASH محو بيانات الجهاز من خلال تنفيذ عملية Powerwash، ما يؤدي إلى إزالة جميع البيانات، بما في ذلك سياسات المستخدمين وسياسات الأجهزة وسياسات التسجيل. تحذير: سيعيد هذا الإجراء الجهاز إلى حالته الأصلية بدون تسجيل، إلا إذا كان الجهاز خاضعًا للتسجيل الإلزامي أو التلقائي. يجب توخّي الحذر، لأنّ هذا الإجراء لا يمكن التراجع عنه.
DEVICE_START_CRD_SESSION يبدأ جلسة "الوصول إلى الكمبيوتر المكتبي عن بُعد من Chrome".
CAPTURE_LOGS حفظ سجلّات النظام لجهاز Kiosk يمكن تنزيل السجلات من رابط downloadUrl المتوفّر في الحقل deviceFiles ضمن chromeosdevices.
FETCH_CRD_AVAILABILITY_INFO يجلب هذا الإجراء أنواع جلسات "سطح المكتب البعيد من Chrome" المتاحة (خاصة أو مشترَكة) التي يمكن استخدامها للاتصال بالجهاز عن بُعد.
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)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 و3 و6 و9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
errorMessage

string

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

string

حمولة نتيجة الأمر تستجيب الأوامر التالية بحِمل:

  • DEVICE_START_CRD_SESSION: الحمولة هي عنصر JSON محوّل إلى سلسلة بالصيغة: { "url": url }. يؤدي عنوان URL المقدَّم إلى جلسة "سطح المكتب البعيد من Chrome" ويتطلّب المصادقة باستخدام email المرتبط بإصدار الأمر فقط.
  • FETCH_CRD_AVAILABILITY_INFO: الحمولة هي كائن JSON محوَّل إلى سلسلة بالصيغة: { "deviceIdleTimeInSeconds": number, "userSessionType": string, "remoteSupportAvailability": string, "remoteAccessAvailability": string }. يتم ضبط الحقل "remoteSupportAvailability" على "AVAILABLE" إذا كانت جلسة shared CRD متاحة على الجهاز. يتم ضبط الحقل "remoteAccessAvailability" على "AVAILABLE" إذا كانت جلسة private CRD متاحة للجهاز.

CommandResultType

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

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

الطُرق

get

 تعرض هذه السمة بيانات أمر معيّن تم إصداره للجهاز.