Cloner une équipeClone a team

Espace de noms: microsoft.graphNamespace: microsoft.graph

Créer une copie d’une équipe.Create a copy of a team. Cette opération crée également une copie du groupecorrespondant.This operation also creates a copy of the corresponding group. Vous pouvez spécifier les parties de l’équipe à cloner :You can specify which parts of the team to clone:

  • apps : copie les applications Microsoft teams qui sont installées dans l’équipe.apps - Copies Microsoft Teams apps that are installed in the team.
  • Channels : copie la structure de la chaîne (mais pas les messages qu’elle comporte).channels – Copies the channel structure (but not the messages in the channel).
  • members : copie les membres et les propriétaires du groupe.members – Copies the members and owners of the group.
  • paramètres : copie tous les paramètres au sein de l’équipe, ainsi que les paramètres de groupe clé.settings – Copies all settings within the team, along with key group settings.
  • onglets : copie les onglets dans les canaux.tabs – Copies the tabs within channels.

Lorsque les onglets sont clonés, ils sont placés dans un État non configuré (ils sont affichés dans la barre d’onglets de Microsoft Teams) et la première fois que vous les ouvrez, vous parcourez l’écran de configuration.When tabs are cloned, they are put into an unconfigured state -- they are displayed on the tab bar in Microsoft Teams, and the first time you open them, you'll go through the configuration screen. (Si la personne qui ouvre l’onglet n’est pas autorisée à configurer des applications, un message s’affichera pour expliquer que l’onglet n’a pas été configuré.)(If the person opening the tab does not have permission to configure apps, they will see a message explaining that the tab hasn't been configured.)

Le clonage est une opération longue.Cloning is a long-running operation. Une fois que le clone de publication renvoie, vous devez obtenir l' opération pour savoir s’il s’agit de « exécution » ou « réussite » ou « échec ».After the POST clone returns, you need to GET the operation to see if it's "running" or "succeeded" or "failed". Vous devez continuer à obtenir jusqu’à ce que l’État ne soit pas « en cours d’exécution ».You should continue to GET until the status is not "running". Le délai recommandé entre Get est de 5 secondes.The recommended delay between GETs is 5 seconds.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All

Requête HTTPHTTP request

POST /teams/{id}/clone

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corps de la demandeRequest body

PropriétéProperty TypeType DescriptionDescription
classificationclassification Chaîne (facultatif)String (optional) Décrit une classification pour le groupe (par exemple, faible, moyenne ou élevée).Describes a classification for the group (such as low, medium or high business impact). Si la classification n’est pas spécifiée, la classification est copiée à partir de l’équipe/du groupe d’origine.If classification is not specified, the classification will be copied from the original team/group.
descriptiondescription Chaîne (facultatif)String (optional) Description facultative du groupe.An optional description for the group. Si cette propriété n’est pas spécifiée, elle reste vide.If this property is not specified, it will be left blank.
displayNamedisplayName StringString Nom complet du groupe. Cette propriété est requise lors de la création d’un groupe et ne peut pas être désactivée lors des mises à jour. Prend en charge $filter et $orderby.The display name for the group. This property is required when a group is created and it cannot be cleared during updates. Supports $filter and $orderby.
mailNicknamemailNickname ChaîneString L’alias de messagerie du groupe, unique dans l’organisation.The mail alias for the group, unique in the organization. Cette propriété doit être spécifiée lors de la création d’un groupe.This property must be specified when a group is created. Prend en charge $filter.Supports $filter. Si cette propriété n’est pas spécifiée, elle est calculée à partir du displayName.If this property is not specified, it will be computed from the displayName. Problème connu : cette propriété est actuellement ignorée.Known issue: this property is currently ignored.
partsToClonepartsToClone clonableTeamPartsclonableTeamParts Liste des parties à cloner séparées par des virgules.A comma-separated list of the parts to clone. Les éléments juridiques sont « applications, onglets, paramètres, canaux, membres ».Legal parts are "apps, tabs, settings, channels, members".
visibilityvisibility teamVisibilityType (facultatif)teamVisibilityType (optional) Spécifie la visibilité du groupe.Specifies the visibility of the group. Les valeurs possibles sont les suivantes : Private, public.Possible values are: Private, Public. Si la visibilité n’est pas spécifiée, la visibilité est copiée à partir du groupe/de l’équipe d’origine.If visibility is not specified, the visibility will be copied from the original team/group. Si l’équipe clonée est une équipe educationClass , le paramètre visibility est ignoré et la visibilité du nouveau groupe est définie sur HiddenMembership.If the team being cloned is an educationClass team, the visibility parameter is ignored, and the new group's visibility will be set to HiddenMembership.

RéponseResponse

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 operation .If successful, this method will return a 202 Accepted response code with a Location: header pointing to the operation resource. Une fois l’opération terminée, la ressource Operation vous indique l’ID de l’équipe créée.When the operation is complete, the operation resource will tell you the id of the created team.

ExempleExample

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

POST /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éponseResponse

Voici un exemple de réponse.The following is an example of the response. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision.Note: The response object shown here may be truncated for brevity. Toutes les propriétés sont renvoyées à partir d’un appel réel.All of the properties will be returned from an actual call.

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