REST Resource: enterprises.migrationTokens

संसाधन: MigrationToken

तीसरे पक्ष के डीपीसी से Android Management API पर माइग्रेट करने के लिए टोकन. माइग्रेशन टोकन सिर्फ़ एक डिवाइस के लिए मान्य होता है. ज़्यादा जानकारी के लिए, गाइड देखें.

JSON के काेड में दिखाना
{
  "name": string,
  "value": string,
  "createTime": string,
  "userId": string,
  "deviceId": string,
  "managementMode": enum (ManagementMode),
  "policy": string,
  "additionalData": string,
  "device": string,

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. माइग्रेशन टोकन का नाम, जो सर्वर बनाते समय सर्वर से enterprises/{enterprise}/migrationTokens/{migrationToken} के तौर पर जनरेट होता है.

value

string

सिर्फ़ आउटपुट के लिए. माइग्रेशन टोकन की वैल्यू.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब यह माइग्रेशन टोकन बनाया गया.

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

userId

string

ज़रूरी है. इम्यूटेबल. डिवाइस पर मौजूद, मैनेज किए जा रहे Google Play खाते का यूज़र आईडी, जैसा कि Play EMM API में है. यह Play EMM API के Devices.get कॉल में मौजूद userId पैरामीटर से मेल खाता है.

deviceId

string

ज़रूरी है. इम्यूटेबल. डिवाइस का आईडी, जैसा कि Play EMM API में है. यह Play EMM API के Devices.get कॉल में मौजूद deviceId पैरामीटर से मेल खाता है.

managementMode

enum (ManagementMode)

ज़रूरी है. इम्यूटेबल. माइग्रेट किए जा रहे डिवाइस या प्रोफ़ाइल का मैनेजमेंट मोड.

policy

string

ज़रूरी है. इम्यूटेबल. रजिस्टर किए गए डिवाइस पर शुरू में लागू की गई नीति का नाम, enterprises/{enterprise}/policies/{policy} फ़ॉर्मैट में.

additionalData

string

इम्यूटेबल. ईएमएम से मिला अतिरिक्त डेटा, जो ज़रूरी नहीं है. डिवाइस माइग्रेट होने के बाद, यह डिवाइस संसाधन के migrationAdditionalData फ़ील्ड में अपने-आप भर जाएगा. इसमें ज़्यादा से ज़्यादा 1,024 वर्ण होने चाहिए.

device

string

सिर्फ़ आउटपुट के लिए. किसी डिवाइस को माइग्रेट करने के लिए इस माइग्रेशन टोकन का इस्तेमाल करने के बाद, Device रिसॉर्स का नाम यहां enterprises/{enterprise}/devices/{device} फ़ॉर्म में दिखेगा.

यूनियन फ़ील्ड expiration.

expiration इनमें से कोई एक हो सकता है:

expireTime

string (Timestamp format)

इम्यूटेबल. इस माइग्रेशन टोकन की समयसीमा खत्म होने का समय. सदस्यता लेने के बाद, ज़्यादा से ज़्यादा सात दिन लग सकते हैं. माइग्रेशन टोकन की समयसीमा खत्म होने के सात दिन बाद, उसे मिटा दिया जाता है.

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

ttl

string (Duration format)

सिर्फ़ इनपुट के लिए. यह समय कि माइग्रेशन टोकन कब तक मान्य है. यह सिर्फ़ इनपुट के लिए है. माइग्रेशन टोकन दिखाने के लिए, सर्वर expireTime फ़ील्ड को पॉप्युलेट करेगा. इसमें ज़्यादा से ज़्यादा सात दिन लग सकते हैं. डिफ़ॉल्ट रूप से, यह अवधि सात दिन होती है.

सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि 's' पर खत्म होती है. उदाहरण: "3.5s".

ManagementMode

माइग्रेट किए जा रहे डिवाइस या प्रोफ़ाइल का मैनेजमेंट मोड.

Enums
MANAGEMENT_MODE_UNSPECIFIED इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए.
WORK_PROFILE_PERSONALLY_OWNED निजी तौर पर इस्तेमाल किए जाने वाले डिवाइस पर वर्क प्रोफ़ाइल. यह सुविधा सिर्फ़ Android 9 और उसके बाद के वर्शन वाले डिवाइसों पर काम करती है.
WORK_PROFILE_COMPANY_OWNED कंपनी के मालिकाना हक वाले डिवाइस पर वर्क प्रोफ़ाइल. यह सुविधा सिर्फ़ Android 11 और उसके बाद के वर्शन वाले डिवाइसों पर काम करती है.
FULLY_MANAGED पूरी तरह से मैनेज किया जाने वाला डिवाइस. यह सुविधा, सिर्फ़ Android 9 और इसके बाद के वर्शन वाले डिवाइसों पर काम करती है.

तरीके

create

यह माइग्रेशन टोकन बनाता है, ताकि किसी मौजूदा डिवाइस को EMM के डिवाइस नीति कंट्रोलर (डीपीसी) से Android Management API पर माइग्रेट किया जा सके.

get

माइग्रेशन टोकन मिलता है.

list

यह माइग्रेशन टोकन की सूची बनाता है.