REST Resource: enterprises.migrationTokens

Tài nguyên: Di chuyểnToken

Mã thông báo để bắt đầu quá trình di chuyển thiết bị từ do DPC của bên thứ ba quản lý sang do Android Management API quản lý. Mã di chuyển chỉ hợp lệ với một thiết bị. Hãy xem hướng dẫn để biết thêm thông tin.

Biểu diễn dưới dạng 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.
}
Trường
name

string

Chỉ có đầu ra. Tên của mã thông báo di chuyển (do máy chủ tạo trong quá trình tạo) ở dạng enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Chỉ có đầu ra. Giá trị của mã thông báo di chuyển.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo mã thông báo di chuyển này.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
userId

string

Bắt buộc. Bất biến. Mã nhận dạng người dùng của tài khoản Managed Google Play trên thiết bị, chẳng hạn như trong API EMM của Play. Điều này tương ứng với tham số userId trong lệnh gọi Devices.get của API EMM của Play.
deviceId

string

Bắt buộc. Bất biến. Mã của thiết bị, chẳng hạn như trong API EMM của Play. Điều này tương ứng với tham số deviceId trong lệnh gọi Devices.get của API EMM của Play.
managementMode

enum (ManagementMode)

Bắt buộc. Bất biến. Chế độ quản lý của thiết bị hoặc hồ sơ đang được di chuyển.
policy

string

Bắt buộc. Bất biến. Tên của chính sách được áp dụng ban đầu cho thiết bị đã đăng ký, ở dạng enterprises/{enterprise}/policies/{policy}.
additionalData

string

Bất biến. Dữ liệu bổ sung không bắt buộc do EMM chỉ định. Sau khi di chuyển thiết bị, thông tin này sẽ được điền vào trường migrationAdditionalData của tài nguyên Thiết bị. Tên này phải dài tối đa 1024 ký tự.
device

string

Chỉ có đầu ra. Sau khi mã di chuyển này được dùng để di chuyển một thiết bị, tên của tài nguyên Device thu được sẽ được điền vào đây, dưới dạng enterprises/{enterprise}/devices/{device}.

Trường kết hợp expiration.

expiration chỉ có thể là một trong những trạng thái sau đây:
expireTime

string (Timestamp format)

Bất biến. Thời điểm mã di chuyển này hết hạn. Quá trình này có thể mất tối đa 7 ngày kể từ thời điểm tạo. Mã di chuyển sẽ bị xoá sau 7 ngày kể từ khi hết hạn.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Chỉ nhập. Thời gian mã thông báo di chuyển này có hiệu lực. Đây là tính năng chỉ dùng để nhập dữ liệu và để trả về mã di chuyển, máy chủ sẽ điền sẵn vào trường expireTime. Quá trình này có thể kéo dài tối đa 7 ngày. Mặc định là 7 ngày.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

ManagementMode

Chế độ quản lý của thiết bị hoặc hồ sơ đang được di chuyển.

Enum
MANAGEMENT_MODE_UNSPECIFIED Không được sử dụng giá trị này.
WORK_PROFILE_PERSONALLY_OWNED Một hồ sơ công việc trên một thiết bị cá nhân. Chỉ được hỗ trợ trên các thiết bị chạy Android 9 trở lên.
WORK_PROFILE_COMPANY_OWNED Một hồ sơ công việc trên một thiết bị thuộc sở hữu của công ty. Chỉ được hỗ trợ trên các thiết bị chạy Android 11 trở lên.
FULLY_MANAGED Một thiết bị được quản lý hoàn toàn. Chỉ được hỗ trợ trên các thiết bị chạy Android 9 trở lên.

Phương thức

create

 Tạo mã di chuyển để di chuyển một thiết bị hiện có từ trạng thái chịu sự quản lý của Trình kiểm soát chính sách thiết bị (DPC) của EMM sang thiết bị do Android Management API quản lý.

get

 Nhận mã thông báo di chuyển.

list

 Liệt kê các mã thông báo di chuyển.