实体 ID
一个 ID 是赋予 TeamCity 实体（项目、 构建配置、 模板、 VCS 根 等等）的标识符。
每个实体都有两个标识符：
Universally Unique ID ，或者 UUID
所谓的 外部标识符 是在 TeamCity 网络用户界面中配置的（例如，项目 ID）并且在整个服务器上，同类型的所有对象中必须是唯一的。 构建配置和模板共享相同的 ID 空间。
ID 只能包含字母数字和下划线 （_） — 最多 80 个字符 — 并且应该以拉丁字母开头。
使用外部 ID：
在网络界面的URL中（包括 NuGet 供稿），例如，
https://teamcity.jetbrains.com/project.html?projectId=TeamCityPluginsByJetBrains；在 REST API 和用于自动化 TeamCity 操作的构建脚本中（例如，通过直接 URL 或 Ivy 下载工件）；
在存储项目和构建配置设置的配置文件中，位于
<TeamCity Data Directory>/配置；在文件和目录名称中，位于
<TeamCity Data Directory>/system（例如，构建工件存储）。
默认情况下，TeamCity 会自动为对象建议一个 ID，它会将其名称转换以匹配 ID 的要求，并以父项目的 ID 作为前缀。 ID 可以手动修改。
建议保留自动生成的 ID，除非有特殊考量才需要修改它们。
如果您考虑在几个 TeamCity 服务器安装之间移动项目，确保所有 ID 全球唯一是一个好习惯。
note
更改项目或构建配置的 ID 后，所有相关的 URL （包括网页 UI，工件下载链接和 REST API）都将发生变化。 如果任何包含旧 ID 的 URLs 被添加到书签或硬编码到脚本中，它们将停止运行，并需要进行更新。 在 ID 更改的时刻，位于 TeamCity 数据目录下的对应命名的目录（包括存储设置和工件的目录）会被重命名，这可能需要一些时间。
要重置 ID 以匹配所有项目、VCS 根、构建配置和模板的默认方案，请在父 项目的 管理 页面上使用 批量编辑 ID 操作。 要在 ID 被修改后或更改现有对象名称后使用自动生成的 ID，您可以使用 重新生成 ID 操作重新生成 ID。
当您复制一个项目时，TeamCity会自动为所有子元素分配新的ID。 ID 可以在 复制 对话框中预览和修改。 当您移动一个对象时，其 ID 会被保留，您可能需要使用 重新生成 ID 操作使 ID 反映新的位置。
TeamCity 项目、构建配置和 VCS 根都有一个 UUID ，这是一个自动生成的，全球唯一的 ID。 UUID 存储在位于 <TeamCity Data Directory>/配置 目录中的相应实体 XML 配置文件中。 这些 UUID 绝对不能手动编辑。 当通过将文件放置到数据目录来创建新的实体时，它不应具有任何 uuid 属性。 TeamCity会自动生成UUID，并将其持久化在文件中。