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)

เอาต์พุตเท่านั้น เวลาที่สร้างโทเค็นการย้ายข้อมูลนี้

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสผู้ใช้ของบัญชี Managed 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 วันนับจากวันที่สร้าง ระบบจะลบโทเค็นการย้ายข้อมูลหลังจากหมดอายุ 7 วัน

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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 เพื่อแสดงโทเค็นการย้ายข้อมูล โดยใช้เวลาไม่เกิน 7 วัน ค่าเริ่มต้นคือ 7 วัน

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 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

 แสดงรายการโทเค็นการย้ายข้อมูล