Arquivar equipeArchive team

Namespace: microsoft.graphNamespace: microsoft.graph

Arquive a equipe especificada.Archive the specified team. Quando uma equipe é arquivada, os usuários não podem mais enviar ou curtir mensagens nos canais da equipe, editar o nome, a descrição ou outras configurações da equipe ou, em geral, fazer a maioria das alterações na equipe.When a team is archived, users can no longer send or like messages on any channel in the team, edit the team's name, description, or other settings, or in general make most changes to the team. As alterações de associação à equipe continuam a ser permitidas.Membership changes to the team continue to be allowed.

O arquivamento é uma operação assíncrona.Archiving is an async operation. Uma equipe é arquivada depois que a operação assíncrona é concluída com êxito, o que pode ocorrer após uma resposta dessa API.A team is archived once the async operation completes successfully, which may occur subsequent to a response from this API.

Para arquivar uma equipe, a equipe e o grupo devem ter um proprietário.In order to archive team, the team and group must have an owner.

Para restaurar uma equipe do estado arquivado, use a API para desarquivar.To restore a team from its archived state, use the API to unarchive.

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) TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.AllTeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
ApplicationApplication TeamSettings.ReadWrite.Group*, TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.AllTeamSettings.ReadWrite.Group*, TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All

Observação : Permissões marcadas com * usam consentimento específico de recurso.Note : Permissions marked with * use resource-specific consent.

Observação : esta API oferece transporte a permissões de administrador.Note : This API supports admin permissions. Os administradores globais e os administradores do serviço do Microsoft Teams podem acessar equipes das quais eles não são membros.Global admins and Microsoft Teams service admins can access teams that they are not a member of.

Solicitação HTTPHTTP request

POST /teams/{id}/archive

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.

Corpo da solicitaçãoRequest body

Na solicitação, você pode opcionalmente incluir o parâmetro shouldSetSpoSiteReadOnlyForMembers em um corpo JSON, da seguinte maneira.In the request, you may optionally include the shouldSetSpoSiteReadOnlyForMembers parameter in a JSON body, as follows.

{
    "shouldSetSpoSiteReadOnlyForMembers": true
}

Este parâmetro opcional define se as permissões dos membros da equipe devem ser definidas apenas para leitura, no site do SharePoint Online associado à equipe.This optional parameter defines whether to set permissions for team members to read-only on the SharePoint Online site associated with the team. Essa etapa será ignorada, caso as defina como falsas ou omita o corpo completamente.Setting it to false or omitting the body altogether will result in this step being skipped.

Importante

Não há suporte para o parâmetro shouldSetSpoSiteReadOnlyForMembers no contexto do aplicativo.The shouldSetSpoSiteReadOnlyForMembers parameter is not supported in the application context.

RespostaResponse

Se o arquivamento for iniciado com êxito, esse método retornará um código de resposta 202 Accepted.If archiving is started successfully, this method returns a 202 Accepted response code. A resposta também conterá um cabeçalho Location, que contém o local da teamsAsyncOperation criada para lidar com o arquivamento da equipe.The response will also contain a Location header, which contains the location of the teamsAsyncOperation that was created to handle archiving of the team. Verifique o status da operação de arquivamento fazendo uma solicitação GET para esse local.Check the status of the archiving operation by making a GET request to this location.

ExemploExample

SolicitaçãoRequest

Veja a seguir um exemplo de uma solicitação.The following is an example of a request.

POST https://graph.microsoft.com/v1.0/teams/{id}/archive

RespostaResponse

Veja a seguir um exemplo de uma resposta.The following is an example of a response.

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