Skip to content

Latest commit

 

History

History
52 lines (33 loc) · 3.03 KB

howto-trigger-azure-functions.md

File metadata and controls

52 lines (33 loc) · 3.03 KB
title description author ms.author ms.date ms.topic ms.service services manager
Trigger Azure Functions using webhooks in Azure IoT Central
Create a function app that runs each time a rule is triggered in Azure IoT Central.
viv-liu
viviali
09/17/2018
conceptual
iot-central
iot-central
peterpr

Trigger Azure Functions using webhooks in Azure IoT Central

This topic applies to builders and administrators.

Use Azure Functions to run serverless code on the webhook output from IoT Central rules. You don't have to provision a VM or publish a web app to use Azure Functions, but instead you can run this code serverlessly. Use Azure Functions to transform the webhook payload before sending it to its final destination such as a SQL database or Event Grid.

Prerequisites

  • If you don't have an Azure subscription, create a free account before you begin.

How to connect Azure Functions

  1. Create a new function app in the Azure Portal..

    Create a new function app in the Azure Portal

  2. Expand your function app and click the + button next to Functions. If this function is the first one in your function app, select Custom function. This displays the complete set of function templates.

    Choose custom function in Function app

  3. In the search field, type "generic" and then choose your desired language for the generic webhook trigger template. This topic uses a C# function.

    Select generic webhook trigger

  4. In your new function, click </> Get function URL, then copy and save the value. You will use this value to configure the webhook.

    Get the URL of the function

  5. In IoT Central, navigate to the rule that you want to connect to your function app.

  6. Add a webhook action. Enter a Display name and paste in the function URL you copied earlier into Callback URL.

    Enter the function URL into the callback URL field

  7. Save the rule. Now when the rule is triggered, the webhook will invoke the function app to run. In your function app, you can click Monitor to see the function's invocation history. You can use App Insights or the classic view to look at the history.

    Monitor the invocation history of the function

For more information, visit the Azure Functions article about creating a function triggered by a generic webhook.

Next steps

Now that you have learned how to set up and use webhooks, the suggested next step is to explore building workflows in Microsoft Flow.