Compartilhar via


team: clone

Namespace: microsoft.graph

Crie uma cópia de uma equipe. Essa operação também cria uma cópia do grupo correspondente. Você pode especificar quais partes da equipe clonar:

  • aplicativos – copia aplicativos do Microsoft Teams instalados na equipe.
  • canais – 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 dentro da equipe, juntamente com as configurações de grupo de chaves.
  • guias – Copia as guias nos 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 no Microsoft Teams e, na primeira vez que um usuário as abre, elas devem passar pela tela de configuração. Se o usuário que abre a guia não tiver permissão para configurar aplicativos, verá uma mensagem que diz que a guia não está configurada.

A clonagem é uma operação de longa execução. Depois que o clone POST retornar, você precisará OBTER a operação retornada pelo Location: cabeçalho para ver se é running, succeededou failed. Você deve continuar a OBTER até que o status não runningseja . O atraso recomendado entre GETs é de 5 segundos.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas
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

O Group.ReadWrite.All e o 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 ficará em branco.
displayName String O nome de exibição do grupo. Essa propriedade é necessária quando um grupo é criado e não pode ser desmarcada durante as 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á calculada a partir do displayName. Atualmente, essa propriedade é ignorada.
partsToClone clonableTeamParts Uma lista separada por vírgulas das partes a serem clonados. 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: privado, público. 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 de descrição 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 202 Accepted código de resposta com um Local: cabeçalho apontando para o recurso de operação . Quando a operação for 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 exibido aqui pode ser encurtado para legibilidade.

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

Limites de limitação específicos do serviço do Microsoft Graph