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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
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 ของทรัพยากรอุปกรณ์ ต้องมีอักขระไม่เกิน 1024 ตัว
device

string

เอาต์พุตเท่านั้น เมื่อใช้โทเค็นการย้ายข้อมูลนี้เพื่อย้ายข้อมูลอุปกรณ์ ระบบจะป้อนข้อมูลชื่อของทรัพยากร Device ที่ได้ไว้ที่นี่ในรูปแบบ enterprises/{enterprise}/devices/{device}

ฟิลด์สหภาพ expiration

expiration ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
expireTime

string (Timestamp format)

เปลี่ยนแปลงไม่ได้ เวลาที่โทเค็นการย้ายข้อมูลนี้หมดอายุ ซึ่งต้องไม่เกิน 7 วันนับจากวันที่สร้าง ระบบจะลบโทเค็นการย้ายข้อมูลหลังจากหมดอายุ 7 วัน

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
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

 สร้างโทเค็นการย้ายข้อมูลเพื่อย้ายข้อมูลอุปกรณ์ที่มีอยู่จากการที่ Device Policy Controller (DPC) ของ EMM จัดการให้ได้รับการจัดการโดย Android Management API

get

 รับโทเค็นการย้ายข้อมูล

list

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