你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
与 Azure 通信网关的预配 API（预览版）集成
本文介绍了何时需要与 Azure 通信网关的预配 API（预览版）集成，并提供了有关入门的简要概述。 本文适用于为电信运营商工作的软件开发人员。
有了预配 API，你就可以使用客户的详细信息以及分配给他们的号码来配置 Azure 通信网关。 如果使用预配 API 进行后端服务同步，则还可以使用企业客户的详细信息以及分配给他们的号码来预配 Operator Connect 和 Teams 电话移动版环境。 这种流式预配使你能够满足 Operator Connect 和 Teams 电话移动版的要求，以便在启动服务后使用 API 来管理客户和号码。
预配 API 是 REST API。
是否与 REST API 集成取决于你选择的通信服务。
| 通信服务 | 预配 API 集成 | 用途 |
|---|---|---|
| Microsoft Teams 直接路由 | 支持（作为号码管理门户的替代方法） | - 配置与每个直接路由客户关联的子域。 - 生成特定于每个客户的 DNS 记录（根据 Microsoft 365 环境的要求）。 - 表示号码已启用直接路由。 -（可选）为发送到网络的消息配置自定义标头。 |
| Operator Connect | 建议 | -（推荐）通过与 Operator Connect API 的互操作（使用后端服务同步）对 Operator Connect 客户进行流式预配。 -（可选）为发送到网络的消息配置自定义标头。 |
| Teams 电话移动版 | 建议 | -（推荐）通过与 Operator Connect API 的互操作（使用后端服务同步）对 Teams 电话移动版客户进行流式预配。 |
| Zoom Phone Cloud Peering | 支持（作为号码管理门户的替代方法） | - 表示号码已启用 Zoom。 -（可选）为发送到网络的消息配置自定义标头。 |
| Azure 运营商通话保护预览版 | 支持（作为号码管理门户的替代方法） | - 指示号码是为 Azure 运营商通话保护启用的。 - 自动预配 Azure 运营商通话保护。 |
提示
Azure 通信网关的号码管理门户提供用于手动预配的等效功能。 但是，启动服务后，无法使用号码管理门户对 Operator Connect 和 Teams Phone Mobile 进行流畅的自动预配。
先决条件
你必须已完成部署 Azure 通信网关。
你必须有权访问其 IP 地址可以访问预配 API（预览版）的计算机。 此 IP 地址（或范围）允许列表是在部署 Azure 通信网关的过程中配置的。
了解预配 API（预览版）并规划你的 BSS 客户端更改
若要与 API 集成，需要创建（或更新）一个可以联系预配 API 的 BSS 客户端。 预配 API 支持机器对机器的 OAuth 2.0 客户端凭据身份验证流。 客户端自行进行身份验证并进行授权的 API 调用，无需用户交互。
使用 API 参考中的“关键概念”和“示例”信息来了解可通过 API 获取的资源以及组织需要发出的请求。
- “帐户”资源是对运营商客户（通常是企业）以及每个客户的服务预配设置的说明。
- “号码”资源属于一个帐户。 它们描述号码、号码使用的服务（例如 Microsoft Teams 直接路由）以及任何额外的单号码配置。
- “信息请求 (RFI)”资源是对表示有兴趣通过 Operator Connect 和 Teams 电话移动版接收运营商服务的运营商客户（通常是企业）的描述。
预配 API 的速率限制为每分钟 100 个请求，并在所有资源中使用。 用于更新多个资源的批处理请求计数为一个请求。
配置 BSS 客户端以连接到 Azure 通信网关
预配 API（预览版）在 provapi.<base-domain> 的端口 443 上可用，其中 <base-domain> 是 Azure 通信网关资源的基域。
提示
若要查找基域，请执行以下操作：
- 登录 Azure 门户。
- 导航到 Azure 通信网关资源的“概述”，然后选择“属性”。
- 查找名为“域”的字段。
DNS 记录的生存时间 (TTL) 为 60 秒。 当某个区域发生故障时，Azure 会更新 DNS 记录以引用另一个区域，因此发出新的 DNS 查找的客户端将收到新区域的详细信息。 建议确保客户端可以在超时或 5xx 响应后 60 秒重试请求，并进行新的 DNS 查找。
使用 API 参考的“入门”部分配置 Azure 和 BSS 客户端，以允许 BSS 客户端访问预配 API。
以下步骤汇总了所需的 Azure 配置。 有关完整详细信息（包括所需的配置值），请参阅 API 参考的“入门”部分。
- 在 Azure 通信网关部署所在的 Azure 租户中注册 BSS 客户端。 该过程创建应用注册。
- 将你自己指定为应用注册的所有者。
- 使用 API 参考中定义的范围配置应用注册。 此配置向 Azure 指示应用程序有权访问预配 API。
- 作为租户的管理员，你允许应用程序使用你分配的应用角色。