配置主机 URL 和路由

  • 3 分钟

策略模板的常见用途是允许动态配置终结点触发器和操作将在运行时使用的 API。 以下策略模板可用：

  • 设置主机 URL - 将完整主机 URL 替换为策略构建的主机 URL。

  • 传送请求 - 将传入请求传送至配置的主机 URL 上的指定终结点。

设置主机 URL

默认情况下，使用的主机 URL 为静态配置，与连接器上的所有触发器和操作相类似。 使用设置主机 URL 策略模板可以单独配置触发器和操作的 URL。 本场景示例：您在一个 URL（例如 ordersapi.contoso.com）有订单相关操作，在另一个 URL（例如 userapi.contoso.com）有用户相关操作。 在本场景中，您将配置两个策略模板，每个模板选择适当用户或订单操作来应用新的主机 URL。

常见用途可能包括允许用户在使用自定义连接器新建连接时在运行时提供主机 URL，如本模块前文所示。 在该示例中，已将名为hostURL的属性添加到connectionParameters表达式中，用户在连接时提供完整主机 URL。

另一种使用设置主机 URL 策略模板的常见方法是动态构建部分主机 URL 并使其部分静态化。 使用这种方法时，用户仅需提供帐户名称或其他关键数据来组成完整的 URL。 Azure Key Vault 连接器是本场景的一个示例，其中各保管库的主机 URL 唯一。 您无需要求用户提供完整的保管库 URL (https://contosokv.vault.azure.net)，可以添加名为keyVaultName的连接属性，然后提示用户仅提供部分 URL（在本示例中为contosokv）。 以下示例展示本策略模板的外观。

箭头指向 URL 模板的策略详细信息屏幕截图。

除使用@connectionParameters以外，还可以使用@headers和@queryParameters表达式来包括数据。

传送请求

自定义连接器上的各项操作都具有用于向基础 API 提出请求的完全限定的 URL（比如 https://api.contoso.com/AddInvoice）。 本 URL 来自于您在常规选项卡和来自于导入或在提出导入示例请求时从示例请求提取的定义的路径（比如/AddInvoice）上指定的主机（例如 api.contoso.com）组合。 设置主机 URL策略允许您修改主机，传输请求允许您修改路径。

另一个可以使用传输请求策略完成的场景是多项操作指向同一路径。 例如列示发票操作将fromAmount作为参数，您要创建具有FromAmount默认值的列示大额发票操作，此时将出错，因为两者均指向相同路径：/ListInvoices。 相反，您可以定义路径为 /ListBigInvoices 的列示大额发票操作，该路径在 API 上不存在。 然后，您可以使用传输请求将这些操作调用发送到 /ListInvoices。 以下示例展示策略模板的外观。

显示名称、模板、操作、新路径和方法的策略详细信息屏幕截图。

您还可以添加参数和其他表达式来帮助构建路径。 例如，Microsoft Outlook 任务连接器在一组 /v2/me/taskgroups('{group_id}')/taskfolders 中的列表文件夹上具有默认路径。 使用以下传输请求时，请求将传输到新路径。

显示名称、模板、操作、新路径和具有不同值的方法的策略详细信息屏幕截图。

请注意在 {group_id} 中，请求引用操作中的一个参数，与原始路径中的引用方式相类似。

使用设置主机 URL和传输请求策略模板支持您根据需要将请求灵活传输到基础 API。