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)

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

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

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

enum (ManagementMode)

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

string

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

string

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

string

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

שדה איחוד expiration.

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

string (Timestamp format)

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

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

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'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

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