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

نوع فرمانی را که دستگاه باید اجرا کند را تعیین می کند.

Enums
COMMAND_TYPE_UNSPECIFIED نوع فرمان نامشخص بود.
REBOOT دستگاه را راه اندازی مجدد کنید. می‌تواند برای کیوسک و دستگاه‌های جلسه مهمان مدیریت‌شده و دستگاه‌های معمولی دارای ChromeOS نسخه 113 یا جدیدتر صادر شود.
TAKE_A_SCREENSHOT یک اسکرین شات از دستگاه بگیرید. فقط در صورتی در دسترس است که دستگاه در حالت کیوسک باشد.
SET_VOLUME میزان صدای دستگاه را تنظیم کنید. فقط می‌تواند برای کیوسک و دستگاه‌های جلسه مهمان مدیریت‌شده صادر شود.
WIPE_USERS تمام کاربران را از دستگاه پاک کنید. اجرای این دستور در دستگاه، تمام اطلاعات نمایه کاربر را حذف می کند، اما خط مشی دستگاه و ثبت نام را حفظ می کند.
REMOTE_POWERWASH با انجام شستشوی برقی دستگاه را پاک می کند. اجرای این دستور در دستگاه، تمام داده ها از جمله خط مشی های کاربر، خط مشی های دستگاه و خط مشی های ثبت نام را حذف می کند. هشدار: با این کار دستگاه به حالت کارخانه بدون ثبت نام باز می گردد مگر اینکه دستگاه در معرض ثبت نام اجباری یا خودکار باشد. با احتیاط استفاده کنید، زیرا این یک عمل غیرقابل برگشت است!
DEVICE_START_CRD_SESSION یک جلسه دسک‌تاپ از راه دور Chrome را شروع می‌کند.
CAPTURE_LOGS گزارش های سیستم یک دستگاه کیوسک را ضبط کنید. گزارش‌ها را می‌توان از لینک downloadUrl موجود در قسمت deviceFiles دستگاه‌های chromeos دانلود کرد.
FETCH_SUPPORT_PACKET بسته پشتیبانی را از یک دستگاه از راه دور واکشی کنید. بسته پشتیبانی یک بایگانی فشرده است که شامل گزارش‌های مختلف سیستم و داده‌های اشکال‌زدایی از یک دستگاه ChromeOS است. بسته پشتیبانی را می توان از لینک downloadURL موجود در فیلد deviceFiles chromeosdevices دانلود کرد.

ایالت

نشان دهنده وضعیت فرمان صادر شده است.

Enums
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

محموله برای نتیجه فرمان. دستورات زیر با یک payload پاسخ می دهند:

  • DEVICE_START_CRD_SESSION : Payload یک شیء JSON رشته ای به شکل: { "url": url } است. URL پیوندی به جلسه دسک‌تاپ راه دور Chrome ارائه می‌کند.

CommandResultType

نوع نتیجه فرمان

Enums
COMMAND_RESULT_TYPE_UNSPECIFIED نتیجه فرمان نامشخص بود.
IGNORED این دستور به عنوان منسوخ نادیده گرفته شد.
FAILURE دستور با موفقیت اجرا نشد.
SUCCESS دستور با موفقیت اجرا شد.

روش ها

get

 داده های فرمان را یک فرمان خاص صادر شده به دستگاه دریافت می کند.