REST Resource: enterprises.migrationTokens

संसाधन: MigrationToken

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

जेएसओएन के काेड में दिखाना 
{
  "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)

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

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

string

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

string

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

enum (ManagementMode)

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

string

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

string

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

string

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

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

expiration इनमें से सिर्फ़ एक हो सकती है:
expireTime

string (Timestamp format)

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

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "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

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

get

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

list

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