REST Resource: enterprises.migrationTokens

Ressource: MigrationToken

Jeton permettant de lancer la migration d'un appareil qui n'est plus géré par un DPC tiers, mais géré 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. Date et heure de création de ce jeton de migration.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. 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 EMM Play. Il correspond au paramètre userId dans l'appel Devices.get de l'API EMM Play.
deviceId

string

Obligatoire. Immuable. ID de l'appareil, comme dans l'API EMM Play. Il correspond au paramètre deviceId dans l'appel Devices.get de l'API EMM Play.
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 EMM. Une fois l'appareil migré, ce champ sera renseigné dans le champ migrationAdditionalData de la ressource de l'appareil. Il ne doit pas comporter plus de 1 024 caractères.
device

string

Uniquement en sortie. Une fois que ce jeton de migration aura été utilisé pour migrer un appareil, le nom de la ressource Device obtenue 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. Date et heure d'expiration de ce jeton de migration. Cette opération peut prendre jusqu'à sept jours à compter de la date de création. Le jeton de migration est supprimé sept jours après son expiration.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Uniquement en entrée. Heure de validité de ce jeton de migration. Il ne s'agit que d'une entrée. Pour renvoyer un jeton de migration, le serveur renseigne le champ expireTime. Ce délai peut atteindre sept jours. La valeur par défaut est de sept jours.

Durée en secondes avec un maximum de neuf chiffres après la virgule, 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 permettre à un appareil existant d'être géré par l'outil de contrôle des règles relatives aux appareils (DPC) de l'EMM vers l'API Android Management.

get

 Récupère un jeton de migration.

list

 Répertorie les jetons de migration.