通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure API 管理 v2 层

  • 项目

适用于：基本 v2 |标准 v2 |高级 v2

API 管理 v2 层 (SKU) 基于新的、更可靠且可缩放的平台构建，旨在支持 API 管理可供一组更广泛的客户访问，并为更广泛的方案提供灵活的选项。 v2 层除了现有经典层（开发人员层、基本层、标准层和高级层）外，还有消耗层。 请参阅 API 管理层的详细比较。

以下 v2 层已正式发布：

  • 基本 v2 - 基本 v2 层专为开发和测试方案而设计，支持 SLA。

  • 标准 v2 - 标准 v2 是一个生产就绪层，支持网络隔离的后端。

以下 v2 层处于预览状态：

  • 高级 v2 - 高级 v2 提供企业功能，包括面向大容量工作负载的完整虚拟网络隔离和缩放。

    注意

    高级 v2 层目前处于有限预览状态。 如果要注册，请填写此表单。

关键功能

  • 更快地部署、配置和缩放 - 在几分钟内部署生产就绪的 API 管理实例。 快速应用证书和主机名更新等配置。 将基本 v2 或标准 v2 实例快速扩展到最多 10 个单位，以满足 API 管理工作负载的需求。 将高级 v2 实例扩展到最多 30 个单位。

  • 简化的网络 - 标准 v2 和高级 v2 层提供了用于隔离 API 管理的入站和出站流量的网络选项。

  • 用于生产工作负载的更多选项 - v2 层都支持 SLA。

  • 开发人员门户选项 - 准备好让 API 使用者发现 API 后，启用开发人员门户。

功能

API 版本

API 管理 API 版本 2024-05-01 或更高版本支持 v2 层的最新功能。

网络选项

  • 标准 v2 和 高级 v2 支持虚拟网络集成，从而支持 API 管理实例访问在单个已连接虚拟网络中隔离的 API 后端。 API 管理网关、管理平面和开发人员门户仍可从 Internet 公开访问。 虚拟网络必须与 API 管理实例位于同一区域和订阅中。 了解详细信息。

    在预览版中，Standard v2 还支持与 API 管理网关的入站专用终结点连接。

  • 高级 v2 还支持简化的虚拟网络注入，以完全隔离入站和出站网关流量，而无需使用网络安全组规则、路由表或服务终结点。 虚拟网络必须与 API 管理实例位于同一区域和订阅中。 了解详细信息。

支持的区域

有关可使用 v2 层的区域的当前列表，请参阅 v2 层和工作区网关的可用性。

经典功能可用性

v2 层支持经典 API 管理层的大多数功能。 但是，v2 层不支持以下功能：

  • 使用 Git 进行 API 管理服务配置
  • 备份和还原 API 管理实例
  • 启用 Azure DDoS 防护
  • 直接管理 API 访问

限制

以下 API 管理功能当前在 v2 层中不可用。

基础结构和网络

  • 多区域部署
  • 可用性区域支持
  • 多个自定义域名
  • 容量指标 - 已替换为网关的 CPU 百分比和网关指标的内存百分比
  • 内置分析 - 已替换为基于 Azure Monitor 的仪表板
  • 自动缩放
  • 从经典层升级到 v2 层
  • CA 证书
  • 将事件发送到事件网格

开发人员门户

  • 报表
  • 自定义 HTML 代码小组件和自定义小组件
  • 自承载开发人员门户

网关

  • 自承载网关
  • 按密钥策略分配配额
  • 密码配置
  • 客户端证书重新协商
  • 免费托管 TLS 证书
  • 通过 localhost 向网关发出的请求

资源限制

以下资源限制适用于 v2 层。

若要请求增加限制，请从 Azure 门户创建支持请求。 有关详细信息，请参阅 Azure 支持计划。

资源 基本 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
每个服务实例的产品数上限 50 200 400
每个服务实例的用户数上限 300 2,000 4,000
每个服务实例的组数上限 20 100 200
每个服务实例的授权服务器数上限 10 500 500
每个服务实例的策略片段数上限 50 50 100
每个服务实例的 OpenID Connect 提供程序数上限 10 10 20
每个服务实例的证书数上限 100 100 100
每个服务实例的后端数上限 100 100 100
每个服务实例的缓存数上限 100 100 100
每个服务实例的命名值数上限 100 100 100
每个服务实例的记录器数上限 100 100 100
每个服务实例的架构数上限 100 100 100
每个 API 的架构数上限 100 100 100
每个服务实例的标记数上限 100 100 100
每个 API 的标记数上限 100 100 100
每个服务实例的版本集数上限 100 100 100
每个 API 的版本数上限 100 100 100
每个 API 的操作数上限 100 100 100
每个服务实例的 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 层中的开发人员门户。

项 基本 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 代码小组件。

部署

使用 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 层中受支持。

相关内容