team : cloner

  • Article

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 .

Créez une copie d’une équipe. Cette opération crée également une copie du groupe correspondant. Vous pouvez spécifier les parties de l’équipe à cloner :

  • applications : copie les applications Microsoft Teams installées dans l’équipe.
  • channels : copie la structure du canal (mais pas les messages dans le canal).
  • members : copie les membres et les propriétaires du groupe.
  • settings : copie tous les paramètres de l’équipe, ainsi que les paramètres de groupe clés.
  • tabs : copie les onglets dans les canaux.

Note: Cette méthode n’est pas prise en charge pour les équipes organization.

Remarque

Un problème connu lié aux propriétaires d’équipes clonées est associé à cette méthode. Pour plus d’informations, voir Problèmes connus.

Lorsque les onglets sont cloné, ils ne sont pas configurés. Les onglets sont affichés dans la barre d’onglets dans Microsoft Teams et, la première fois qu’un utilisateur les ouvre, ils doivent passer par l’écran de configuration. Si l’utilisateur qui ouvre l’onglet n’a pas l’autorisation de configurer des applications, il voit un message indiquant que l’onglet n’est pas configuré.

Le clonage est une opération de longue durée. Une fois le clone POST retourné, vous devez OBTENIR l’opération retournée par l’en-tête Location: pour voir s’il s’agit runningde , succeededou failed. Vous devez continuer à obtenir jusqu’à ce que le status ne soit pas running. Le délai recommandé entre les GET est de 5 secondes.

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) Team.Create Directory.ReadWrite.All, Group.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Team.Create Directory.ReadWrite.All, Group.ReadWrite.All

Remarque

Les autorisations Group.ReadWrite.All et Directory.ReadWrite.All sont prises en charge uniquement pour la compatibilité descendante. Nous vous recommandons de mettre à jour vos solutions pour utiliser une autorisation différente répertoriée dans le tableau précédent et d’éviter d’utiliser ces autorisations à l’avenir.

Requête HTTP

POST /teams/{id}/clone

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json

Corps de la demande

Propriété Type Description
classification Chaîne (facultatif) Décrit une classification pour le groupe (par exemple, impact faible, moyen ou élevé sur l’activité). Les valeurs valides pour cette propriété sont définies en créant une valeur de paramètre ClassificationList, basée sur la définition du modèle. Si la classification n’est pas spécifiée, la classification est copiée à partir de l’équipe ou du groupe d’origine.
description Chaîne (facultatif) Description facultative du groupe. Si cette propriété n’est pas spécifiée, elle est laissée vide.
displayName String Nom complet du groupe. Cette propriété est requise lorsqu’un groupe est créé et qu’il ne peut pas être effacé pendant les mises à jour. Prend en charge $filter et $orderby.
mailNickname Chaîne L’alias de messagerie du groupe, unique dans l’organisation. Cette propriété doit être spécifiée lors de la création d’un groupe. Prend en charge $filter. Si cette propriété n’est pas spécifiée, elle est calculée à partir du displayName. Problème connu : cette propriété est actuellement ignorée.
partsToClone clonableTeamParts Liste séparée par des virgules des parties à cloner. Les parties juridiques sont « applications, onglets, paramètres, canaux, membres ».
visibility teamVisibilityType (facultatif) Spécifie la visibilité du groupe. Les valeurs possibles sont : Privé, Public. Si la visibilité n’est pas spécifiée, la visibilité est copiée à partir de l’équipe/du groupe d’origine. Si l’équipe cloné est une équipe educationClass , le paramètre visibility est ignoré et la visibilité du nouveau groupe est définie sur HiddenMembership.

Remarque

Si la propriété description n’est pas spécifiée dans le corps de la demande, elle prend la valeur de la propriété displayName à partir de la charge utile de la requête.

Réponse

Si elle réussit, cette méthode renvoie un 202 Accepted code de réponse avec un en-tête Location : pointant vers la ressource d’opération . Une fois l’opération terminée, la ressource d’opération vous indique l’ID de l’équipe créée.

Exemple

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/teams/{id}/clone
Content-Type: application/json

{  
     "displayName": "Library Assist",
     "description": "Self help community for library",
     "mailNickname": "libassist",
     "partsToClone": "apps,tabs,settings,channels,members",
     "visibility": "public"
}

Réponse

L’exemple suivant illustre la réponse. Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 202 Accepted
Location: /teams({id})/operations({opId})
Content-Type: text/plain
Content-Length: 0

Contenu connexe

Limites de limitation spécifiques au service Microsoft Graph