Passing parameter to Azure Function (HttpTrigger) in URL as querystring

Question

Created a new Azure Function in Visual Studio 2017 (HTTPTrigger based) and having difficulty passing parameters with custom route. Below is the code excerpt:

[FunctionName("RunTest")]
public static async Task<HttpResponseMessage> Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = "orchestrators/contoso_function01/{id:int}/{username:alpha}")] HttpRequestMessage req, TraceWriter log)
{
    log.Info("C# HTTP trigger function processed a request.");

    // parse query parameter
    string name = req.GetQueryNameValuePairs()
        .FirstOrDefault(q => string.Compare(q.Key, "id", true) == 0)
        .Value;

    string instanceId = req.GetQueryNameValuePairs()
        .FirstOrDefault(q => string.Compare(q.Key, "username", true) == 0)
        .Value;

    if (name == null)
    {
        // Get request body
        dynamic data = await req.Content.ReadAsAsync<object>();
        name = data?.name;
    }

    return name == null
        ? req.CreateResponse(HttpStatusCode.BadRequest, "Please pass a name on the query string or in the request body")
        : req.CreateResponse(HttpStatusCode.OK, "Hello " + name);
}

I tried to access the Function with the below URLs, but couldn't retrieve the ID or UserName values from the query string using the GetQueryNameValuePairs() API, as it has only 0 items in the collection:

http://localhost:7071/api/orchestrators/contoso_function01/123/abc
http://localhost:7071/api/orchestrators/contoso_function01/?id=123&username=abc

ihimv · Accepted Answer · 2022-06-22 06:04:57Z

If you want to use parameters in the URL itself instead of reading them from the HttpRequestMessage req object, the following can be done,

Example URL:

http://localhost:7201/api/orchestrators/contoso_function01/{id}/{username}

Supporting code:

[FunctionName("RunTest")]
public static async Task<HttpResponseMessage> Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", "post", 
        Route = "orchestrators/contoso_function01/{id}/{username}")]
    HttpRequestMessage req, int id, string username, TraceWriter log)
{
    log.Info($"Id = {id}, Username = {username}");
    // more code goes here...
}

Here we made two changes:

Adding id and username as part of URL.

Route = "orchestrators/contoso_function01/{id}/{username}"
Declaring two additional variables for id and username. The name of the variables has to match the parameter name in the URL (case insensitive).

HttpRequestMessage req, int id, string username, TraceWriter log

Side Note: Do not remove the HttpRequestMessage req from the function paramter even if it is not used in your code. Removing the same will stop binding of the parameters (not sure if it is intended or a bug).

This solution was tested on Azure Functions Version 3.

Further Reading: Serverless C# with Azure Functions: HTTP-Triggered Functions.

This worked for me. I was trying like {id:int} and {username:string} and getting binding errors. Once I dropped the types it worked great

KyleMit · Accepted Answer · 2021-06-15 17:10:53Z

Not sure if this is the right way to handle such a need to pass parameters for HTTP Requests with Azure Functions, but if I include parameters for each of the query string with matching parameter names (which apparently is mandatory to get the bindings work), it automatically gets assigned with the value passed in the URL to the respective parameter.

[FunctionName("HttpRunSingle")]
public static async Task<HttpResponseMessage> Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = "orchestrators/contoso_function01/{id:int}/{username:alpha}")]
    HttpRequestMessage req,
    int id,
    string username,
    TraceWriter log)
{
    log.Info("C# HTTP trigger function processed a request.");
            
    return (id == 0 || string.IsNullOrEmpty(username))
        ? req.CreateResponse(HttpStatusCode.BadRequest, "Please pass a name on the query string or in the request body")
        : req.CreateResponse(HttpStatusCode.OK, "Hello " + id + " " + username);
}

halfelf · Accepted Answer · 2019-05-08 01:40:36Z

1

you can do it like:

var query = System.Web.HttpUtility.ParseQueryString(req.RequestUri.Query);
string userid = query.Get("username");

edited May 8, 2019 at 1:40

halfelf

10.2k13 gold badges60 silver badges68 bronze badges

answered May 8, 2019 at 1:17

Deepak Shaw

6777 silver badges10 bronze badges

Comments

KyleMit · Accepted Answer · 2021-06-15 17:14:55Z

0

I tried all kinds of stuff. This is the only thing that would work for me.

string RawUrl = url;
int index = RawUrl.IndexOf("?");
if (index > 0)
    RawUrl = RawUrl.Substring(index).Remove(0, 1);

var query = System.Web.HttpUtility.ParseQueryString(RawUrl);
userId = query.Get("id");

It works well with a Url like this.

https://www.bing.com?id=12345678955&test=12345

Make sure and add this before using statements to get System.Web.HttpUtility.ParseQueryString to work.

#r "System.Web"

edited Jun 15, 2021 at 17:14

KyleMit♦

31.3k74 gold badges516 silver badges711 bronze badges

answered Jul 6, 2020 at 18:37

Dumber_Texan2

1,0362 gold badges19 silver badges46 bronze badges

Collectives™ on Stack Overflow

Passing parameter to Azure Function (HttpTrigger) in URL as querystring

4 Answers 4

1 Comment

Comments

Comments

Comments

Hot Network Questions

Collectives™ on Stack Overflow

4 Answers 4

1 Comment

Comments

Comments

Comments

Related