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. Cela 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. Cela 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 fournies par l'EMM. Une fois l'appareil migré, ces informations seront renseignées dans le champ migrationAdditionalData de la ressource "Appareil". 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 obtenue est 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 du jeton de migration. Ce délai peut être de sept jours au maximum à 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é du jeton de migration. Il s'agit d'un code en entrée uniquement. Pour renvoyer un jeton de migration, le serveur renseigne le champ expireTime. La durée maximale est de sept jours. La valeur par défaut 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 détenu par 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 faire passer un appareil géré par l'outil de contrôle des règles relatives aux appareils (DPC) de l'EMM à l'API Android Management.

get

 Récupère un jeton de migration.

list

 Répertorie les jetons de migration.