REST Resource: enterprises.enrollmentTokens

रिसॉर्स: EnrollmentToken

रजिस्ट्रेशन टोकन.

JSON के काेड में दिखाना
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
फ़ील्ड
name

string

रजिस्टर करने के लिए इस्तेमाल हुए टोकन का नाम. इसे सर्वर बनाते समय जनरेट किया जाता है. यह enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId} फ़ॉर्मैट में होता है.

value

string

टोकन की वह वैल्यू जो डिवाइस को दी जाती है और डिवाइस को रजिस्टर करने की अनुमति देती है. यह सर्वर से जनरेट किया गया रीड-ओनली फ़ील्ड है.

duration

string (Duration format)

रजिस्ट्रेशन टोकन के मान्य होने की अवधि. यह अवधि 1 मिनट से लेकर Durations.MAX_VALUE, यानी करीब 10,000 साल तक हो सकती है. अगर कोई समय तय नहीं किया जाता है, तो डिफ़ॉल्ट तौर पर एक घंटे का समय लागू होता है. कृपया ध्यान दें कि अगर अनुरोध की गई अवधि की वजह से, expirationTimestamp Timestamps.MAX_VALUE से ज़्यादा हो जाता है, तो expirationTimestamp को Timestamps.MAX_VALUE पर सेट कर दिया जाता है.

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

expirationTimestamp

string (Timestamp format)

टोकन की समयसीमा खत्म होने का समय. यह सर्वर से जनरेट किया गया रीड-ओनली फ़ील्ड है.

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

policyName

string

रजिस्टर किए गए डिवाइस पर शुरू में लागू की गई नीति का नाम, enterprises/{enterpriseId}/policies/{policyId} फ़ॉर्मैट में. अगर इसकी जानकारी नहीं दी जाती है, तो डिवाइस के उपयोगकर्ता के लिए policyName लागू किया जाता है. अगर userName की वैल्यू भी नहीं दी गई है, तो डिफ़ॉल्ट रूप से enterprises/{enterpriseId}/policies/default लागू होता है. इस फ़ील्ड को अपडेट करते समय, सिर्फ़ policyId डाला जा सकता है. हालांकि, ऐसा तब ही किया जा सकता है, जब policyId में कोई स्लैश न हो. नीति के बाकी हिस्से का अनुमान लगाया जाएगा.

additionalData

string

रजिस्टर करने के लिए इस्तेमाल हुए टोकन से जुड़ा डेटा. यह डेटा ज़रूरी नहीं है और इसमें कोई भी जानकारी शामिल की जा सकती है. उदाहरण के लिए, इसमें उस संगठन की इकाई का आईडी शामिल हो सकता है जिसे रजिस्टर करने के बाद डिवाइस असाइन किया गया है. जब कोई डिवाइस टोकन की मदद से रजिस्टर हो जाता है, तो यह डेटा Device संसाधन के enrollmentTokenData फ़ील्ड में दिखेगा. डेटा में 1024 या उससे कम वर्ण होने चाहिए. ऐसा न होने पर, डेटा बनाने का अनुरोध पूरा नहीं होगा.

qrCode

string

एक JSON स्ट्रिंग, जिसका UTF-8 वर्शन इस्तेमाल करके, इस रजिस्टर करने वाले टोकन की मदद से किसी डिवाइस को रजिस्टर करने के लिए क्यूआर कोड जनरेट किया जा सकता है. एनएफ़सी का इस्तेमाल करके किसी डिवाइस को रजिस्टर करने के लिए, एनएफ़सी रिकॉर्ड में JSON में प्रॉपर्टी का क्रम से लगाया गया java.util.Properties होना चाहिए.

oneTimeOnly

boolean

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

user
(deprecated)

object (User)

यह फ़ील्ड काम नहीं करता और इसकी वैल्यू को अनदेखा कर दिया जाता है.

allowPersonalUsage

enum (AllowPersonalUsage)

इससे यह कंट्रोल होता है कि इस रजिस्टर करने वाले टोकन से प्रावधान किए गए डिवाइस पर, निजी इस्तेमाल की अनुमति है या नहीं.

कंपनी के मालिकाना हक वाले डिवाइसों के लिए:

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

निजी तौर पर इस्तेमाल किए जाने वाले डिवाइसों के लिए:

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

तरीके

create

किसी एंटरप्राइज़ के लिए रजिस्ट्रेशन टोकन बनाता है.

delete

रजिस्ट्रेशन टोकन मिटाता है.

get

उसे चालू और समयसीमा खत्म न हुआ रजिस्ट्रेशन टोकन मिलता है.

list

किसी एंटरप्राइज़ के लिए, चालू और जिनकी समयसीमा खत्म नहीं हुई है ऐसे रजिस्ट्रेशन टोकन की सूची दिखाता है.