Eliminar un proyecto

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

Si un proyecto se vuelve obsoleto, puede eliminarlo de su organización o colección en Azure DevOps. Si va a migrar desde una instancia local de Azure DevOps Server a Azure DevOps Services, es posible que también tenga que eliminar el proyecto. La eliminación de proyectos sin usar puede mejorar la navegación limitando a solo los proyectos que están actualmente en uso.

Requisitos previos

Guardar datos del proyecto

Use los procedimientos siguientes para guardar los datos que más le interesan a los usuarios, como el código fuente, los datos de compilación y los elementos de trabajo. Este procedimiento es opcional y algo que puede considerar antes de eliminar un proyecto.

• Código fuente y plantillas de compilación personalizadas: descargue los archivos como un archivo ZIP. Seleccione para el repositorio, el archivo o la carpeta y seleccione Descargar como Zip. O bien, seleccione Descargar para descargar todos los archivos de la carpeta seleccionada actualmente o el archivo seleccionado actualmente.

  

  Este proceso no guarda ningún historial de cambios ni vínculos a otros artefactos. Si usa Git, clone los repositorios para conservar el historial completo del proyecto y todas las ramas.

• Datos de compilación: para guardar registros y datos en las carpetas de compilación desplegables, consulte Visualización de los resultados de la compilación.

• Datos de seguimiento de elementos de trabajo: cree una consulta de elemento de trabajo y ábrala con Excel. Guarde la hoja de cálculo de Excel.

  Este proceso no guarda ningún archivo adjunto, historial de cambios ni vínculos a otros artefactos.

Para obtener más información,consulte Información general sobre la protección de datos.

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

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

Restauración de un proyecto eliminado

Si elimina accidentalmente un proyecto en Azure DevOps, puede restaurarlo en un plazo de 28 días a partir de su eliminación.

Restauración de un proyecto con la API REST

1. Abra una ventana del explorador y escriba una dirección URL que use el siguiente formato:

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

   Por ejemplo, para conectarse al servidor denominado FabrikamPrime, escriba: 'http://FabrikamPrime:8080/tfs/'.

   El puerto predeterminado es 8080. Especifique el número de puerto y el directorio del servidor si no se usan los valores predeterminados.

2. Obtenga una lista de proyectos eliminados mediante la solicitud siguiente:

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

3. Restaure un proyecto eliminado mediante la siguiente solicitud:

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

   Cuerpo de la solicitud

   {
    "state" : "wellFormed"
   }
   

Restauración del proyecto con PowerShell

1. Ejecute el siguiente script de PowerShell para obtener una lista de proyectos eliminados y asegúrese de actualizar $collectionUrl.

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

2. Use el siguiente script para restaurar un proyecto. Asegúrese de actualizar $collectionUrl y $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'
   

El proyecto y los datos asociados se restauran.

Preguntas más frecuentes

Consulte las siguientes preguntas más frecuentes sobre cómo eliminar proyectos en Azure DevOps.

P: Después de eliminar un proyecto, ¿por qué los elementos de trabajo de un proyecto restante siguen teniendo vínculos a los elementos de trabajo del proyecto eliminados?

R: Los vínculos de elemento de trabajo que apuntan a los elementos de trabajo del proyecto eliminados permanecerán hasta que el proyecto se elimine permanentemente. Una vez eliminado permanentemente el proyecto, los vínculos del elemento de trabajo se limpian automáticamente en un plazo de 24 horas. Si necesita que los vínculos del elemento de trabajo se limpien más rápido que eso, puede quitarlos manualmente del formulario del elemento de trabajo directamente.

P: He eliminado un proyecto en Azure DevOps, pero sigue estando en Visual Studio Team Explorer, ¿qué hago?

R: Espere 28 días hasta que el proyecto se elimine permanentemente.

Contenido relacionado

• Creación de un proyecto
• Restauración de un proyecto
• Eliminación de un proyecto con la API REST
• Uso de la herramienta de línea de comandos TFSDeleteProject