REST Resource: enterprises.migrationTokens

משאב: MigrationToken

אסימון ליזום העברה של מכשיר כך שלא ינוהל על ידי בקר DPC של צד שלישי לניהול באמצעות Android Management API. אסימון ההעברה תקף רק למכשיר אחד. פרטים נוספים זמינים במדריך.

ייצוג JSON 
{
  "name": string,
  "value": string,
  "createTime": string,
  "userId": string,
  "deviceId": string,
  "managementMode": enum (ManagementMode),
  "policy": string,
  "additionalData": string,
  "device": string,

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
שדות
name

string

פלט בלבד. השם של אסימון ההעברה, שנוצר על ידי השרת במהלך היצירה, בפורמט enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

פלט בלבד. הערך של אסימון ההעברה.
createTime

string (Timestamp format)

פלט בלבד. השעה שבה נוצר אסימון ההעברה.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
userId

string

חובה. קבוע. מזהה המשתמש של חשבון Google Play המנוהל במכשיר, כמו ב-Play EMM API. הוא תואם לפרמטר userId בקריאה של Play EMM API ל-Devices.get.
deviceId

string

חובה. בלתי ניתן לשינוי. המזהה של המכשיר, כמו ב-Play EMM API. הפרמטר הזה תואם לפרמטר deviceId בקריאה Devices.get של Play EMM API.
managementMode

enum (ManagementMode)

חובה. קבוע. מצב הניהול של המכשיר או הפרופיל שמועברים.
policy

string

חובה. קבוע. שם המדיניות שהוחלו במקור על המכשיר המשויך, בפורמט enterprises/{enterprise}/policies/{policy}.
additionalData

string

בלתי ניתן לשינוי. נתונים נוספים אופציונליים שצוינו על ידי ה-EMM. אחרי העברת המכשיר, השדה migrationAdditionalData של המשאב Device יאוכלס. האורך המקסימלי של השדה הזה הוא 1,024 תווים.
device

string

פלט בלבד. אחרי שמשתמשים באסימון ההעברה הזה כדי להעביר מכשיר, השם של משאב ה-Device שנוצר יאוכלס כאן, בטופס enterprises/{enterprise}/devices/{device}.

שדה איחוד expiration.

הערך של expiration יכול להיות רק אחת מהאפשרויות הבאות:
expireTime

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

קלט בלבד. פרק הזמן שבו אסימון ההעברה הזה תקף. זהו שדה קלט בלבד, וכדי להחזיר טוקן העברה, השרת יאכלס את השדה expireTime. התהליך יכול להימשך עד שבעה ימים. ברירת המחדל היא שבעה ימים.

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

ManagementMode

מצב הניהול של המכשיר או הפרופיל שרוצים להעביר.

טיפוסים בני מנייה (enum)
MANAGEMENT_MODE_UNSPECIFIED אסור להשתמש בערך הזה.
WORK_PROFILE_PERSONALLY_OWNED פרופיל עבודה במכשיר בבעלות אישית. התכונה נתמכת רק במכשירים עם Android מגרסה 9 ואילך.
WORK_PROFILE_COMPANY_OWNED פרופיל עבודה במכשיר בבעלות החברה. התכונה נתמכת רק במכשירים עם Android מגרסה 11 ואילך.
FULLY_MANAGED מכשיר מנוהל באופן מלא. התכונה נתמכת רק במכשירים עם Android מגרסה 9 ואילך.

שיטות

create

 יצירת אסימון העברה, כדי להעביר מכשיר קיים מהניהול של בקר מדיניות המכשירים (DPC) של ה-EMM לניהול על ידי Android Management API.

get

 מקבל טוקן העברה.

list

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