REST Resource: enterprises.migrationTokens

منبع: MigrationToken

رمزی برای شروع انتقال یک دستگاه از مدیریت شدن توسط یک DPC شخص ثالث به مدیریت API مدیریت Android. رمز مهاجرت فقط برای یک دستگاه معتبر است. برای جزئیات بیشتر به راهنما مراجعه کنید.

نمایندگی 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)

فقط خروجی زمانی که این نشانه مهاجرت ایجاد شد.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

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 منبع دستگاه پر می شود. این باید حداکثر 1024 کاراکتر باشد.

device

string

فقط خروجی هنگامی که این نشانه انتقال برای انتقال یک دستگاه استفاده می‌شود، نام منبع Device حاصل در اینجا پر می‌شود، به شکل enterprises/{enterprise}/devices/{device} .

expiration میدان اتحادیه

expiration فقط می تواند یکی از موارد زیر باشد:

expireTime

string ( Timestamp format)

تغییرناپذیر. زمانی که این نشانه مهاجرت منقضی می شود. این می تواند حداکثر هفت روز از زمان خلقت باشد. رمز مهاجرت هفت روز پس از انقضا حذف می شود.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

ttl

string ( Duration format)

فقط ورودی زمانی که این رمز مهاجرت برای آن معتبر است. این فقط ورودی است، و برای برگرداندن یک نشانه مهاجرت، سرور قسمت expireTime را پر می کند. این می تواند حداکثر هفت روز باشد. پیش فرض هفت روز است.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

حالت مدیریت

حالت مدیریت دستگاه یا نمایه در حال انتقال.

Enums
MANAGEMENT_MODE_UNSPECIFIED این مقدار نباید استفاده شود.
WORK_PROFILE_PERSONALLY_OWNED یک نمایه کاری در دستگاه شخصی. فقط در دستگاه های دارای Android 9 و بالاتر پشتیبانی می شود.
WORK_PROFILE_COMPANY_OWNED نمایه کاری در دستگاه متعلق به شرکت. فقط در دستگاه های دارای Android 11 و بالاتر پشتیبانی می شود.
FULLY_MANAGED یک دستگاه کاملاً مدیریت شده فقط در دستگاه های دارای Android 9 و بالاتر پشتیبانی می شود.

روش ها

create

 یک نشانه انتقال ایجاد می‌کند تا یک دستگاه موجود را از مدیریت کردن توسط کنترلر سیاست دستگاه EMM (DPC) به مدیریت API مدیریت Android منتقل کند.

get

 یک نشانه مهاجرت دریافت می کند.

list

 نشانه های مهاجرت را فهرست می کند.