Azure API 管理常见问题解答

当功能处于预览状态时，这意味着我们正在积极寻求关于功能效果如何的反馈。 预览版中的功能功能功能已完成，但可能会做出重大更改，以响应客户反馈。 我们不建议您在生产环境中依赖仍处于预览阶段的功能。

订阅在这些位置发布的更新公告：

• Azure API 管理发行说明
• Azure 更新

有多种选项可用于保护 API 管理网关与后端服务之间的连接，包括：

• 使用订阅密钥身份验证。 订阅密钥本身不是一种强大的身份验证形式，但它通常与其他方法一起使用。
• 使用 TLS 相互身份验证，如 如何在 Azure API 管理中使用客户端证书身份验证来保护后端服务。
• 在后端服务上使用 IP 筛选。 在除消耗层之外的所有 API 管理层中，网关的 IP 地址保持不变。 有关详细信息，请参阅 Azure API 管理中的 IP 地址。
• 将 API 管理实例连接到 Azure 虚拟网络。

有多种选择，包括：

• 使用 API 管理中的备份和还原功能。
• 使用 API 管理 REST API 创建你自己的备份和还原功能，以保存和还原所需服务实例中的实体。
• 使用 Git 下载服务配置，并将其上传到新实例。

是的。 要了解操作方法，请参阅将资源移动到新资源组或订阅。

是的，可使用各种工具以编程方式管理 API 管理，包括：

• API 管理 REST API。
• 适用于 .NET、 JavaScript、 Java 和其他语言的 Azure 客户端 SDK。
• Azure PowerShell 和 Azure CLI。
• Azure 资源管理器 和 Bicep 文件。 请参阅示例快速入门模板。
• Terraform。

管理员组是一个不可变的系统组，其中包括 Azure 订阅管理员。 无法向此组添加用户。 有关详细信息，请参阅如何创建和使用组以管理 Azure API 管理中的开发人员帐户。

如果要添加的策略在策略编辑器中显示为灰显，请确保你位于该策略的正确范围内。 每个策略声明都设计为在特定范围和策略部分中使用。 若要查看某个策略的策略部分和范围，请参阅策略参考中的策略“用法”部分。

若要在单个 API 中设置多个环境（例如，一个测试环境和一个生产环境），则有两个选项可用。 方法：

• 在同一 API 管理实例上托管不同的 API。
• 在不同实例上托管相同的 API。

API 管理支持 REST API 以及到 SOAP、WebSocket 和 GraphQL API 的传递。 API 管理还支持合成 GraphQL API。

API 管理还与通常用于在 Azure 上生成和托管 API 的 Azure 计算服务集成，包括 Azure Functions、 Azure 逻辑应用和 Web 应用。

请参阅 OpenAPI (Swagger)、WSDL 和 WADL 格式的 API 导入限制和已知问题。

API 管理使用性能流量路由方法（最低延迟）部署到多个地理位置。 有关详细信息，请参阅将 Azure API 管理实例部署到多个 Azure 区域。

是的。

部署 API 管理所需的最小子网大小为 /29。 详细了解如何在虚拟网络中使用 API 管理。

尽管 API 管理不包括网络应用防火墙，但建议在 API 管理实例的前端部署一个网络应用防火墙。 例如，使用 Azure 应用程序网关。

有关信息，请参阅 API 管理中的 API 网关和自承载网关概述。

从历史上和惯例来看，以尾部斜杠 https://contoso.com/sample/结尾的 URL 被视为目录，而没有尾部斜杠的https://contoso.com/sample URL 表示文件。 此约定不是强制的。 有些系统认为这两个 URL 是唯一的，但另一些则认为它们相同。 API 管理不作区分，因此单个操作 resource 将接受 resource 或 resource/。 但是，区分对后端主机可能很重要。 某些 Web 服务器会自动将不以尾部斜杠结尾的 URL 重定向到以尾部斜杠结尾的相同 URL。 由于 API 管理是后端（服务器）的客户端，因此并不总是需要自动重定向。 如果需要，请创建 重写 URL 策略，以确保始终将尾部斜杠添加到出站后端请求。

否，创建 API 管理后无法更改 API 的名称（或 ID）。 但是，可以更改显示名称。

克隆 API 时，系统会创建新实例并使用系统生成的值作为名称，该名称无法更改。 若要指定 API 的名称，请手动创建新的 API 并导入 API 定义。 有关详细信息，请参阅导入 API。

可以，无需中介即可将 API 管理与其他 Azure 服务直接集成。 例如，API 管理可以直接与用于 CRUD作的 Azure Cosmos DB REST API 集成，而无需使用 Azure Functions 等中间服务。