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 .
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.
- canaux – Copie la structure du canal (mais pas les messages du canal).
- members – Copie les membres et les propriétaires du groupe.
- paramètres – Copie tous les paramètres au sein de l’équipe, ainsi que les paramètres clés du groupe.
- onglets – Copie les onglets dans les canaux.
Remarque : Cette méthode n’est pas prise en charge pour les équipes à l’échelle de l’organisation.
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 des onglets sont clonés, 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, il doit passer par l’écran de configuration. Si l’utilisateur qui ouvre l’onglet n’est pas autorisé à configurer des applications, un message indiquant que l’onglet n’est pas configuré apparaît.
Le clonage est une opération de longue haleine. Après le retour du clone POST, vous devez GET l’opération renvoyée par l’en-tête Location: pour voir si c’est running, succeeded, ou failed. Vous devez continuer à GET jusqu’à ce que le status ne soit plus running. Le délai recommandé entre les GET est de 5 secondes.
Cette API est disponible dans les déploiements cloud nationaux suivants.
| Service global | Gouvernement américain L4 | Gouvernement américain L5 (DOD) | Chine exploitée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.
| Type d’autorisation | Autorisations les moins privilégiées | Autorisations à privilèges plus élevés |
|---|---|---|
| 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 à des fins de 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 les autorisations. |
| 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’entreprise). Les valeurs valides pour cette propriété sont définies en créant une valeur de paramètre ClassificationList, en fonction de la définition du modèle. Si aucune classification n’est spécifiée, la classification est copiée à partir de l’équipe/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 lors de la création d’un groupe et ne peut pas être effacée lors des 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 de displayName. Problème connu : cette propriété est actuellement ignorée. |
| partsToClone | clonableTeamParts | Liste des parties à cloner, séparées par des virgules. Les parties légales 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ée est une équipe educationClass , le paramètre de visibilité 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 de la charge utile de la demande.
Réponse
En cas de réussite, cette méthode renvoie un 202 Accepted code de réponse avec un en-tête Location : pointant vers la ressource de l’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