Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Если проект устаревает, вы можете удалить его из организации или коллекции в Azure DevOps. Если вы переносите локальный Azure DevOps Server на службы Azure DevOps, может потребоваться удалить проект. Удаление неиспользуемых проектов может улучшить навигацию, ограничив ее только теми проектами, которые в настоящее время используются.
Внимание
- Проекты, временно удаленные с веб-портала, удаляются безвозвратно, если не будут восстановлены в течение 28 дней.
- В редких случаях процесс удаления данных может занять до 70 дней из-за повторных попыток бэкенда и необходимости удаления данных из нескольких источников.
- Не удается восстановить удаленные проекты из локальной консоли администрирования Azure DevOps. Дополнительные сведения см. в разделе "Восстановление проекта " и "Сохранение данных проекта".
Подсказка
Вы можете использовать ИИ, чтобы помочь с этой задачей далее в этой статье или ознакомиться с Включение помощи ИИ с сервером Azure DevOps MCP для начала работы.
Предварительные условия
| Категория | Требования |
|---|---|
| Разрешения | — Член группы администраторов коллекции Project. Владельцы организации автоматически входят в эту группу. — Удаление разрешений командного проекта с установкой на «Разрешить». Дополнительные сведения см. в разделе Просмотр разрешений на уровне проекта. |
| Необязательно | Сохранить данные проекта перед удалением проекта, если вы хотите получить доступ к данным проекта без его восстановления. |
| Категория | Требования |
|---|---|
| Разрешения | Удаление разрешений для проекта группы, установленных на разрешение "Позволить". Дополнительные сведения см. в разделе "Просмотр разрешений". |
| Необязательно | Сохранение данных проекта, так как удаление проекта приводит к необратимой потере данных. |
Сохранение данных проекта
Используйте следующие процедуры для сохранения данных, которые больше всего важны для пользователей, например, исходного кода, данных сборки и рабочих элементов. Эта процедура является необязательной, и вы можете рассмотреть ее перед удалением проекта.
Исходный код и пользовательские шаблоны сборки: скачивание файлов в виде ZIP-файла. Выберите
, файла или папки и выберите "Скачать как ZIP". Или нажмите кнопку
"Скачать", чтобы скачать все файлы в выбранной папке или текущий выбранный файл.
Этот процесс не сохраняет журнал изменений или ссылки на другие артефакты. Если вы используете Git, клонируйте репозитории для сохранения полной истории проекта и всех ветвей.
Создание данных: Чтобы сохранять журналы и данные в папках сборки Drop, см. Просмотр результатов сборки.
Данные отслеживания рабочих элементов: создайте запрос рабочего элемента и откройте его с помощью Excel. Сохраните электронную таблицу Excel.
Этот процесс не сохраняет вложения, журнал изменений или ссылки на другие артефакты.
Дополнительные сведения см. в обзоре защиты данных.
Удаление проекта
Используйте веб-браузер для выполнения обратимого удаления. Через 28 дней проекты окончательно удаляются, если они не восстанавливаются в течение этого времени.
Войдите в свою организацию (
https://dev.azure.com/{yourorganization}).Выберите пункт
с иконкой шестеренки.
Выберите "Проекты", проверьте один или несколько проектов, чтобы удалить, а затем нажмите кнопку "Удалить".
Подтвердите удаление, введя имя проекта, а затем нажмите кнопку "Удалить" на всплывающем экране.
Проект удаляется и может быть восстановлен до 28 дней после этого. Удаленный проект удаляется из списка проектов.
Удаление отчетов, оставшихся после удаления проекта
Вы можете удалить отчеты, если ваш проект использовал отчетность SQL Server и вы не удаляли внешние артефакты, воспользовавшись инструментом диспетчер отчетов SQL Server. На странице коллекции проектов удалите папку, соответствующую удаленному проекту.
Восстановление удаленного проекта
Если вы непреднамеренно удалите проект в Azure DevOps, его можно восстановить в течение 28 дней после его удаления.
Войдите в свою организацию (
https://dev.azure.com/{Your_Organization}).Выберите пункт
с иконкой шестеренки.
Выберите "Обзор", а затем прокрутите вниз до "недавно удаленных проектов".
Выделите проект, который требуется восстановить, и нажмите кнопку "Восстановить".
Войдите в вашу инстанцию (
http://{ServerName:8080/tfs/}/{CollectionName}).Выберите
и параметры администратора.
Выберите "Проекты", а затем прокрутите вниз до недавно удаленных проектов.
Выделите проект, который требуется восстановить, и нажмите кнопку "Восстановить".
Восстановление проекта с помощью REST API
Предупреждение
Чтобы восстановить проект с существующим именем, сначала переименуйте проект. Чтобы переименовать проект, введите следующий текст в тексте запроса: "name":"new name".
Откройте окно браузера и введите URL-адрес, использующий следующую форму:
http://ServerName:8080/tfs/DefaultCollection/ProjectName
Например, чтобы подключиться к серверу с именем FabrikamPrime, введите :'http://FabrikamPrime:8080/tfs/.
Порт по умолчанию — 8080. Укажите номер порта и каталог сервера, если значения по умолчанию не используются.
Получите список удаленных проектов с помощью следующего запроса:
GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter= deleted&api-version=5.0-preview.3Восстановите удаленный проект с помощью следующего запроса:
PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}? api-version=5.0-preview.3Текст запроса
{ "state" : "wellFormed" }
Восстановление проекта с помощью PowerShell
Выполните следующий скрипт PowerShell, чтобы получить список удаленных проектов и обязательно обновить
$collectionUrl.$collectionUrl = "https://localhost/defaultcollection" (irm -Uri "$collectionUrl/_apis/projects?stateFilter= deleted&api-version=5.0-preview.3" -UseDefaultCredentials).valueЧтобы восстановить проект, используйте следующий скрипт. Обязательно обновите
$collectionUrlи$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'
Проект и связанные данные восстанавливаются.
Вопросы и ответы
Ознакомьтесь со следующими часто задаваемыми вопросами об удалении проектов в Azure DevOps.
Вопрос. После удаления одного проекта почему рабочие элементы в оставшемся проекте по-прежнему имеют ссылки на удаленные рабочие элементы проекта?
Ответ. Ссылки на рабочие элементы, указывающие на удаленные рабочие элементы проекта, останутся до тех пор, пока проект не будет окончательно удален. После окончательного удаления проекта ссылки рабочих элементов автоматически очищаются в течение 24 часов. Если вам нужно, чтобы ссылки на рабочий элемент были удалены быстрее, чем это, вы можете вручную удалить их из формы рабочего элемента напрямую.
Вопрос. Я удалил проект в Azure DevOps, но в Visual Studio Team Explorer все еще есть, что делать?
Ответ. Подождите 28 дней до окончательного удаления проекта.
Использование ИИ для управления удалением и восстановлением проекта
Подсказка
Вы можете использовать ИИ, чтобы помочь с этой задачей далее в этой статье или ознакомиться с Включение помощи ИИ с сервером Azure DevOps MCP для начала работы.
Если вы используете GitHub Copilot, Azure DevOps MCP Server поможет вам безопасно удалить, восстановить и очистить проекты Azure DevOps с помощью запросов естественного языка.
Примеры запросов на удаление и восстановление проекта
| задачи | Пример запроса |
|---|---|
| Планирование безопасного удаления проекта | I need to delete an obsolete project but want to preserve its build definitions and work item history first. Walk me through exporting the critical data before I delete the project |
| Восстановление случайно удаленного проекта | A team member accidentally deleted our staging project yesterday. Show me how to restore it before the 28-day permanent deletion window expires and verify all repos and pipelines are intact |
| Очистка после миграции | We migrated from Azure DevOps Server to Azure DevOps Services and have leftover projects in the old collection. Guide me through identifying which ones are safe to hard-delete from the admin console |
| Аудит проектов для оценки кандидатов на удаление | List all projects in my organization that have had zero commits, no pipeline runs, and no work item updates in the last 6 months so I can evaluate them for deletion |
| Автоматизация удаления проекта с помощью ИНТЕРФЕЙСА командной строки | I need to delete 5 test projects we created during a proof of concept. Show me how to use the Azure DevOps CLI to delete them in batch and verify each deletion completed |
| Устранение неполадок с неработающими ссылками рабочего элемента | After deleting a project, work items in our other projects still show links to the deleted project. Explain when these links get cleaned up and how to remove them manually if needed |
Подсказка
Для получения наилучших результатов используйте эти запросы в режиме агента с подключенным сервером MCP Azure DevOps. Настройте запросы с определенным именем проекта, организацией или сценарием миграции.