team: clone
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
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.
Nota: 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
, succeeded
ou failed
. Você deve continuar a OBTER até que o status não running
seja . 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
As permissões 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 comercial). Os valores válidos para essa propriedade são definidos criando um valor de configuração ClassificationList, com base na definição do modelo. 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 a $filter. Se essa propriedade não for especificada, ela será calculada a partir do displayName. Problema conhecido: essa propriedade é ignorada no momento. |
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/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"
}
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
Conteúdo relacionado
Limites de limitação específicos do serviço do Microsoft Graph
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de