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)

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

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

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

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

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

Methods

create

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

delete

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

get

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

list

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