Azure API管理-开发门户:在操作视图上显示产品级别策略?

时间:2018-08-16 10:32:01

标签: azure documentation-generation azure-api-management

我们最近启动了一个项目,通过该项目,我们通过Azure的API管理门户(AAPIM)运行一组REST API,然后将它们路由到我们的后端系统。

我们有一些适用于所有操作的策略(基本上是安全标头),因此,我们将它们应用于产品级别,而不是将其应用于每个操作,这在逻辑上是合理的,并且似乎在AAPIM处理REST请求时有效

但是,问题是产品级别策略没有被拉到操作页面上,因此它并没有真正向开发人员显示操作的全部要求。 这也意味着“尝试一下”不包含标题,因此开发人员需要手动添加标题(这显然不理想)。

我的期望是,这些策略将像处理请求时一样在开发人员门户网站上逐步降级? 我已经阅读了有关更新页面模板和可用数据(但无济于事)的Developer Portal文档。 例如,产品对象似乎不具有该操作用于输出策略的相关属性。 考虑一下,在产品级别设置的此类策略不会在开发人员门户上的任何位置显示。 在“所有API”级别应用时也会发生同样的情况。

我错过了什么吗?还是不可能?

1 个答案:

答案 0 :(得分:0)

在APIM中,策略被视为API实施细节的一部分,因此不会以任何方式影响在Dev Portal中如何显示API。对于Dev Portal唯一重要的是API /操作规范。当前尚无法在API级别声明Operations的通用标头,唯一支持的方法是在Operation规范内部。因此,您将不得不将该信息添加到每个工序中。如果有很多使用Azure Portal中的“ Open API Specification”视图,则可能会有所帮助,因为它允许您整体编辑API,并且可以在此处复制内容。或者,您也可以通过API将其自动化。