Eliminare un progetto

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

Se un progetto diventa obsoleto, è possibile eliminarlo dall'organizzazione o dalla raccolta in Azure DevOps. Se si esegue la migrazione da un server Azure DevOps locale ad Azure DevOps Services, potrebbe anche essere necessario eliminare il progetto. La rimozione di progetti inutilizzati può migliorare lo spostamento limitandolo solo a quelli attualmente in uso.

Prerequisiti

Salvare i dati del progetto

Usare le procedure seguenti per salvare i dati di cui gli utenti si preoccupano di più, come il codice sorgente, i dati di build e gli elementi di lavoro. Questa procedura è facoltativa e può essere utile prima di eliminare un progetto.

• Codice sorgente e modelli di compilazione personalizzati: scaricare i file come file ZIP. Selezionare per il repository, il file o la cartella e selezionare Scarica come zip. In alternativa, selezionare Scarica per scaricare tutti i file nella cartella attualmente selezionata o il file attualmente selezionato.

  

  Questo processo non salva la cronologia delle modifiche o i collegamenti ad altri artefatti. Se si usa Git, clonare i repository per conservare la cronologia completa del progetto e tutti i rami.

• Dati di compilazione: per salvare i log e i dati nelle cartelle di build, vedere Visualizzare i risultati della build.

• Dati di rilevamento degli elementi di lavoro: creare una query sugli elementi di lavoro e aprirla utilizzando Excel. Salvare il foglio di calcolo di Excel.

  Questo processo non salva allegati, cronologia modifiche o collegamenti ad altri artefatti.

Per ulteriori informazioni, vedere la nostra Panoramica sulla protezione dei dati.

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

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

Ripristinare un progetto eliminato

Se si elimina inavvertitamente un progetto in Azure DevOps, è possibile ripristinarlo entro 28 giorni dall'eliminazione.

Ripristinare il progetto con l'API REST

1. Aprire una finestra del browser e immettere un URL che usa il formato seguente:

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

   Ad esempio, per connettersi al server denominato FabrikamPrime, immettere: 'http://FabrikamPrime:8080/tfs/'.

   La porta predefinita è 8080. Specificare il numero di porta e la directory per il server se le impostazioni predefinite non vengono usate.

2. Ottenere un elenco di progetti eliminati usando la richiesta seguente:

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

3. Ripristinare un progetto eliminato usando la richiesta seguente:

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

   Testo della richiesta

   {
    "state" : "wellFormed"
   }
   

Ripristinare il progetto con PowerShell

1. Eseguire lo script di PowerShell seguente per ottenere un elenco di progetti eliminati e assicurarsi di aggiornare $collectionUrl.

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

2. Usare lo script seguente per ripristinare un progetto. Assicurarsi di aggiornare $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'
   

Il progetto e i dati associati vengono ripristinati.

Domande frequenti

Vedere le domande frequenti seguenti sull'eliminazione di progetti in Azure DevOps.

D: Dopo aver eliminato un progetto, perché gli elementi di lavoro in un progetto rimanente hanno ancora collegamenti agli elementi di lavoro del progetto eliminati?

R: Gli elementi di lavoro vengono eliminati entro 24 ore dall'eliminazione del progetto.

D: È stato eliminato un progetto in Azure DevOps, ma in Visual Studio Team Explorer è ancora presente, cosa fare?

R: Attendere 28 giorni prima che il progetto venga eliminato definitivamente.

Contenuti correlati

• Creare un progetto
• Ripristinare un progetto
• Eliminare un progetto con l'API REST
• Usare lo strumento da riga di comando TFSDeleteProject