Merge pull request #216972 from spelluru/egridfunc1102

updated steps and screenshots

Author: BCS2022

articles/event-grid/custom-event-to-function.md

@@ -1,63 +1,105 @@
 ---
 title: 'Quickstart: Send custom events to Azure Function - Event Grid'
 description: 'Quickstart: Use Azure Event Grid and Azure CLI or portal to publish a topic, and subscribe to that event. An Azure Function is used for the endpoint.'
-ms.date: 09/28/2021
+ms.date: 11/02/2022
 ms.topic: quickstart
 ms.custom: mode-other, devx-track-azurecli 
 ms.devlang: azurecli
 ---
 
 # Quickstart: Route custom events to an Azure Function with Event Grid
 
-Azure Event Grid is an eventing service for the cloud. Azure Functions is one of the supported event handlers. In this article, you use the Azure portal to create a custom topic, subscribe to the custom topic, and trigger the event to view the result. You send the events to an Azure Function.
+[Azure Event Grid](overview.md) is an eventing service for the cloud. Azure Functions is one of the [supported event handlers](event-handlers.md). In this article, you use the Azure portal to create a custom topic, subscribe to the custom topic, and trigger the event to view the result. You send the events to an Azure Function.
 
 [!INCLUDE [quickstarts-free-trial-note.md](../../includes/quickstarts-free-trial-note.md)]
 
-## Create Azure Function
+## Create Azure function app
+
+1. Sign in to the [Azure portal](https://portal.azure.com).
+1. On the left navigational menu, select **All services**.
+1. Select **Compute** in the list of **Categories**.
+1. Hover (not select) the mouse over **Function App**, and select **Create**.
+
+    :::image type="content" source="./media/custom-event-to-function/create-function-app-link.png" lightbox="./media/custom-event-to-function/create-function-app-link.png" alt-text="Screenshot showing the select of Create link for a Function App.":::    
+1. On the **Basics** page of the **Create Function App** wizard, follow these steps: 
+    1. Select your **Azure subscription** in which you want to create the function app.
+    1. Create a new **resource group** or select an existing resource group.
+    1. Specify a **name** for the function app.
+    1. Select **.NET** for **Runtime stack**.
+    1. Select the **region** closest to you. 
+    1. Select **Next: Hosting** at the bottom of the page. 
+    
+        :::image type="content" source="./media/custom-event-to-function/create-function-app-page.png" alt-text="Screenshot showing the Basics tab of the Create Function App page.":::    
+1. On the **Hosting** page, create a new storage account or select an existing storage account to be associated with the function app, and then select **Review + create** at the bottom of the page. 
+        
+    :::image type="content" source="./media/custom-event-to-function/create-function-app-hosting-page.png" alt-text="Screenshot showing the Hosting tab of the Create Function App page.":::  
+1. On the **Review + create** page, review settings, and select **Create** at the bottom of the page to create the function app.   
+1. Once the deployment is successful, select **Go to resource** to navigate to the home page for the function app. 
+
+## Create a function
 Before subscribing to the custom topic, create a function to handle the events. 
 
-1. Create a function app using instructions from [Create a function app](../azure-functions/functions-get-started.md).
 1. On the **Function App** page, select **Functions** on the left menu. 
-1. Select **+Create** on the toolbar to create a function.
+1. Select **+ Create** on the toolbar to create a function.
+
+    :::image type="content" source="./media/custom-event-to-function/create-function-link.png" alt-text="Screenshot showing the selection of Create function link.":::  
+    
 1. On the **Create Function** page, follow these steps:
     1. This step is optional. For **Development environment**, select the development environment that you want to use to work with the function code. 
-    1. Select **Azure Event Grid Trigger** in the **Select a template** section. 
-    1. Enter a name for the function. In this example, it's **HandleEventsFunc**. 
+    1. Select **Azure Event Grid Trigger** in the **Select a template** section. Use the scroll bar right to the list to scroll down if needed.
+    1. In the **Template details** section in the bottom pane, enter a name for the function. In this example, it's **HandleEventsFunc**. 
 
         :::image type="content" source="./media/custom-event-to-function/function-event-grid-trigger.png" lightbox="./media/custom-event-to-function/function-event-grid-trigger.png" alt-text="Select Event Grid trigger.":::
-4. Use the **Code + Test** page to see the existing code for the function and update it. 
+4. On the **Function** page for the **HandleEventsFunc**, select **Code + Test** on the left navigational menu. 
 
     :::image type="content" source="./media/custom-event-to-function/function-code-test-menu.png" alt-text="Image showing the selection Code + Test menu for an Azure function.":::
+5. Replace the code with the following code.
 
-[!INCLUDE [event-grid-register-provider-portal.md](../../includes/event-grid-register-provider-portal.md)]
+    ```csharp
+    #r "Azure.Messaging.EventGrid"
+    #r "System.Memory.Data"
+    
+    using Azure.Messaging.EventGrid;
+    using System;
+    
+    public static void Run(EventGridEvent eventGridEvent, ILogger log)
+    {
+        log.LogInformation(eventGridEvent.Data.ToString());
+    }        
+    ```
+    :::image type="content" source="./media/custom-event-to-function/function-updated-code.png" alt-text="Screenshot showing the Code + Test view of an Azure function with the updated code.":::    
+6. Select **Monitor** on the left menu, and then select **Logs**. 
+
+    :::image type="content" source="./media/custom-event-to-function/monitor-page.png" alt-text="Screenshot showing the Monitor view the Azure function.":::    
+7. Keep this window or tab of the browser open so that you can see the received event information. 
 
 ## Create a custom topic
 
-An event grid topic provides a user-defined endpoint that you post your events to. 
+An Event Grid topic provides a user-defined endpoint that you post your events to. 
 
-1. Sign in to [Azure portal](https://portal.azure.com/).
-2. Select **All services** on the left navigational menu, search for **Event Grid**, and select **Event Grid Topics**. 
+1. On a new tab of the web browser window, sign in to [Azure portal](https://portal.azure.com/).
+2. In the search bar at the topic, search for **Event Grid Topics**, and select **Event Grid Topics**. 
 
-    :::image type="content" source="./media/custom-event-to-function/select-event-grid-topics.png" alt-text="Image showing the selection of Event Grid Topics.":::
-3. On the **Event Grid Topics** page, select **+ Add** on the toolbar. 
+    :::image type="content" source="./media/custom-event-to-function/select-event-grid-topics.png" alt-text="Image showing the selection of Event Grid topics.":::
+3. On the **Event Grid Topics** page, select **+ Create** on the command bar.
 
-    :::image type="content" source="./media/custom-event-to-function/add-event-grid-topic-button.png" alt-text="Image showing the Create button to create an event grid topic.":::
+    :::image type="content" source="./media/custom-event-to-function/add-event-grid-topic-button.png" alt-text="Screenshot showing the Create button to create an Event Grid topic.":::
 4. On the **Create Topic** page, follow these steps:
     1. Select your **Azure subscription**.
     2. Select the same **resource group** from the previous steps.
     3. Provide a unique **name** for the custom topic. The topic name must be unique because it's represented by a DNS entry. Don't use the name shown in the image. Instead, create your own name - it must be between 3-50 characters and contain only values a-z, A-Z, 0-9, and "-".
-    4. Select a **location** for the event grid topic.
+    4. Select a **location** for the Event Grid topic.
     5. Select **Review + create**. 
 
         :::image type="content" source="./media/custom-event-to-function/create-custom-topic.png" alt-text="Image showing the Create Topic page.":::      
     1. On the **Review + create** page, review settings and select **Create**. 
-5. After the custom topic has been created, select **Go to resource** link to see the following Event Grid Topic page for the topic you created. 
+5. After the custom topic has been created, select **Go to resource** link to see the following Event Grid topic page for the topic you created. 
 
-    :::image type="content" source="./media/custom-event-to-function/event-grid-topic-home-page.png" alt-text="Image showing the home page for your Event Grid custom topic.":::
+    :::image type="content" source="./media/custom-event-to-function/event-grid-topic-home-page.png" lightbox="./media/custom-event-to-function/event-grid-topic-home-page.png" alt-text="Image showing the home page for your Event Grid custom topic.":::
 
 ## Subscribe to custom topic
 
-You subscribe to an event grid topic to tell Event Grid which events you want to track, and where to send the events.
+You subscribe to an Event Grid topic to tell Event Grid which events you want to track, and where to send the events.
 
 1. Now, on the **Event Grid Topic** page for your custom topic, select **+ Event Subscription** on the toolbar.
 
@@ -89,15 +131,28 @@ The first example uses Azure CLI. It gets the URL and key for the custom topic,
 1. In the Azure portal, select **Cloud Shell**. Select **Bash** in the top-left corner of the Cloud Shell window. 
 
     :::image type="content" source="./media/custom-event-quickstart-portal/cloud-shell-bash.png" alt-text="Image showing Cloud Shell - Bash window":::
+1. Set the `topicname` and `resourcegroupname` variables that will be used in the commands. 
+
+    Replace `TOPICNAME` with the name of your Event Grid topic. 
+
+    ```azurecli
+    topicname="TOPICNAME"
+    ```
+
+    Replace `RESOURCEGROUPNAME` with the name of the Azure resource group that contains the Event Grid topic. 
+
+    ```azurecli
+    resourcegroupname="RESOURCEGROUPNAME"
+    ```
 1. Run the following command to get the **endpoint** for the topic: After you copy and paste the command, update the **topic name** and **resource group name** before you run the command. 
 
     ```azurecli
-    endpoint=$(az eventgrid topic show --name <topic name> -g <resource group name> --query "endpoint" --output tsv)
+    endpoint=$(az eventgrid topic show --name $topicname -g $resourcegroupname --query "endpoint" --output tsv)
     ```
 2. Run the following command to get the **key** for the custom topic: After you copy and paste the command, update the **topic name** and **resource group** name before you run the command. 
 
     ```azurecli
-    key=$(az eventgrid topic key list --name <topic name> -g <resource group name> --query "key1" --output tsv)
+    key=$(az eventgrid topic key list --name $topicname -g $resourcegroupname --query "key1" --output tsv)
     ```
 3. Copy the following statement with the event definition, and press **ENTER**. 
 
@@ -118,6 +173,9 @@ The second example uses PowerShell to perform similar steps.
 
     ```powershell
     $resourceGroupName = <resource group name>
+    ```
+
+    ```powershell
     $topicName = <topic name>
     ```
 3. Run the following commands to get the **endpoint** and the **keys** for the topic:
@@ -160,7 +218,7 @@ The second example uses PowerShell to perform similar steps.
 ### Verify that function received the event
 You've triggered the event, and Event Grid sent the message to the endpoint you configured when subscribing. Navigate to your Event Grid triggered function and open the logs. You should see a copy of the data payload of the event in the logs. If you don't make sure you open the logs window first, or hit reconnect, and then try sending a test event again.
 
-:::image type="content" source="./media/custom-event-to-function/successful-function.png" alt-text="Image showing the Monitor view of the Azure function with a log.":::
+:::image type="content" source="./media/custom-event-to-function/successful-function.png" lightbox="./media/custom-event-to-function/successful-function.png" alt-text="Image showing the Monitor view of the Azure function with a log.":::
 
 ## Clean up resources
 If you plan to continue working with this event, don't clean up the resources created in this article. Otherwise, delete the resources you created in this article.