REST Resource: enterprises.migrationTokens

Tài nguyên: MigrationToken

Mã thông báo để bắt đầu quá trình di chuyển thiết bị từ trạng thái được quản lý bởi một DPC bên thứ ba sang trạng thái được quản lý bằng Android Management API. Mã 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, được máy chủ tạo trong quá trình tạo, có dạng enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Chỉ có đầu ra. Giá trị của mã 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 ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 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. 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 EMM của Play. Thông số này tương ứng với thông số userId trong lệnh gọi Devices.get của API EMM của Play.
deviceId

string

Bắt buộc. Không thể thay đổi. Mã nhận dạng của thiết bị như trong API Play EMM. Thông số này tương ứng với thông số deviceId trong lệnh gọi Devices.get của API EMM của Play.
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 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ị. Mã này chỉ được 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 ở đây, dưới dạng enterprises/{enterprise}/devices/{device}.

Trường hợp expiration.

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

string (Timestamp format)

Không thể thay đổi. 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, với độ phân giải nano giây và tối đa 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 có hiệu lực của mã thông báo di chuyển này. Đây là giá trị chỉ cho phép nhập dữ liệu và khi trả về mã di chuyển, máy chủ sẽ điền vào trường expireTime. Quá trình này có thể kéo dài tối đa 7 ngày. Khoảng thời gian 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ố thập phân, 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 Hồ sơ công việc trên thiết bị thuộc sở hữu của 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ị thuộc quyền 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ý toàn bộ. 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 do Trình kiểm soát chính sách thiết bị (DPC) của EMM quản lý sang do Android Management API quản lý.

get

 Nhận mã di chuyển.

list

 Liệt kê mã di chuyển.