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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

נתונים שרירותיים ואופציונליים שמשויכים לאסימון הרישום. לדוגמה, המזהה יכול להכיל את המזהה של יחידה ארגונית שהמכשיר מוקצה אליה אחרי ההרשמה. אחרי שמכשיר נרשם באמצעות הטוקן, הנתונים האלה ייחשפו בשדה 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)

המדיניות קובעת אם שימוש אישי מותר במכשיר שהוקצה באמצעות אסימון הרישום הזה.

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

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

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

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

שיטות

create

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

delete

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

get

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

list

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