Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Effectuez la migration sur les canaux existants ou les nouveaux canaux. Au départ, les opérations de migration complètes étaient limitées aux canaux standard nouvellement créés à l’aide de modèles de migration spécifiquement conçus pour le processus de migration initial. Pour plus d’informations, consultez Importer des messages de plateforme tierce dans Teams à l’aide de Microsoft Graph.
Tenez compte des points suivants lors de la fin de la migration pour les canaux nouveaux et existants :
- Lorsqu’un canal est créé en mode de migration pour le flux d’importation initial, la propriété migrationMode d’un canal d’une équipe est mise à
completedjour vers au lieu d’être supprimée, et l’état est définitivement marqué pour les conversations ou les canaux. Le mode de migration est un état spécial qui empêche certaines opérations, telles que l’envoi de messages et l’ajout de membres, pendant le processus de migration des données. Le équipe parente n’est pas marqué avec le mode de migration, car les équipes ne peuvent pas passer en mode de migration ; seuls leurs canaux enfants (général, standard, privé et partagé) le peuvent. - Pour les canaux existants qui sont déjà en mode migration, l’API termine le processus de migration des messages en mettant à jour migrationMode vers
completedpour un canal dans une équipe.
Une fois qu’une demande completeMigration est effectuée pour les canaux existants ou nouveaux, vous pouvez toujours importer d’autres messages dans l’équipe en appelant le canal : startMigration.
Cette API prend en charge les types de canaux suivants.
| Entités | Sous-type | Prise en charge du mode de migration | Notes |
|---|---|---|---|
| Canaux | Standard, Privé, Partagé | Nouveaux et existants | Les canaux doivent être créés ou déjà en mode migration. |
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
| Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | Non prise en charge. | Non prise en charge. |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | Teamwork.Migrate.All | Non disponible. |
Requête HTTP
POST /teams/{team-id}/channels/{channel-id}/completeMigration
En-têtes de demande
| En-tête | Valeur |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content. Il ne retourne rien dans le corps de la réponse.
Exemples
Exemple 1 : Terminer la migration lorsqu’un canal est en mode de migration
L’exemple suivant montre comment effectuer la migration lorsqu’un canal est en mode migration.
Demande
L’exemple suivant illustre une demande.
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/completeMigration
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 204 No Content
Exemple 2 : Terminer la migration lorsqu’un canal n’est pas en mode de migration
L’exemple suivant montre comment effectuer la migration lorsqu’un canal n’est pas en mode migration. Cette demande échoue avec une 400 Bad Request réponse.
Demande
L’exemple suivant illustre une demande.
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/completeMigration
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 400 Bad Request