team : cloner
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 running
de , succeeded
ou 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