你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure AI 项目 REST API 允许你使用 AI 项目，AI 项目是将模型、数据、工具和遥测数据汇集在一起的中心资源。 使用熟悉的 HTTP 动词，您可以创建项目、配置与其他 Azure 服务的安全 连接 ，并检索用于推理、代理、评估等的即用型终端节点。 由于您附加的每个服务都位于单个项目连接字符串后面，因此应用程序只需知道一个凭证和一个基 URL 即可访问它们所需的一切。
Authentication
Azure AI 项目 REST API 支持用于身份验证的 Microsoft Entra ID 令牌。 尚不支持 Azure 资源密钥。
访问由 Azure 基于角色的访问控制 （RBAC） 控制。 有关更多详细信息，请参阅 什么是 Azure 基于角色的访问控制 （Azure RBAC）？ 和 Azure AI Foundry 的基于角色的访问控制。
版本控制
Azure AI 项目 REST API 提供两种类型的版本控制：
- 不断发展的版本：这些版本遵循 v# 格式（例如 v1、v2、v3）。 顾名思义，不断发展的版本包含对协定的非 中断 性变更，例如向请求添加可选参数或向响应添加新属性。 使用这些版本的客户端应设计为处理附加更改。
- 固定版本：这些是基于日期的版本，不包括合同更改。 下表说明了这些版本的工作原理。
| 时间线 | 进化版本 | 固定版本 | 注释 |
|---|---|---|---|
| 5 月 25 日 | v1 | 5/1/2025 | 如果客户不希望对合同进行任何更改，则可以使用基于日期的版本。 需要所有最新非中断性变更的客户可以使用 v1。 |
| 非中断性变更 1 | v1 | 无 | 使用 v1 的客户将自动能够使用非中断性变更 1。 |
| 非中断性变更 2 | v1 | 无 | 使用 v1 的客户将自动能够使用非中断性变更 2。 |
| 非中断性变更 3 | v1 | 无 | 使用 v1 的客户将自动能够使用非中断性变更 3。 |
| 3 个月间隔 | v1 | 8/1/2025 | 需要非中断性变更 1、2 和 3 且无进一步更改的客户可以使用 2025-08-01 版本。 |
| 非中断性变更 4 | v1 | 无 | 使用 v1 的客户将自动能够使用非中断性变更 4。 |
| 非中断性变更 5 | v1 | 无 | 使用 v1 的客户将自动能够使用非中断性变更 5。 |
| 非中断性变更 6 | v1 | 无 | 使用 v1 的客户将自动能够使用非中断性变更 6。 |
| 3 个月间隔 | v1 | 11/1/2025 | 需要非中断性变更 4、5 和 6 且没有进一步更改的客户可以使用 2025-11-01 版本。 |
| （假设）2025 年 1 月的重大更改 | v2 | 1/1/2026 | 由于存在重大更改，客户需要切换到 v2 或 2026-01-01 版本才能访问这些更改。 |
| 弃用公告 | 所有以前的版本都将标记为已弃用： * 2025-05-01 * 2025-08-01 * 2025-11-01 * v1 他们将在一年后退休。 |
||
| 非中断性变更 7 | v2 | 无 | 使用 v2 的客户将自动能够使用非中断性变更 7。 |
| 非中断性变更 8 | v2 | 无 | 使用 v2 的客户将自动能够使用非中断性变更 8。 |
| 非中断性变更 9 | v2 | 无 | 使用 v2 的客户将自动能够使用非中断性变更 9。 |
| 3 个月间隔 | v2 | 3/1/2026 | 需要非中断性变更 7、8 和 9 且无进一步更改的客户可以使用 2026-03-01 版本。 |
非中断性变更
非中断性变更的定义如下：
- 向 REST API 和 SDK 添加新资源 （URL）
- 添加新的可选 API 参数
- 向 JSON 响应对象或事件数据添加新属性
- 更改 JSON 响应对象中的属性顺序
- 更改不透明字符串（如资源标识符和 UUID）的长度或格式
- 添加新的事件类型（在流式处理或 Realtime API 中）