.NET 5 Azure Functions 能否将HttpRequestData参数绑定到CosmosInput？

完全可以通过Azure Functions原生的Cosmos DB输入绑定实现需求，无需自行编写Cosmos客户端操作逻辑，以下是具体实现方式：

标准实现方案 #

1. 绑定规则说明 #

CosmosInput绑定原生支持引用HTTP触发器的路由参数、查询字符串参数、POST请求Body的顶层字段，只需要在SqlQuery属性中用{参数名}占位符对应HTTP传入的参数即可，参数名大小写敏感。

2. 依赖安装 #

先安装适配.NET 5隔离进程模型的NuGet包：Microsoft.Azure.Functions.Worker.Extensions.CosmosDB（3.0.9及以上版本）。

3. 代码示例 #

using Microsoft.Azure.Functions.Worker;
using Microsoft.Azure.Functions.Worker.Http;
using Microsoft.Azure.Functions.Worker.Extensions.CosmosDB;
using System.Collections.Generic;
using System.Net;

public class CosmosQueryFunction
{
    [Function("GetDataFromCosmos")]
    public static HttpResponseData Run(
        // HTTP触发器，可自定义路由参数
        [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = "query/{tenantId}")] HttpRequestData req,
        // CosmosInput绑定直接引用HTTP传入的参数
        [CosmosDBInput(
            databaseName: "你的数据库名",
            containerName: "你的容器名",
            SqlQuery = "SELECT * FROM c WHERE c.tenantId = {tenantId} AND c.status = {status}",
            Connection = "CosmosDBConnection"
        )] IEnumerable<dynamic> queryResult,
        // 路由参数、查询参数会自动注入
        string tenantId,
        string status
    )
    {
        var response = req.CreateResponse(HttpStatusCode.OK);
        response.WriteAsJsonAsync(queryResult);
        return response;
    }
}

以上示例中，tenantId是路由路径参数，status是查询字符串参数/POST Body顶层字段，请求地址形如GET /api/query/001?status=enabled时，参数会自动传入Cosmos查询语句中。
连接字符串需要配置在函数应用的应用设置中，本地调试时放在local.settings.json的Values节点下即可。

非常规兜底方案 #

如果需要更灵活的参数引用，可以直接在SQL查询中用显式绑定表达式指定参数来源，无需额外声明入参：

[CosmosDBInput(
    databaseName: "你的数据库名",
    containerName: "你的容器名",
    SqlQuery = "SELECT * FROM c WHERE c.category = {Request.Query.category} AND c.createTime >= {Request.Body.minTime}",
    Connection = "CosmosDBConnection"
)] IEnumerable<dynamic> queryResult

这种写法支持直接读取HTTP请求的查询参数、Body字段、Header等所有HttpRequestData对象的公开属性值。

内容的提问来源于stack exchange，提问作者KorsaR