你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
适用于：基本 v2 |标准 v2 |高级 v2
API 管理 v2 层 (SKU) 基于新的、更可靠且可缩放的平台构建，旨在支持 API 管理可供一组更广泛的客户访问，并为更广泛的方案提供灵活的选项。 v2 层除了现有经典层（开发人员层、基本层、标准层和高级层）外，还有消耗层。 请参阅 API 管理层的详细比较。
以下 v2 层已正式发布：
基本 v2 - 基本 v2 层专为开发和测试方案而设计，支持 SLA。
标准 v2 - 标准 v2 是一个生产就绪层，支持网络隔离的后端。
以下 v2 层处于预览状态：
- Premium v2 - Premium v2 提供企业功能，包括完全虚拟网络隔离、用于高容量工作负载的缩放和工作空间。
关键功能
更快地部署、配置和缩放 - 在几分钟内部署生产就绪的 API 管理实例。 快速应用证书和主机名更新等配置。 将基本 v2 或标准 v2 实例快速扩展到最多 10 个单位，以满足 API 管理工作负载的需求。 将高级 v2 实例扩展到最多 30 个单位。
简化的网络 - 标准 v2 和高级 v2 层提供了用于隔离 API 管理的入站和出站流量的网络选项。
用于生产工作负载的更多选项 - v2 层都支持 SLA。
开发人员门户选项 - 准备好让 API 使用者发现 API 后，启用开发人员门户。
Features
API 版本
API 管理 API 版本 2024-05-01 或更高版本支持 v2 层的最新功能。
网络选项
标准 v2 和 高级 v2 支持虚拟网络集成，从而支持 API 管理实例访问在单个已连接虚拟网络中隔离的 API 后端。 API 管理网关、管理平面和开发人员门户仍可从 Internet 公开访问。 虚拟网络必须与 API 管理实例位于同一区域和订阅中。 了解详细信息。
标准 v2 还支持与 API 管理网关建立入站 专用终结点连接 。
高级 v2 还支持简化的虚拟网络注入，以完全隔离入站和出站网关流量，而无需使用网络安全组规则、路由表或服务终结点。 虚拟网络必须与 API 管理实例位于同一区域和订阅中。 了解详细信息。
支持的区域
有关可使用 v2 层的区域的当前列表，请参阅 v2 层和工作区网关的可用性。
经典功能可用性
v2 层支持经典 API 管理层的大多数功能。 但是，v2 层不支持以下功能：
- 使用 Git 进行 API 管理服务配置
- 备份和还原 API 管理实例
- 启用 Azure DDoS 防护
- 直接管理 API 访问
Limitations
以下 API 管理功能当前在 v2 层中不可用。
基础结构和网络
- 多区域部署
- 可用性区域支持
- 多个自定义域名
- 容量指标 - 已替换为网关的 CPU 百分比和网关指标的内存百分比
- 内置分析 - 已替换为基于 Azure Monitor 的仪表板
- 从经典层升级到 v2 层
- CA 证书
- 将事件发送到事件网格
- 事件中心事件指标
开发人员门户
- Reports
- 自定义 HTML 代码小组件和自定义小组件
Gateway
- 自托管网关
- 密码配置
- 客户端证书重新协商
- 免费托管 TLS 证书
- 通过 localhost 向网关发出的请求
资源限制
以下资源限制适用于 v2 层。
有关 API 管理限制和实例中管理这些限制的背景信息，请参阅 了解 API 管理服务限制。
注释
除非另有说明，否则限制按服务实例进行。
计算 API 和 API 相关资源（例如 API作、后端、标记等）的数量时，API 管理还包括 API 版本和修订。
| Resource | 基本 v2 | 标准 v2 | 高级 v2 |
|---|---|---|---|
| 缩放单元 | 10 | 10 | 30 |
| 缓存大小 | 250 MB | 1GB | 5 GB |
| API（包括版本和修订） | 150 | 500 | 2,500 |
| API 操作 | 3,000 | 10,000 | 20,000 |
| 订阅 | 500 | 2,000 | 4,000 |
| Products | 50 | 200 | 400 |
| 用户 | 300 | 2,000 | 4,000 |
| Groups | 20 | 100 | 200 |
| 授权服务器 | 10 | 500 | 500 |
| 策略片段 | 50 | 50 | 100 |
| OpenID Connect 提供程序 | 10 | 10 | 20 |
| 证书 | 100 | 100 | 100 |
| Backends | 100 | 100 | 100 |
| Caches | 100 | 100 | 100 |
| 命名值 | 100 | 100 | 100 |
| 日志记录器 | 100 | 100 | 100 |
| Schemas | 100 | 100 | 100 |
| 每个 API 的架构 | 100 | 100 | 100 |
| 标记 | 100,000 | 100,000 | 100,000 |
| 每个 API 的标记数 | 500 | 500 | 500 |
| 版本集 | 100 | 100 | 100 |
| 每个 API 的发布版本 | 100 | 100 | 100 |
| 每个 API 的操作 | 200 | 200 | 200 |
| GraphQL 解析器 | 100 | 100 | 100 |
| 每个 API 的 GraphQL 解析器 | 100 | 100 | 100 |
| 每个产品的 API | 100 | 100 | 100 |
| 每个 API 的订阅数 | 100 | 100 | 100 |
| 每个产品的订阅数 | 100 | 100 | 100 |
| 每个产品的组数 | 100 | 100 | 100 |
| 每个产品的标记数 | 100 | 100 | 100 |
| 每个 HTTP 颁发机构的并行后端连接1 | 2,048 | 2,048 | 2,048 |
| 缓存的响应大小 | 2 MiB | 2 MiB | 2 MiB |
| 策略文档大小 | 256 KiB | 256 KiB | 256 KiB |
| 请求数据负载大小 | 1 GiB | 1 GiB | 1 GiB |
| 缓冲有效负载大小 | 2 MiB | 2 MiB | 2 MiB |
| 诊断日志中的请求与响应负载大小 | 8,192 字节 | 8,192 字节 | 8,192 字节 |
| 请求 URL 大小2 | 16384 字节 | 16384 字节 | 16384 字节 |
| URL 路径段的长度 | 1,024 个字符 | 1,024 个字符 | 1,024 个字符 |
| 命名值的字符长度 | 4,096 个字符 | 4,096 个字符 | 4,096 个字符 |
| 验证内容策略中的请求或响应正文的大小 | 100 KiB | 100 KiB | 100 KiB |
| 验证策略使用的 API 架构的大小 | 4 MB | 4 MB | 4 MB |
| 每个单元的活动 WebSocket 连接数3 | 5,000 | 5,000 | 5,000 |
1 除非被后端明确关闭，否则将共用并重新使用连接。
2 包含最长 2048 字节的查询字符串。
3 每个服务实例最多 60,000 个连接。
开发人员门户限制
以下限制适用于 v2 层中的开发人员门户。
| Item | 基本 v2 | 标准 v2 | 高级 v2 |
|---|---|---|---|
| 要上传的媒体文件数 | 15 | 15 | 15 |
| 媒体文件的大小 | 500 KB | 500 KB | 500 KB |
| 页数 | 30 | 50 | 50 |
| 小组件数1 | 30 | 50 | 50 |
| 每页元数据的大小 | 350 KB | 350 KB | 350 KB |
| 每个小组件的元数据大小1 | 350 KB | 350 KB | 350 KB |
| 每分钟客户端请求数 | 200 | 200 | 200 |
1 对内置小组件（如文本、图像或 API 列表）的限制。 目前，v2 层不支持自定义小组件和自定义 HTML 代码小组件。
Deployment
使用 Azure 门户或使用 Azure REST API、Azure 资源管理器、Bicep 文件或 Terraform 等工具部署 v2 层实例。
常见问题
问：我能否从现有 API 管理实例迁移到新的 v2 层实例？
答：否。 目前，无法将（消耗层、开发人员层、基本层、标准层或高级层中）现有的 API 管理实例迁移到新的 v2 层实例。 目前，v2 层仅适用于新建的服务实例。
问：stv2 计算平台与 v2 层之间是什么关系？
答：它们不相关。 stv2 是开发人员、基本、标准和高级层服务实例的计算平台版本。 stv2 是 2024 年停用的 stv1 计算平台的继任者。
问：我是否仍能够预配开发人员、基本、标准或高级层服务？
答：是，经典开发人员、基本、标准或高级层没有更改。
问：标准 v2 层中的虚拟网络集成与高级和高级 v2 层中的虚拟网络注入有何区别？
答：标准 v2 服务实例可以与虚拟网络集成，以提供对驻留在该处的后端的安全访问。 与虚拟网络集成的标准 v2 服务实例具有用于入站访问的公共 IP 地址。
高级层和高级 v2 层通过部署（注入）到虚拟网络支持完全网络隔离，而无需公开公共 IP 地址。 详细了解 API 管理中的网络选项。
问：我能否完全在虚拟网络中部署基本 v2 层或标准 v2 层的实例？
答：否，此类部署仅在高级层和高级 v2 层中受支持。