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. Analogamente, se si esegue la migrazione da un server Azure DevOps locale ad Azure DevOps Services, potrebbe essere necessario eliminare il progetto. La rimozione dei progetti può anche migliorare la navigazione limitandola solo a quei progetti attualmente in uso.

Prerequisiti

Salvare i dati del progetto

Usare le procedure seguenti per salvare i dati più a cui gli utenti si preoccupano, ad esempio il codice sorgente, compilare i dati 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.

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

• Dati di rilevamento degli elementi di lavoro: creare una query dell'elemento di lavoro e aprirla usando Excel. Salvare il foglio di calcolo di Excel.

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

Per altre informazioni, vedere 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
   

   Corpo 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
   

   Viene visualizzato un aspetto simile allo screenshot seguente:

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.

Articoli correlati

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