Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Criar uma cópia de uma equipe. Esta operação também cria uma cópia do grupo correspondente. Você pode especificar quais partes da equipe clonar:
- aplicativos - Copia os aplicativos do Microsoft Teams instalados na equipe.
- channels – Copia a estrutura do canal (mas não as mensagens no canal).
- membros – Copia os membros e proprietários do grupo.
- configurações – Copia todas as configurações da equipe, juntamente com as configurações do grupo principal.
- guias – Copia as guias dentro dos canais.
Observação
Esse método não tem suporte para equipes de toda a organização.
Observação
Um problema conhecido relacionado aos proprietários de equipes clonadas está associado a esse método. Para mais detalhes, confira Problemas conhecidos.
Quando as guias são clonadas, elas não são configuradas. As guias são exibidas na barra de guias do Microsoft Teams e, na primeira vez que um usuário as abre, ele deve passar pela tela de configuração. Se o usuário que abre a guia não tiver permissão para configurar aplicativos, ele verá uma mensagem informando que a guia não está configurada.
A clonagem é uma operação de execução prolongada. Depois que o clone de POST retornar, você precisa OBTER a operação retornada Location:runningpelo cabeçalho para ver se é , succeeded, ou failed. Você deve continuar a GET até que o status não runningseja . O atraso recomendado entre GETs é de 5 segundos.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Team.Create | Directory.ReadWrite.All, Group.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | Team.Create | Directory.ReadWrite.All, Group.ReadWrite.All |
Observação
Group.ReadWrite.All e Directory.ReadWrite.All têm suporte apenas para compatibilidade com versões anteriores. Recomendamos que você atualize suas soluções para usar uma permissão alternativa listada na tabela anterior e evite usar essas permissões daqui para frente.
Solicitação HTTP
POST /teams/{id}/clone
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json |
Corpo da solicitação
| Propriedade | Tipo | Descrição |
|---|---|---|
| classificação | Cadeia de caracteres (opcional) | Descreve uma classificação para o grupo (como baixo, médio ou alto impacto nos negócios). Se a classificação não for especificada, a classificação será copiada da equipe/grupo original. |
| description | Cadeia de caracteres (opcional) | Uma descrição opcional para o grupo. Se essa propriedade não for especificada, ela será deixada em branco. |
| displayName | String | O nome de exibição do grupo. Esta propriedade é necessária quando um grupo é criado e não pode ser limpo durante atualizações. Oferece suporte a $filter e $orderby. |
| mailNickname | String | O alias de email do grupo, exclusivo na organização. Essa propriedade deve ser especificada quando um grupo é criado. Oferece suporte para filter. Se essa propriedade não for especificada, ela será computada a partir do displayName. Esta propriedade foi ignorada no momento. |
| partsToClone | clonableTeamParts | Uma lista separada por vírgulas das partes a serem clonadas. As partes legais são "aplicativos, guias, configurações, canais, membros". |
| visibility | teamVisibilityType (opcional) | Especifica a visibilidade do grupo. Os valores possíveis são: Private, Public. Se a visibilidade não for especificada, a visibilidade será copiada da equipe/grupo original. Se a equipe que está sendo clonada for uma equipe educationClass , o parâmetro de visibilidade será ignorado e a visibilidade do novo grupo será definida como HiddenMembership. |
Observação
Se a propriedade description não for especificada no corpo da solicitação, ela usará o valor da propriedade displayName do conteúdo da solicitação.
Resposta
Se for bem-sucedido, esse método retornará um código de 202 Accepted resposta com um cabeçalho Location: apontando para o recurso de operação .
Quando a operação é concluída, o recurso de operação informa a ID da equipe criada.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
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"
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 202 Accepted
Location: /teams({id})/operations({opId})
Content-Type: text/plain
Content-Length: 0
Conteúdo relacionado
Limites de limitação específicos do serviço do Microsoft Graph