REST Resource: enterprises.migrationTokens

Tài nguyên: MigrationToken

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

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 gian tạo mã thông báo di chuyển này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
userId

string

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

string

Bắt buộc. Không thể thay đổi. 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 Play EMM.
managementMode

enum (ManagementMode)

Bắt buộc. Không thể thay đổi. Chế độ quản lý của thiết bị hoặc hồ sơ đang được di chuyển.
policy

string

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

string

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

string

Chỉ có đầu ra. Sau khi mã thông báo 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ạng enterprises/{enterprise}/devices/{device}.

Trường hợp hợp nhất expiration.

expiration chỉ có thể là một trong những giá trị sau:
expireTime

string (Timestamp format)

Bất biến. Thời điểm mã thông báo 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 ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Chỉ nhập. Thời gian hiệu lực của mã thông báo di chuyển này. Đây là giá trị chỉ nhập và để trả về mã thông báo di chuyển, máy chủ sẽ điền trường expireTime. Quá trình này có thể mất tối đa 7 ngày. Giá trị 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 Hồ sơ công việc trên thiết bị do công ty sở hữu. Chỉ hỗ trợ trên các thiết bị chạy Android 11 trở lên.
FULLY_MANAGED 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ã thông báo di chuyển để di chuyển một thiết bị hiện có từ việc được Trình điều khiển chính sách thiết bị (DPC) của EMM quản lý sang việc được Android Management API quản lý.

get

 Lấy mã thông báo di chuyển.

list

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