Excluir um projeto

  • Artigo

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.

Cuidado

Os projetos excluídos do portal da Web são excluídos e removidos permanentemente se não forem restaurados dentro de 28 dias. No entanto, os projetos excluídos do Console de Administração de DevOps do Azure local são excluídos e não podem ser restaurados. Para obter detalhes de restauração, consulte Restaurar um projeto. Para acessar dados de um projeto excluído sem restaurá-lo, salve os dados do projeto.

Pré-requisitos

Salvar dados do projeto

Use os procedimentos a seguir para salvar os dados mais importantes para os usuários, como código-fonte, dados de compilação e itens de trabalho. Esse 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 Repository actions 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.

    Screenshot of Downloading code.

    Esse processo não salva nenhum histórico de alterações ou links para outros artefatos. Se você usar 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 links para outros artefatos.

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

Excluir projeto

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 tempo.

  1. Entre em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione gear iconConfigurações da organização.

    Screenshot of selection, Organization settings.

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

    Screenshot of sequence selected Projects, check each project, and delete.

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

    Screenshot of popup confirmation delete project screen.

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

Excluir relatórios que permanecem após a exclusão de um projeto

Se seu projeto usou relatórios do SQL Server e você não excluiu artefatos externos, poderá excluir os relatórios usando o Gerenciador de Relatórios do SQL Server. Na página da coleção de projetos, exclua a pasta que corresponde ao projeto excluído.

Screenshot of the context menu with delete command.

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. Entre em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione gear iconConfigurações da organização.

    Screenshot showing the gear icon, Organization settings.

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

    Screenshot that shows recently deleted projects.

  4. Realce o projeto que você deseja restaurar e selecione Restaurar.

    Screenshot showing highlighted project, and Restore button.

  1. Entre na sua instância (http://{ServerName:8080/tfs/}/{CollectionName}).

  2. Escolha gear iconConfigurações de administrador.

    Screenshot showing Admin settings button surrounded by red box.

  3. Selecione Projetos e role para baixo até Projetos excluídos recentemente.

  4. Realce o projeto que você deseja restaurar e selecione Restaurar.

    Screenshot showing how to Highlight the project, and then select Restore for Azure DevOps Server.

Observação

A interface do usuário não oferece suporte à restauração de um projeto de equipe para o Azure DevOps Server 2019. Use os seguintes métodos de API REST ou PowerShell para restaurar um projeto de equipe excluído. Para obter mais informações, consulte Projects-Update REST API.

Restaurar projeto com API REST

Aviso

Para restaurar um projeto com um nome que já foi usado, você deve renomear o projeto antes de 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 uma 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 da solicitação

    {
 "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: Screenshot of PowerShell script return example for deleted projects.

  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.

Perguntas Frequentes

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

R: Os itens de trabalho são excluídos dentro de 24 horas após a exclusão do projeto.

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.