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)

वह टाइमस्टैंप जब एडमिन ने निर्देश जारी किया.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

state

enum (State)

कमांड की स्थिति को दिखाता है.

commandExpireTime

string (Timestamp format)

वह समय जब निर्देश की समयसीमा खत्म हो जाएगी. अगर डिवाइस इस समय के अंदर निर्देश लागू नहीं करता है, तो निर्देश की समयसीमा खत्म हो जाएगी.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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 Remote Desktop सेशन शुरू करता है.
CAPTURE_LOGS कीऑस्क डिवाइस के सिस्टम लॉग कैप्चर करें. लॉग को chromeosdevices के deviceFiles फ़ील्ड में मौजूद downloadUrl लिंक से डाउनलोड किया जा सकता है
FETCH_SUPPORT_PACKET दूर से ही किसी डिवाइस से सहायता पैकेट पाएं. सहायता पैकेट एक ज़िप संग्रह है, जिसमें किसी ChromeOS डिवाइस के कई सिस्टम लॉग और डीबग डेटा शामिल होता है. सहायता पैकेट को डाउनलोड यूआरएल लिंक से डाउनलोड किया जा सकता है. यह लिंक, chromeosdevices के deviceFiles फ़ील्ड में मौजूद होता है

स्थिति

जारी किए गए निर्देश की स्थिति दिखाता है.

Enums
STATE_UNSPECIFIED निर्देश की स्थिति के बारे में नहीं बताया गया था.
PENDING समयसीमा खत्म होने से पहले क्लाइंट को कोई निर्देश नहीं भेजा गया है.
EXPIRED क्लाइंट ने तय किए गए समय के अंदर निर्देश नहीं दिया.
CANCELLED PENDING में होने के दौरान एडमिन ने निर्देश को रद्द कर दिया है.
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)

वह समय जब निर्देश चलाया गया या लागू नहीं हुआ.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

errorMessage

string

गड़बड़ी का एक मैसेज, जिसमें यह भी बताया गया है कि निर्देश क्यों नहीं भेजा जा सका. यह सूचना सिर्फ़ तब दिखती है, जब निर्देश नहीं दिया जा सकता हो.

commandResultPayload

string

निर्देश के नतीजे का पेलोड. ये निर्देश, पेलोड के साथ जवाब देते हैं:

  • DEVICE_START_CRD_SESSION: पेलोड, स्ट्रिंग से इस फ़ॉर्मैट में मिला JSON ऑब्जेक्ट है: { "url": url }. यह यूआरएल, Chrome Remote Desktop सेशन का लिंक उपलब्ध कराता है.

CommandResultType

निर्देश के नतीजे का टाइप.

Enums
COMMAND_RESULT_TYPE_UNSPECIFIED निर्देश का नतीजा नहीं बताया गया था.
IGNORED इस निर्देश को पुराना के तौर पर अनदेखा कर दिया गया.
FAILURE आदेश सफलतापूर्वक चलाया नहीं जा सका.
SUCCESS निर्देश सफलतापूर्वक लागू किया गया.

तरीके

get

निर्देश का डेटा हासिल करता है. यह डिवाइस को जारी किया गया कोई निर्देश देता है.