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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
userId

string

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

string

חובה. בלתי משתנה. מזהה המכשיר, כמו ב-Play EMM API. הערך הזה תואם לפרמטר deviceId בקריאה ל-Devices.get של Play EMM API.
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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

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

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

ManagementMode

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

טיפוסים בני מנייה (enums)
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

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