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