REST Resource: enterprises.migrationTokens

Ressource: MigrationToken

Jeton permettant de lancer la migration d'un appareil, passant de la gestion par un DPC tiers à la gestion par l'API Android Management. Un jeton de migration n'est valide que pour un seul appareil. Pour en savoir plus, consultez le guide.

Représentation 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.
}
Champs
name

string

Uniquement en sortie. Nom du jeton de migration, généré par le serveur lors de la création, au format enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Uniquement en sortie. Valeur du jeton de migration.
createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle ce jeton de migration a été créé.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
userId

string

Obligatoire. Immuable. ID utilisateur du compte Google Play d'entreprise sur l'appareil, comme dans l'API Play EMM. Il correspond au paramètre userId de l'appel Devices.get de l'API Play EMM.
deviceId

string

Obligatoire. Immuable. ID de l'appareil, comme dans l'API Play EMM. Il correspond au paramètre deviceId de l'appel Devices.get de l'API Play EMM.
managementMode

enum (ManagementMode)

Obligatoire. Immuable. Mode de gestion de l'appareil ou du profil en cours de migration.
policy

string

Obligatoire. Immuable. Nom de la règle initialement appliquée à l'appareil enregistré, au format enterprises/{enterprise}/policies/{policy}.
additionalData

string

Immuable. Données supplémentaires facultatives spécifiées par l'EMM. Une fois l'appareil migré, ce champ sera renseigné dans le champ migrationAdditionalData de la ressource Device. Il ne doit pas dépasser 1 024 caractères.
device

string

Uniquement en sortie. Une fois ce jeton de migration utilisé pour migrer un appareil, le nom de la ressource Device générée sera renseigné ici, au format enterprises/{enterprise}/devices/{device}.

Champ d'union expiration.

expiration ne peut être qu'un des éléments suivants :
expireTime

string (Timestamp format)

Immuable. Heure d'expiration de ce jeton de migration. Ce délai ne peut pas dépasser sept jours à compter de la date de création. Le jeton de migration est supprimé sept jours après son expiration.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Uniquement en entrée. Durée de validité de ce jeton de migration. Il s'agit d'une entrée uniquement. Pour renvoyer un jeton de migration, le serveur renseigne le champ expireTime. Cette période ne peut pas dépasser sept jours. Par défaut, la durée est de sept jours.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

ManagementMode

Mode de gestion de l'appareil ou du profil en cours de migration.

Enums
MANAGEMENT_MODE_UNSPECIFIED Cette valeur ne doit pas être utilisée.
WORK_PROFILE_PERSONALLY_OWNED Un profil professionnel sur un appareil personnel Compatible uniquement avec les appareils équipés d'Android 9 ou version ultérieure.
WORK_PROFILE_COMPANY_OWNED Un profil professionnel sur un appareil appartenant à l'entreprise. Compatible uniquement avec les appareils équipés d'Android 11 ou version ultérieure.
FULLY_MANAGED Un appareil entièrement géré Compatible uniquement avec les appareils équipés d'Android 9 ou version ultérieure.

Méthodes

create

 Crée un jeton de migration pour migrer un appareil existant de l'outil de contrôle des règles relatives aux appareils (DPC) de l'EMM vers l'API Android Management.

get

 Permet d'obtenir un jeton de migration.

list

 Répertorie les jetons de migration.