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 ของทรัพยากรอุปกรณ์ ข้อความนี้ต้องมีอักขระไม่เกิน 1,024 ตัว
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

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

get

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

list

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