Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
Criar uma cópia de uma equipa. Esta operação também cria uma cópia do grupo correspondente. Pode especificar as partes da equipa a clonar:
- aplicações – copia as aplicações do Microsoft Teams que estão instaladas na equipa.
- channels – copia a estrutura do canal (mas não as mensagens no canal).
- membros – copia os membros e proprietários do grupo.
- definições – copia todas as definições dentro da equipa, juntamente com as definições do grupo de chaves.
- separadores – copia os separadores nos canais.
Nota: Este método não é suportado para equipas de toda a organização.
Observação
Um problema conhecido relacionado com os proprietários das equipas clonadas está associado a este método. Para mais detalhes, confira Problemas conhecidos.
Quando os separadores são clonados, não são configurados. Os separadores são apresentados na barra de separadores no Microsoft Teams e, quando um utilizador os abre pela primeira vez, tem de percorrer o ecrã de configuração. Se o utilizador que abre o separador não tiver permissão para configurar aplicações, verá uma mensagem a indicar que o separador não está configurado.
A clonagem é uma operação de execução prolongada. Após a devolução do clone POST, tem de OBTER a operação devolvida pelo Location: cabeçalho para ver se é running, succeededou failed. Deve continuar a obter até que a status não runningseja . O atraso recomendado entre GETs é de 5 segundos.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| 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 são suportadas apenas para retrocompatibilidade. 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 (opcional) | Descreve uma classificação para o grupo (como impacto comercial baixo, médio ou elevado). Os valores válidos para esta propriedade são definidos através da criação de um valor de definição ClassificationList, com base na definição do modelo. Se a classificação não for especificada, a classificação é copiada da equipa/grupo original. |
| description | Cadeia (opcional) | Uma descrição opcional para o grupo. Se esta propriedade não for especificada, fica 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 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 esta propriedade não for especificada, é calculada a partir do displayName. Problema conhecido: esta propriedade é atualmente ignorada. |
| partsToClone | clonableTeamParts | Uma lista separada por vírgulas das partes a clonar. As partes legais são "aplicações, separadores, definiçõ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 é copiada da equipa/grupo original. Se a equipa a ser clonada for uma equipa educationClass , o parâmetro de visibilidade é ignorado e a visibilidade do novo grupo será definida como HiddenMembership. |
Observação
Se a propriedade description não for especificada no corpo do pedido, utiliza o valor da propriedade displayName do payload do pedido.
Resposta
Se for bem-sucedido, este método devolve um 202 Accepted código de resposta com um cabeçalho Localização: que aponta para o recurso de operação .
Quando a operação estiver concluída, o recurso da operação indica-lhe o ID da equipa 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