Eliminar um projeto

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Se um projeto se tornar obsoleto, você poderá excluí-lo de sua organização ou coleção no Azure DevOps. Da mesma forma, se você estiver migrando de um Servidor de DevOps do Azure local para os Serviços de DevOps do Azure, talvez seja necessário excluir o projeto. A remoção de projetos também pode melhorar a navegação, restringindo-a apenas aos projetos que estão atualmente em uso.

Atenção

• Os projetos eliminados de forma recuperável do portal Web são removidos permanentemente se não forem restaurados dentro de 28 dias.
• Em casos raros, o nosso processo de eliminação pode demorar até 70 dias devido a repetições do back-end e à necessidade de eliminar dados de várias fontes.
• Os projetos excluídos do Console de Administração do Azure DevOps local não podem ser restaurados. Para obter mais informações, consulte Restaurar um projeto e Salvar dados do projeto.

Pré-requisitos

• Permissões:
  • Ser membro do grupo de Administradores da Coleção de Projetos. Os proprietários da organização são automaticamente membros deste grupo.
  • Ter a permissão Eliminar projeto de equipa definida como Permitir. Para obter mais informações, consulte Ver permissões ao nível de projeto.
• Opcional: salve os dados do projeto antes de excluir um projeto se quiser acessar os dados do projeto sem restaurá-los.

Salvar dados do projeto

Use os procedimentos a seguir para salvar os dados que mais interessam aos usuários, como código-fonte, dados de compilação e itens de trabalho. Este procedimento é opcional e algo que você pode considerar antes de excluir um projeto.

• Código fonte e modelos de compilação personalizados: Baixe seus arquivos como um arquivo zip. Selecione o repositório, arquivo ou pasta e selecione Baixar como Zip. Ou selecione Download para baixar todos os arquivos na pasta selecionada no momento ou o arquivo selecionado no momento.

  

  Esse processo não salva nenhum histórico de alterações ou links para outros artefatos. Se você usa o Git, clone seus repositórios para manter o histórico completo do projeto e todas as ramificações.

• Dados de compilação: para salvar logs e dados em suas pastas de compilação suspensas, consulte Exibir resultados de compilação.

• Dados de controle de item de trabalho: crie uma consulta de item de trabalho e abra-a usando o Excel. Salve a planilha do Excel.

  Esse processo não salva anexos, altera o histórico ou vincula a outros artefatos.

Para obter mais informações, consulte nossa Visão geral da proteção de dados.

Excluir projeto

Browser

Use seu navegador da Web para executar uma exclusão suave. Após 28 dias, os projetos são excluídos permanentemente se não forem restaurados dentro desse prazo.

1. Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).

2. Selecione Configurações da organização.

   

3. Selecione Projetos, marque um ou mais projetos a serem excluídos e selecione Excluir.

   

4. Confirme a exclusão inserindo o nome do projeto e selecione Excluir na tela pop-up.

   

Seu projeto é excluído e pode ser restaurado até 28 dias depois. O projeto excluído é removido da lista de projetos.

Console de Administração

O Console de Administração só tem suporte para Servidores de DevOps do Azure locais.

CLI do Azure DevOps

Você pode excluir um projeto de equipe com o comando az devops project delete . Para começar, consulte Introdução à CLI do Azure DevOps.

az devops project delete --id
                         [--org]
                         [--yes] 

Parâmetros

• id: Obrigatório. A ID do projeto que você deseja excluir. Para determinar a ID de um projeto, use o comando az devops project list .
• org: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URLo . Obrigatório se não estiver configurado como padrão ou coletado usando git configo . Exemplo: --org https://dev.azure.com/MyOrganizationName/.
• Sim: Não solicite confirmação.

Exemplo

O comando a seguir exclui o projeto de equipe com a ID especificada sem solicitar a confirmação.

az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes

Restaurar um projeto excluído

Se você excluir inadvertidamente um projeto no Azure DevOps, poderá restaurá-lo dentro de 28 dias após sua exclusão.

1. Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).

2. Selecione Configurações da organização.

   

3. Selecione Visão geral e role para baixo até "projetos excluídos recentemente".

   

4. Realce o projeto que pretende restaurar e, em seguida, selecione Restaurar.

   

Restaurar projeto com a API REST

Aviso

Para restaurar um projeto com um nome que já foi usado, você deve renomear o projeto antes de poder restaurá-lo. Para renomear o projeto, insira o seguinte texto no corpo da solicitação: "name":"new name"

1. Abra uma janela do navegador e insira um URL que use o seguinte formulário:

   'http://ServerName:8080/tfs/DefaultCollection/ProjectName'

   Por exemplo, para se conectar ao servidor chamado FabrikamPrime, digite: 'http://FabrikamPrime:8080/tfs/'.

   A porta padrão é 8080. Especifique o número da porta e o diretório do servidor se os padrões não forem usados.

2. Obtenha uma lista de projetos excluídos usando a seguinte solicitação:

   GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3
   

3. Restaure um projeto excluído usando a seguinte solicitação:

   PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
   api-version=5.0-preview.3
   

   Corpo do pedido

   {
    "state" : "wellFormed"
   }
   

Restaurar projeto com o PowerShell

1. Execute o seguinte script do PowerShell para obter uma lista de projetos excluídos e certifique-se de atualizar $collectionUrlo .

   $collectionUrl = "https://localhost/defaultcollection"
   (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
   

   Algo semelhante à seguinte captura de tela aparece:

2. Use o script a seguir para restaurar um projeto. Certifique-se de atualizar $collectionUrl e $projectName.

   $collectionUrl = "https://localhost/defaultcollection"
   $projectName = 'Project1'
   $project = (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
    | where {$_.name -eq $projectName}
   irm -Uri ($project.url + "?api-version=5.0-preview.3") 
   -UseDefaultCredentials -Method PATCH -Body '{"state":"wellFormed"}'
    -ContentType 'application/json'
   

Seu projeto e os dados associados são restaurados.

FAQs

Consulte as seguintes perguntas frequentes sobre como excluir projetos no Azure DevOps.

P: Depois de excluir um projeto, por que os itens de trabalho em um projeto restante ainda têm links para os itens de trabalho do projeto excluídos?

R: Os itens de trabalho são eliminados no prazo de 24 horas após o seu projeto ser eliminado.

P: Eu excluí um projeto no Azure DevOps, mas no Visual Studio Team Explorer ele ainda está lá, o que eu faço?

R: Aguarde 28 dias antes que o projeto seja excluído permanentemente.

Artigos relacionados

• Criar um projeto
• Restaurar um projeto
• Excluir um projeto com a API REST
• Use a ferramenta de linha de comando TFSDeleteProject