REST Resource: enterprises.enrollmentTokens

משאב: RegisterToken

אסימון רישום.

ייצוג 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)

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

חותמת זמן ב-RFC3339 UTC '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

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

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