Clonar uma equipeClone a team

Namespace: microsoft.graphNamespace: microsoft.graph

Criar uma cópia de uma equipe.Create a copy of a team. Essa operação também cria uma cópia do grupocorrespondente.This operation also creates a copy of the corresponding group. Você pode especificar quais partes da equipe serão clonadas:You can specify which parts of the team to clone:

  • aplicativos – copia os aplicativos do Microsoft Teams instalados na equipe.apps - Copies Microsoft Teams apps that are installed in the team.
  • canais – copia a estrutura do canal (mas não as mensagens no canal).channels – Copies the channel structure (but not the messages in the channel).
  • Membros – copia os membros e os proprietários do grupo.members – Copies the members and owners of the group.
  • configurações – copia Todas as configurações da equipe, juntamente com as configurações de grupo de chaves.settings – Copies all settings within the team, along with key group settings.
  • guias – copia as guias nos canais.tabs – Copies the tabs within channels.

Quando as guias são clonadas, elas são colocadas em um estado não configurado – elas são exibidas na barra de guias do Microsoft Teams e na primeira vez que você as abre, você passará pela tela de configuração.When tabs are cloned, they are put into an unconfigured state -- they are displayed on the tab bar in Microsoft Teams, and the first time you open them, you'll go through the configuration screen. (Se a pessoa que estiver abrindo a guia não tiver permissão para configurar aplicativos, verá uma mensagem explicando que a guia não foi configurada.)(If the person opening the tab does not have permission to configure apps, they will see a message explaining that the tab hasn't been configured.)

A clonagem é uma operação de execução demorada.Cloning is a long-running operation. Após o cancelamento do clone da POSTAgem, você precisará obter a operação para ver se ela está "em execução" ou "com êxito" ou "falha".After the POST clone returns, you need to GET the operation to see if it's "running" or "succeeded" or "failed". Você deve continuar a obter até que o status não seja "em execução".You should continue to GET until the status is not "running". O atraso recomendado entre GETs é de 5 segundos.The recommended delay between GETs is 5 seconds.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All

Solicitação HTTPHTTP request

POST /teams/{id}/clone

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corpo da solicitaçãoRequest body

PropriedadeProperty TipoType DescriçãoDescription
classificaçãoclassification Cadeia de caracteres (opcional)String (optional) Descreve uma classificação para o grupo (como impacto comercial baixo, médio ou alto).Describes a classification for the group (such as low, medium or high business impact). Se a classificação não for especificada, a classificação será copiada da equipe/grupo original.If classification is not specified, the classification will be copied from the original team/group.
descriptiondescription Cadeia de caracteres (opcional)String (optional) Uma descrição opcional para o grupo.An optional description for the group. Se essa propriedade não for especificada, será deixada em branco.If this property is not specified, it will be left blank.
displayNamedisplayName StringString O nome de exibição do grupo. Essa propriedade é obrigatória quando um grupo é criado e não pode ser apagado durante atualizações. Oferece suporte a $filter e $orderby.The display name for the group. This property is required when a group is created and it cannot be cleared during updates. Supports $filter and $orderby.
mailNicknamemailNickname StringString O alias de email do grupo, exclusivo na organização.The mail alias for the group, unique in the organization. Essa propriedade deve ser especificada quando um grupo é criado.This property must be specified when a group is created. Oferece suporte a $filter.Supports $filter. Se essa propriedade não for especificada, será calculada a partir do displayName.If this property is not specified, it will be computed from the displayName. Problema conhecido: esta propriedade é ignorada no momento.Known issue: this property is currently ignored.
partsToClonepartsToClone clonableTeamPartsclonableTeamParts Uma lista separada por vírgulas das partes a serem clonadas.A comma-separated list of the parts to clone. As partes legais são "aplicativos, guias, configurações, canais, membros".Legal parts are "apps, tabs, settings, channels, members".
visibilityvisibility teamVisibilityType (opcional)teamVisibilityType (optional) Especifica a visibilidade do grupo.Specifies the visibility of the group. Os valores possíveis são: Private, Public.Possible values are: Private, Public. Se a visibilidade não for especificada, a visibilidade será copiada da equipe/grupo original.If visibility is not specified, the visibility will be copied from the original team/group. Se a equipe que está sendo clonada for uma equipe do educationClass , o parâmetro Visibility será ignorado e a visibilidade do novo grupo será definida como HiddenMembership.If the team being cloned is an educationClass team, the visibility parameter is ignored, and the new group's visibility will be set to HiddenMembership.

RespostaResponse

Se tiver êxito, este método retornará um 202 Accepted código de resposta com um local: cabeçalho apontando para o recurso Operation .If successful, this method will return a 202 Accepted response code with a Location: header pointing to the operation resource. Quando a operação for concluída, o recurso de operação informará o ID da equipe criada.When the operation is complete, the operation resource will tell you the id of the created team.

ExemploExample

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

POST /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"
}

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response. Observação: o objeto de resposta mostrado aqui pode estar truncado por motivos de concisão.Note: The response object shown here may be truncated for brevity. Todas as propriedades serão retornadas de uma chamada real.All of the properties will be returned from an actual call.

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