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

필수 항목입니다. 변경할 수 없습니다. Play EMM API에서와 같이 기기에 있는 관리 Google Play 계정의 사용자 ID입니다. 이는 Play EMM API의 Devices.get 호출에 있는 userId 매개변수에 해당합니다.

deviceId

string

필수 항목입니다. 변경할 수 없습니다. Play EMM API와 마찬가지로 기기의 ID입니다. Play EMM API의 Devices.get 호출의 deviceId 매개변수에 상응합니다.

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

이전되는 기기 또는 프로필의 관리 모드입니다.

열거형
MANAGEMENT_MODE_UNSPECIFIED 이 값은 사용하면 안 됩니다.
WORK_PROFILE_PERSONALLY_OWNED 개인 소유 기기의 직장 프로필 Android 9 이상을 실행하는 기기에서만 지원됩니다.
WORK_PROFILE_COMPANY_OWNED 회사 소유 기기의 직장 프로필 Android 11 이상을 실행하는 기기에서만 지원됩니다.
FULLY_MANAGED 완전 관리형 기기 Android 9 이상을 실행하는 기기에서만 지원됩니다.

메서드

create

이전 토큰을 생성하여 기존 기기를 EMM의 기기 정책 컨트롤러 (DPC)에서 관리하는 방식에서 Android Management API로 관리하는 기기로 이전합니다.

get

이전 토큰을 가져옵니다.

list

이전 토큰을 나열합니다.