How to specify a query parameter in a custom HTTP route of an Azure Function?

Question

I have an Azure Function and I want to set a custom HTTP endpoint. Following the answer to this SO question, I ended up with something like this:

[FunctionName("DoSomething")]
public static async Task<IActionResult> Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "v1/tenants/{tenantId}/locations/{locationId}/products?manufacturer={manufacturer}")]
                HttpRequest request, ILogger logger, string tenantId, string locationId, string manufacturer)
{
        // 
}

However, the route is not accepted by the Webjob:

"v1/tenants/{tenantId}/locations/{locationId}/products?manufacturer={manufacturer}"

The reason is because of the question mark '?':

An error occurred while creating the route with name 'DoSomething' and template 'api/v1/tenants/{tenantId}/locations/{locationId}/products?manufacturer={manufacturer}'. The literal section 'products?manufacturer=' is invalid. Literal sections cannot contain the '?' character. Parameter name: routeTemplate The literal section 'products?manufacturer=' is invalid. Literal sections cannot contain the '?' character.

Question

How can I specify a query parameter in a custom HTTP endpoint of my Azure Function?

Answer 1

I am afraid it's not possible to put query parameter in Route.

Microsoft.AspNetCore.Routing: The literal section 'products?manufacturer=' is invalid. Literal sections cannot contain the '?' character.

It's a built-in restriction of ASP.NET Routing, which is used by Azure Function to build route for Http trigger.

allow me to get the value as one of the Run's method parameters instead of poking at the HttpRequest instance

If it's the reason why you want to put query parameter in route, I would suggest you add IDictionary<string, string> query in method signature and use query["manufacturer"] to access the parameter in function code. But honestly it's almost the same as request.Query["manufacturer"].

Or you may have to follow the recommendation, transform the query parameter to route like products/{productId}.