Eliminar um projeto

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

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

Pré-requisitos

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.

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

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.

Restaurar projeto com a API REST

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 seu servidor caso os valores padrão não sejam utilizados.

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 apagados e certifique-se de atualizar $collectionUrl.

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

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 links de item de trabalho que apontam para itens de trabalho de projeto excluídos permanecerão até que o projeto seja excluído permanentemente. Uma vez que o projeto é excluído permanentemente, os links de item de trabalho são automaticamente limpos dentro de 24 horas. Se você precisar que os links de item de trabalho sejam limpos mais rapidamente do que isso, poderá removê-los manualmente do formulário de item de trabalho diretamente.

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.

Conteúdo relacionado

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