Eliminare un progetto

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Se un progetto diventa obsoleto, è possibile delerlo dall'organizzazione o dalla raccolta in Azure DevOps. Se si esegue la migrazione da un Azure DevOps Server locale a servizi Azure DevOps, potrebbe essere necessario eliminare anche 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. Seleziona per il repository, il file o la cartella e seleziona 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 build: per salvare i log e i dati nelle cartelle di build, vedere Visualizzare i risultati della compilazione.

• Dati di rilevamento degli elementi di lavoro: creare una query sugli elementi di lavoro e aprirla utilizzando Excel. Salvare il foglio di calcolo 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: I collegamenti degli elementi di lavoro che puntano agli elementi di lavoro del progetto eliminati rimarranno fino a quando il progetto non viene eliminato definitivamente. Dopo l'eliminazione definitiva del progetto, i collegamenti degli elementi di lavoro vengono eliminati automaticamente entro 24 ore. Se sono necessari i collegamenti dell'elemento di lavoro puliti più velocemente di questo, è possibile rimuoverli manualmente direttamente dal modulo dell'elemento di lavoro.

D: Ho eliminato un progetto in Azure DevOps, ma in Visual Studio Team Explorer è ancora presente, cosa faccio?

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

Usare l'intelligenza artificiale per gestire l'eliminazione e il ripristino del progetto

Se si usa GitHub Copilot, il Azure DevOps Server MCP consente di eliminare, ripristinare e pulire in modo sicuro i progetti Azure DevOps tramite prompt del linguaggio naturale.

Richieste di esempio per l'eliminazione e il ripristino del progetto

Contenuti correlati

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