Azure Functions PowerShell API的OpenAPI规范配置

Question

如本 教程所述，如何通过Visual Studio Code配置运行在Azure Functions中的PowerShell API，以便可以将其作为来自该URL的 Azure API管理中的OpenAPI规范API来使用？

当前，如果我尝试将以下PowerShell API添加为Azure API管理中的OpenAPI-Specification API，则会出现错误

Unable to parse specified file. Please ensure it is valid OpenAPI specification document.

Azure函数PowerShell API URL： https : //vscpsapi.azurewebsites.net/api/VSCPSapi

Answer 1

更新资料

事情发生了变化，当我们在V2 Function应用程序中单击API定义时，请参见

V2运行时当前不支持功能API定义（Swagger）功能。

而且我们可以直接将Function应用程序导入API Management ，而无需定义API。

---

您首先需要为Azure函数创建OpenAPI定义。

请参阅创建OpenAPI定义 。

脚步：

1. 平台功能> API定义。

2. 在API定义源下，选择Function(Preview)以将您的HTTP触发器用作API处理程序。

3. 生成API定义模板>保存。

4. 将以下swagger模板粘贴为httptrigger函数模板。

然后使用您的功能应用和触发器名称对其进行修改。 如果您的功能授权级别为匿名，请删除security部分。

swagger: '2.0'
info:
  title: <myfunctionapp>.azurewebsites.net
  version: 1.0.0
host: <myfunctionapp>.azurewebsites.net
basePath: /
schemes:
  - https
  - http
paths:
  /api/<MyHttpTrigger>:
    get:
      operationId: /api/<MyHttpTrigger>/get
      description: Send a name to API to get Hello name back
      summary: Get Hello name
      parameters:
        - in: query
          name: name
          description: Name to send
          required: true
          type: string
      responses:
        '200':
          description: Return Hello name
      security:
        - apikeyQuery: []
    post:
      operationId: /api/<MyHttpTrigger>/post
      description: Send a name to API to get Hello name back
      summary: Get Hello name
      consumes:
        - application/json
      parameters:
        - name: requestbody
          in: body
          description: Name to send
          required: true
          schema:
            type: object
            properties:
              name:
                type: string
      responses:
        '200':
          description: Return Hello name
      security:
        - apikeyQuery: []
securityDefinitions:
  apikeyQuery:
    type: apiKey
    name: code
    in: query

5. 在API管理中添加API时，可以选择OpenAPI specification或Function App 。

   如果由于功能授权级别为Admin / Function而离开了安全性部分，则必须在功能下拉菜单的Manage刀片中找到功能密钥，并在Inbound Processing更新后端URL。

   

   当选择Function App时，您可能会得到一个明确的提示，要求您添加密钥。

   功能应用程序“ funcappname”已导入。 请确保将以下“命名值”的值替换为函数的机密：funcappname_triggername_query_xxxxxx。

6. 如果需要修改您的标尺，请参阅OpenAPI 2.0文档 。

Answer 2

APIM支持导入：

• OpenAPI规范
• WSDL
• 瓦德

链接中的内容-https: //vscpsapi.azurewebsites.net/api/VSCPSapi-都不是。 我完全不确定它的格式。 因此无法导入。