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)

משך הזמן שבו טוקן ההרשמה תקף, שנעה בין דקה אחת ל-Durations.MAX_VALUE, כ-10,000 שנים. אם לא יצוין משך זמן, משך ברירת המחדל הוא שעה אחת. לתשומת ליבך: אם משך הזמן המבוקש גורם ל-expirationTimestamp שנוצר לחרוג מ-Timestamps.MAX_VALUE, הערך של expirationTimestamp יומר ל-Timestamps.MAX_VALUE.

משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s'. דוגמה: "3.5s".
expirationTimestamp

string (Timestamp format)

מועד התפוגה של האסימון. זהו שדה לקריאה בלבד שנוצר על ידי השרת.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
policyName

string

שם המדיניות שהוחלו במקור על המכשיר המשויך, בפורמט enterprises/{enterpriseId}/policies/{policyId}. אם לא יצוין, המערכת תחיל את policyName של משתמש המכשיר. אם גם userName לא צוין, הערך enterprises/{enterpriseId}/policies/default יחול כברירת מחדל. כשמעדכנים את השדה הזה, אפשר לציין רק את policyId כל עוד policyId לא מכיל קווים נטויים. שאר שם המדיניות יוסק.
additionalData

string

נתונים שרירותיים אופציונליים שמשויכים לטוקן ההרשמה. לדוגמה, המזהה יכול להכיל את המזהה של היחידה הארגונית שאליה המכשיר יוקצה אחרי ההרשמה. אחרי שמכשיר נרשם באמצעות הטוקן, הנתונים האלה נחשפים בשדה enrollmentTokenData של המשאב Device. האורך המקסימלי של הנתונים הוא 1,024 תווים. אחרת, בקשת היצירה תיכשל.
qrCode

string

מחרוזת JSON שאפשר להשתמש בייצוג שלה ב-UTF-8 כדי ליצור קוד QR לרישום מכשיר באמצעות טוקן ההרשמה הזה. כדי לרשום מכשיר באמצעות NFC, רשומת ה-NFC חייבת להכיל ייצוג java.util.Properties בסריאליזציה של המאפיינים ב-JSON.
oneTimeOnly

boolean

האם אסימון ההרשמה מיועד לשימוש חד-פעמי בלבד. אם הדגל מוגדר כ-true, רק מכשיר אחד יכול להשתמש בו לרישום.
user
(deprecated)

object (User)

השדה הזה הוצא משימוש והמערכת מתעלמת מהערך שלו.
allowPersonalUsage

enum (AllowPersonalUsage)

קובעת אם מותר להשתמש באופן אישי במכשיר שהוקצה לו טוקן ההרשמה הזה.

במכשירים בבעלות החברה:

  • הפעלת השימוש האישי מאפשרת למשתמש להגדיר פרופיל עבודה במכשיר.
  • כדי להשבית את השימוש האישי, המשתמש צריך להקצות את המכשיר כמכשיר מנוהל במלואו.

במכשירים שבבעלותכם:

  • הפעלת השימוש האישי מאפשרת למשתמש להגדיר פרופיל עבודה במכשיר.
  • השבתת השימוש האישי תמנע את הקצאת המכשיר. אי אפשר להשבית את השימוש האישי במכשיר בבעלות אישית.

Methods

create

 יצירת טוקן רישום לארגון נתון.

delete

 מחיקה של טוקן רישום.

get

 הפונקציה מקבלת אסימון רישום פעיל ותוקף.

list

 רשימה של אסימוני רישום פעילים שעדיין בתוקף בארגון נתון.