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

המטען הייעודי (payload) שצוין בפקודה, אם קיים.

CommandType

המדיניות הזו קובעת את סוג הפקודה שהמכשיר צריך לבצע.

טיפוסים בני מנייה (enums)
COMMAND_TYPE_UNSPECIFIED סוג הפקודה לא צוין.
REBOOT יש להפעיל מחדש את המכשיר. אפשר להנפיק רק למכשירים במצב קיוסק ולמכשירים מנוהלים עם גלישה מנוהלת כאורח.
TAKE_A_SCREENSHOT מצלמים את המסך של המכשיר. האפשרות הזו זמינה רק אם המכשיר נמצא במצב קיוסק.
SET_VOLUME הגדרת עוצמת הקול של המכשיר. אפשר להנפיק רק למכשירים במצב קיוסק ולמכשירים מנוהלים עם גלישה מנוהלת כאורח.
WIPE_USERS למחוק את כל המשתמשים מהמכשיר. הרצת הפקודה הזו במכשיר תסיר את כל נתוני הפרופיל של המשתמש, אבל תשמור על מדיניות המכשיר ועל הרישום שלו.
REMOTE_POWERWASH איפוס המכשיר על ידי ביצוע שטיפה חשמלית. הרצת הפקודה הזו במכשיר תסיר את כל הנתונים, כולל מדיניות המשתמש, מדיניות המכשיר וכללי מדיניות הרישום. אזהרה: פעולה זו תחזיר את המכשיר להגדרות היצרן שלו ללא רישום, אלא אם המכשיר כפוף לרישום מאולץ או אוטומטי. חשוב להפעיל שיקול דעת לפני שפעולה זו היא בלתי הפיכה.
DEVICE_START_CRD_SESSION מתחיל סשן של Chrome Remote Desktop.
CAPTURE_LOGS תיעוד יומני המערכת של מכשיר קיוסק. ניתן להוריד את היומנים באמצעות הקישור downloadUrl שמופיע בשדה deviceFiles ב-chromeosdevices
FETCH_SUPPORT_PACKET אחזור חבילת תמיכה ממכשיר מרחוק. חבילת תמיכה היא ארכיון ZIP שמכיל יומני מערכת שונים ונתוני ניפוי באגים ממכשיר ChromeOS. ניתן להוריד את חבילת התמיכה מהקישור של כתובת ה-URL להורדה שנמצא בשדה 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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
errorMessage

string

הודעת השגיאה עם הסבר קצר למה הפקודה נכשלה. מוצג רק אם הפקודה נכשלה.
commandResultPayload

string

המטען הייעודי (payload) של תוצאת הפקודה. הפקודות הבאות מגיבות באמצעות מטען ייעודי (payload):

  • DEVICE_START_CRD_SESSION: מטען ייעודי (payload) הוא אובייקט JSON ממחרוזת בפורמט: { "url": url }. כתובת ה-URL מספקת קישור לסשן של Chrome Remote Desktop.

CommandResultType

הסוג של תוצאת הפקודה.

טיפוסים בני מנייה (enums)
COMMAND_RESULT_TYPE_UNSPECIFIED תוצאת הפקודה לא צוינה.
IGNORED המערכת התעלמה מהפקודה כמיושנת.
FAILURE לא ניתן היה לבצע את הפקודה בהצלחה.
SUCCESS הפקודה בוצעה בהצלחה.

שיטות

get

 מקבל את נתוני הפקודות של פקודה ספציפית שהונפקה למכשיר.