REST Resource: enterprises.migrationTokens

संसाधन: MigrationToken

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

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

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

आरएफ़सी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

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

get

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

list

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