team : cloner

Espace de noms: microsoft.graph

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.

Remarque

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

Group.ReadWrite.All et Directory.ReadWrite.All sont pris 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é). 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. 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.

HTTP

POST https://graph.microsoft.com/v1.0/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"
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Teams.Item.Clone;
using Microsoft.Graph.Models;

var requestBody = new ClonePostRequestBody
{
	DisplayName = "Library Assist",
	Description = "Self help community for library",
	MailNickname = "libassist",
	PartsToClone = ClonableTeamParts.Apps | ClonableTeamParts.Tabs | ClonableTeamParts.Settings | ClonableTeamParts.Channels | ClonableTeamParts.Members,
	Visibility = TeamVisibilityType.Public,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Teams["{team-id}"].Clone.PostAsync(requestBody);

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc teams clone post --team-id {team-id} --body '{\
     "displayName": "Library Assist",\
     "description": "Self help community for library",\
     "mailNickname": "libassist",\
     "partsToClone": "apps,tabs,settings,channels,members",\
     "visibility": "public"\
}\
'

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphteams "github.com/microsoftgraph/msgraph-sdk-go/teams"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphteams.NewClonePostRequestBody()
displayName := "Library Assist"
requestBody.SetDisplayName(&displayName) 
description := "Self help community for library"
requestBody.SetDescription(&description) 
mailNickname := "libassist"
requestBody.SetMailNickname(&mailNickname) 
partsToClone := graphmodels.APPS,TABS,SETTINGS,CHANNELS,MEMBERS_CLONABLETEAMPARTS 
requestBody.SetPartsToClone(&partsToClone) 
visibility := graphmodels.PUBLIC_TEAMVISIBILITYTYPE 
requestBody.SetVisibility(&visibility) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Teams().ByTeamId("team-id").Clone().Post(context.Background(), requestBody, nil)

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.teams.item.clone.ClonePostRequestBody clonePostRequestBody = new com.microsoft.graph.teams.item.clone.ClonePostRequestBody();
clonePostRequestBody.setDisplayName("Library Assist");
clonePostRequestBody.setDescription("Self help community for library");
clonePostRequestBody.setMailNickname("libassist");
clonePostRequestBody.setPartsToClone(EnumSet.of(ClonableTeamParts.Apps, ClonableTeamParts.Tabs, ClonableTeamParts.Settings, ClonableTeamParts.Channels, ClonableTeamParts.Members));
clonePostRequestBody.setVisibility(TeamVisibilityType.Public);
graphClient.teams().byTeamId("{team-id}").clone().post(clonePostRequestBody);

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const clone = {
     displayName: 'Library Assist',
     description: 'Self help community for library',
     mailNickname: 'libassist',
     partsToClone: 'apps,tabs,settings,channels,members',
     visibility: 'public'
};

await client.api('/teams/{id}/clone')
	.post(clone);

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Teams\Item\Clone\ClonePostRequestBody;
use Microsoft\Graph\Generated\Models\ClonableTeamParts;
use Microsoft\Graph\Generated\Models\TeamVisibilityType;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new ClonePostRequestBody();
$requestBody->setDisplayName('Library Assist');
$requestBody->setDescription('Self help community for library');
$requestBody->setMailNickname('libassist');
$requestBody->setPartsToClone(new ClonableTeamParts('apps,tabs,settings,channels,members'));
$requestBody->setVisibility(new TeamVisibilityType('public'));

$graphServiceClient->teams()->byTeamId('team-id')->escapedClone()->post($requestBody)->wait();

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.Teams

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

Copy-MgTeam -TeamId $teamId -BodyParameter $params

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.teams.item.clone.clone_post_request_body import ClonePostRequestBody
from msgraph.generated.models.clonable_team_parts import ClonableTeamParts
from msgraph.generated.models.team_visibility_type import TeamVisibilityType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ClonePostRequestBody(
	display_name = "Library Assist",
	description = "Self help community for library",
	mail_nickname = "libassist",
	parts_to_clone = ClonableTeamParts.Apps | ClonableTeamParts.Tabs | ClonableTeamParts.Settings | ClonableTeamParts.Channels | ClonableTeamParts.Members,
	visibility = TeamVisibilityType.Public,
)

await graph_client.teams.by_team_id('team-id').clone.post(request_body)

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

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