Azure DevOps 服务 |Azure DevOps Server |Azure DevOps Server 2022
测试项目(如测试计划、测试套件和测试用例)都是Azure DevOps中的工作项。 删除它们在 Azure DevOps Server 中永久,但在 Azure DevOps 服务中可恢复。 了解删除过程和恢复选项有助于安全地删除。
Tip
可以在本文后面使用 AI 来帮助完成此任务,或参阅启用 Azure DevOps MCP Server 的 AI 帮助以开始使用。
了解删除行为
Azure DevOps服务和Azure DevOps Server之间的删除行为有所不同。 了解每个平台如何处理删除以及可用的恢复选项有助于自信地删除。
Azure DevOps服务删除模型
Azure DevOps服务支持软删除模型。 删除测试计划或测试套件后,它们会进入 14 天的恢复期,之后才会被永久删除。
删除测试项目时会发生什么情况
从 TCM 数据存储中删除
- 已删除的测试项目将从测试用例管理 (TCM) 数据存储中删除。
- 将删除与测试项目关联的基础工作项。
删除子项
- 后台作业会从 TCM 数据存储和底层工作项中删除所有子项。
- 此过程可能需要几分钟时间,具体取决于要删除的项目数。
软删除
- 工作项跟踪数据存储和 TCM 数据存储中的所有信息都处于软删除状态,可以在 14 天内还原。
永久删除
- 在任何情况下,都无法重新激活或还原已删除的数据。
若要在 14 天软删除阶段还原已删除的测试计划或测试套件,请执行以下操作:
- 运行 List API 以获取要还原的 测试计划 和 /。
- 如果列表 API 返回包含要还原的测试计划或测试套件的响应,请运行 测试计划/测试套件 的 PATCH API 以还原它们。
- 如果列表 API 未返回要还原的测试计划或测试套件,则会从系统永久删除它,并且无法还原。
还原已删除的测试计划或套件
在 14 天的软删除阶段,可以还原已删除的测试计划和套件:
- 调用列表 API,通过 GET 获取要还原的测试计划/测试套件。
- 如果列表 API 返回包含要还原的测试计划或套件的响应,请运行 Test Plan/Test Suite 的 PATCH API 以还原它们。
- 如果列表 API 未返回要还原的测试计划或套件,则会永久删除它,并且无法恢复。
重要限制
- 删除后,测试计划和测试套件处于软删除状态 14 天。 在此时间段后,它们将被永久删除,无法还原。
- 还原测试计划或套件时,也会还原所有子项目(测试套件、测试用例)。
- 不支持还原与测试计划和套件关联的测试运行。
- 通过 API 或非门户方法删除的测试用例将被永久删除,无法还原。
Azure DevOps Server删除模型
重要说明
永久和不可逆删除:Azure DevOps Server仅支持永久删除测试项目,包括测试计划、测试套件、测试用例、共享步骤和共享参数。 无法还原已删除的工件,并且所有与其关联的子项,例如测试结果,都会被删除。 此外,不支持批量删除测试项目。
在删除测试项目之前备份任何必要的信息,因为此操作无法撤消。
删除测试项目时会发生什么情况
从 TCM 数据存储中删除:
- 已删除的测试项目将从测试用例管理 (TCM) 数据存储中删除。
- 将删除与测试项目关联的基础工作项。
删除子项:
- 后台作业会从 TCM 数据存储和底层工作项中删除所有子项。
- 此过程可能需要几分钟时间,具体取决于要删除的项目数。
永久删除:
- 此过程永久删除工作项跟踪数据存储和 TCM 数据存储中的所有信息。
- 在任何情况下,都无法重新激活或还原已删除的数据。
先决条件
| 类别 | 要求 |
|---|---|
| 访问级别 | 基本 + 测试计划或Visual Studio Enterprise 来管理或删除测试项目。 具有 基本 访问权限的用户只能删除孤立的测试用例(测试用例未链接到任何测试计划或套件)。 |
| 权限——测试运行 | Project Administrators 组的成员,或项目级别的 删除测试运行 权限设置为 允许。 |
| 权限 - 测试计划和套件 | Project管理员组的成员,或区域路径节点级管理测试计划或管理测试套件权限设置为“允许”。 |
注意
如果你不是项目管理员,则需要同时具有项目级别的 删除测试运行 权限以及相应的区域路径节点级权限。
Tip
不确定你是否具有正确的权限? 请参阅 “验证删除权限 ”部分。
支持测试体验的工作项类型
下图演示了一组支持测试体验和使用 Microsoft 测试管理器的工作项类型。 这些工作项类型使用所示的链接类型链接在一起。
从 Web 门户或 Microsoft 测试管理器中,可以查看针对测试套件定义了哪些测试用例,以及针对测试计划定义了哪些测试套件。 但是,这些对象并没有通过链接类型而互相连接。 有关这些工作项类型中使用的每个字段的定义,请参阅基于生成和测试集成字段的查询。
删除测试项目
Warning
删除测试项目是永久性的,无法撤消。 在 Azure DevOps 服务中,有 14 天时间还原已删除的测试计划和测试套件。 在Azure DevOps Server中,删除是即时和永久的。 在确认删除之前,请仔细验证所选内容。
删除测试用例
- 转到要删除的测试用例。
- 从操作菜单中选择 “永久删除 ”。
- 在弹出的对话框中确认删除。
注意
仅当具有必要的权限和访问级别时, 永久删除 选项才可用。
删除测试套件
- 转到要删除的测试套件。
- 从操作菜单中选择 “永久删除 ”。
- 在弹出的对话框中确认删除。
删除测试计划
选项 A:从测试计划视图中删除
- 转到要删除的测试计划。
- 从操作菜单中选择 “永久删除 ”。
- 在弹出的对话框中确认删除。
选项 B:从测试计划中心中删除
- 打开 测试计划。
- 在列表中查找要删除的测试计划。
- 右键单击测试计划(或选择计划旁边的 ···菜单 图标)。
- 选择 删除。
- 确认删除。
删除共享步骤或共享参数
- 打开要删除的共享步骤或共享参数。
- 选择“ 显示引用 ”以查看链接到此项的所有测试用例。
- 对于每个测试用例,请打开它并删除指向共享步骤或参数的链接。
- 删除所有引用后,返回到共享步骤或参数并选择 “永久删除”。
- 确认删除。
注意
如果“ 永久删除 ”选项已禁用,请验证是否删除了所有引用。 系统会阻止删除测试用例仍然引用的共享步骤或参数。
验证删除权限
在尝试删除测试项目之前,请验证你是否具有所需的权限:
- 转到 “项目设置>权限”。
- 搜索您的用户账户或团队。
- 验证是否已将以下权限设置为 “允许” :
- 删除测试运行 (用于删除测试结果)
- 管理测试计划 或 管理测试套件 (用于删除测试计划和套件)
- 请检查你的访问级别是否为 基本 + 测试计划 或更高级别。
- 如果权限不正确,请与项目管理员联系。
有关详细信息,请参阅 “管理测试项目”权限。
排查测试工件删除问题
“永久删除”选项未显示
可能的原因:
- 您的访问级别低于 Basic + Test Plans 级别。
- 您没有此工件所需的权限。
- 您没有此位置的区域路径权限。
解决方法:
- 检查访问级别:转到 配置文件>安全性 以查看当前的访问级别。
- 验证权限:请参阅 “验证删除权限”。
- 如果你不是项目管理员,请让管理员分配所需的权限。
删除速度缓慢或超时
可能的原因:
- 测试工件具有多个子项(测试用例、测试套件、测试结果)。
- 后台任务仍在处理删除操作。
- 网络连接问题
解决方法:
- 大型删除可能需要几分钟时间。 请留出一些时间让后台作业完成。
- 等待几分钟后刷新页面以验证删除。
- 检查网络连接,然后重试。
删除后工件仍然显示(Azure DevOps Services)
可能的原因:
- 该对象处于软删除状态(14 天恢复期)。
解决方法:
- 在Azure DevOps服务中,已删除的测试计划和测试套件在 14 天的恢复时段内在某些视图中保持可见。
- 该构件将在 14 天后被永久删除。
- 若要在此窗口中还原项目,请参阅 还原已删除的测试计划或套件 (在上面的简介部分)。
无法删除共享步骤或参数
可能的原因:
- 共享步骤或参数仍具有来自测试用例的引用。
解决方法:
- 打开共享的步骤或参数。
- 选择“ 显示引用 ”以查看所有链接的测试用例。
- 打开每个测试用例并删除链接。
- 再次尝试删除。
有关详细信息,请参阅上面的 “删除共享步骤”或“共享参数 ”。
通过 REST API 删除测试项目
还可以使用 Azure DevOps REST API 以编程方式删除测试项目。 此方法适用于自动化、批量删除或与 CI/CD 管道的集成。
删除测试用例
DELETE https://dev.azure.com/{organization}/{project}/_apis/test/testcase/{testCaseId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]
删除测试套件
DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}/suites/{suiteId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]
删除测试计划
DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]
注意
- 用实际值替换
{organization}、{project}、{planId}、{suiteId}和{testCaseId}。 - 使用 API 版本
7.1或更高版本。 检查 REST API 版本控制 是否有当前版本。 - 在 Azure DevOps 服务中,可以在 14 天的软删除窗口中通过 API 还原已删除的项目。
- 在Azure DevOps Server中,通过 API 删除是永久性的。
- 使用 个人访问令牌(PAT) 或 OAuth 令牌进行身份验证。
有关完整的 API 详细信息,请参阅 测试计划回收站 API 参考。
使用 AI 删除测试项目
如果为组织配置Azure DevOps MCP 服务器,可以使用它通过自然语言大规模查找和删除测试项目。 此方法特别适用于批量删除或难以手动执行的复杂查询。
下面是自然语言查询的常见模式:
| 任务 | 示例提示 |
|---|---|
| 删除测试计划 | Delete test plan <TestPlanName> in project <Contoso> |
| 查找旧的测试项目 | List all test plans in project <Contoso> that aren't updated in the last 6 months |
| 删除已放弃的测试套件 | Find all test suites in project <Contoso> that have no test runs in the last 90 days and delete them |
| 查找重复的测试用例 | Identify duplicate test cases in test suite <SuiteName> that have the same title and steps |
| 按标记批量删除测试用例 | Delete all test cases marked with tag "deprecated" in project <Contoso> |
| 删除孤立的共享步骤 | Find shared steps in project <Contoso> that aren't referenced by any test cases |
| 验证删除影响 | Before I delete test plan <TestPlanName>, show me how many test cases, test suites, and test runs are associated with it |
| 删除旧的测试结果 | Delete all test results older than 1 year from test plan <TestPlanName> |
| 计划构件清理 | What test artifacts in project <Contoso> can I safely delete to clean up the test data |
注意
代理模式和 MCP 服务器使用自然语言,因此你可以调整这些提示或提出后续问题来优化结果。 在Azure DevOps Server中,测试项目删除是永久性的,无法还原,因此请仔细验证你的选择。