You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/event-grid/blob-event-quickstart-portal.md
+22-25Lines changed: 22 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,12 +1,13 @@
1
1
---
2
-
title: 'Use Azure Event Grid to send Blob storage events to web endpoint - portal'
2
+
title: Send Blob storage events to web endpoint - portal
3
3
description: 'Quickstart: Use Azure Event Grid and Azure portal to create Blob storage account, and subscribe its events. Send the events to a Webhook.'
4
-
ms.date: 11/27/2023
4
+
ms.date: 12/12/2024
5
5
ms.topic: quickstart
6
6
ms.custom: mode-ui
7
+
# Customer intent: I want to know how a web endpoint can receive and respond to Blob storage events.
7
8
---
8
9
9
-
# Use Azure Event Grid to route Blob storage events to web endpoint (Azure portal)
10
+
# Quickstart: Use Azure Event Grid to route Blob storage events to web endpoint (Azure portal)
10
11
Event Grid is a fully managed service that enables you to easily manage events across many different Azure services and applications. It simplifies building event-driven and serverless applications. For an overview of the service, see [Event Grid overview](overview.md).
11
12
12
13
In this article, you use the Azure portal to do the following tasks:
@@ -18,7 +19,7 @@ In this article, you use the Azure portal to do the following tasks:
When you're finished, you see that the event data has been sent to the web app.
22
+
When you're finished, you see that the event data is sent to the web app.
22
23
23
24
:::image type="content" source="./media/blob-event-quickstart-portal/view-results.png" alt-text="Screenshot that shows the sample Azure Event Grid Viewer app with an event.":::
24
25
@@ -32,14 +33,15 @@ When you're finished, you see that the event data has been sent to the web app.
32
33
1. On the **Storage account** page, select **Create** to start creating the storage account. To subscribe to events, create either a general-purpose v2 storage account or a Blob storage account.
33
34
1. On the **Create storage account** page, do the following steps:
34
35
1. Select your Azure subscription.
35
-
2. For **Resource group**, create a new resource group or select an existing one.
36
-
3. Enter the name for your storage account.
36
+
1. For **Resource group**, create a new resource group or select an existing one.
37
+
1. Enter the **name** for your storage account.
37
38
1. Select the **Region** in which you want the storage account to be created.
39
+
1. For **Primary service**, select **Azure Blob Storage or Azure Data Lake Storage Gen 2**.
38
40
1. For **Redundancy**, select **Locally-redundant storage (LRS)** from the drop-down list.
39
-
1. Select **Review** at the bottom of the page.
41
+
1. Select **Review + create** at the bottom of the page.
40
42
41
43
:::image type="content" source="./media/blob-event-quickstart-portal/create-storage-account-page.png" alt-text="Screenshot showing the Create a storage account page.":::
42
-
5. On the **Review**page, review the settings, and select **Create**.
44
+
5. On the **Review + create**tab, review the settings, and select **Create**.
43
45
44
46
>[!NOTE]
45
47
> Only storage accounts of kind **StorageV2 (general purpose v2)** and **BlobStorage** support event integration. **Storage (general purpose v1)** does *not* support integration with Event Grid.
@@ -48,7 +50,7 @@ When you're finished, you see that the event data has been sent to the web app.
48
50
:::image type="content" source="./media/blob-event-quickstart-portal/go-to-resource-link.png" alt-text="Screenshot showing the deployment succeeded page with a link to go to the resource.":::
49
51
1. On the **Storage account** page, select **Events** on the left menu.
50
52
51
-
:::image type="content" source="./media/blob-event-quickstart-portal/events-page.png" alt-text="Screenshot showing the Events page for an Azure storage account.":::
53
+
:::image type="content" source="./media/blob-event-quickstart-portal/events-page.png" alt-text="Screenshot showing the Events page for an Azure storage account." lightbox="./media/blob-event-quickstart-portal/events-page.png":::
52
54
1. Keep this page in the web browser open.
53
55
54
56
## Create a message endpoint
@@ -71,19 +73,17 @@ Before subscribing to the events for the Blob storage, let's create the endpoint
71
73
:::image type="content" source="./media/blob-event-quickstart-portal/navigate-resource-group.png" alt-text="Screenshot showing the deployment succeeded page with a link to go to the resource group.":::
72
74
4. On the **Resource group** page, in the list of resources, select the web app that you created. You also see the App Service plan and the storage account in this list.
73
75
74
-
:::image type="content" source="./media/blob-event-quickstart-portal/resource-group-resources.png" alt-text="Screenshot that shows the selection of web app in the resource group.":::
76
+
:::image type="content" source="./media/blob-event-quickstart-portal/resource-group-resources.png" alt-text="Screenshot that shows the selection of web app in the resource group." lightbox="./media/blob-event-quickstart-portal/resource-group-resources.png":::
75
77
5. On the **App Service** page for your web app, select the URL to navigate to the web site. The URL should be in this format: `https://<your-site-name>.azurewebsites.net`.
76
78
77
79
:::image type="content" source="./media/blob-event-quickstart-portal/web-site.png" alt-text="Screenshot that shows the selection of link to navigate to web app.":::
78
-
6. Confirm that you see the site but no events have been posted to it yet.
80
+
6. Confirm that you see the site but no events are posted to it yet.
79
81
80
82

81
83
82
84
> [!IMPORTANT]
83
85
> Keep the Azure Event Grid Viewer window open so that you can see events as they are posted.
You subscribe to a topic to tell Event Grid which events you want to track, and where to send the events.
@@ -92,22 +92,20 @@ You subscribe to a topic to tell Event Grid which events you want to track, and
92
92
1. On the **Storage account** page, select **Events** on the left menu.
93
93
1. Select **More Options**, and **Web Hook**. You're sending events to your viewer app using a web hook for the endpoint.
94
94
95
-
:::image type="content" source="./media/blob-event-quickstart-portal/select-web-hook.png" alt-text="Screenshot showing the selection of Web Hook on the Events page.":::
95
+
:::image type="content" source="./media/blob-event-quickstart-portal/select-web-hook.png" alt-text="Screenshot showing the selection of Web Hook on the Events page." lightbox="./media/blob-event-quickstart-portal/select-web-hook.png":::
96
96
3. On the **Create Event Subscription** page, do the following steps:
97
97
1. Enter a **name** for the event subscription.
98
98
2. Enter a **name** for the **system topic**. To learn about system topics, see [Overview of system topics](system-topics.md).
99
+
1. Confirm that **Endpoint type** is set to **Web Hook**.
99
100
100
101
:::image type="content" source="./media/blob-event-quickstart-portal/event-subscription-name-system-topic.png" alt-text="Screenshot showing the Create Event Subscription page with a name for the system topic.":::
101
-
2. Select **Web Hook** for **Endpoint type**.
102
-
103
-
:::image type="content" source="./media/blob-event-quickstart-portal/select-web-hook-end-point-type.png" alt-text="Screenshot showing the Create Event Subscription page with Web Hook selected as an endpoint.":::
104
-
4. For **Endpoint**, choose **Select an endpoint**, and enter the URL of your web app and add `api/updates` to the home page URL (for example: `https://spegridsite.azurewebsites.net/api/updates`), and then select **Confirm Selection**.
102
+
4. For **Endpoint**, select **Configure an endpoint**, and enter the URL of your web app and add `api/updates` to the home page URL (for example: `https://spegridsite.azurewebsites.net/api/updates`), and then select **Confirm Selection**.
105
103
106
104
:::image type="content" source="./media/blob-event-quickstart-portal/confirm-endpoint-selection.png" lightbox="./media/blob-event-quickstart-portal/confirm-endpoint-selection.png" alt-text="Screenshot showing the Select Web Hook page.":::
107
105
5. Now, on the **Create Event Subscription** page, select **Create** to create the event subscription.
108
106
109
107
:::image type="content" source="./media/blob-event-quickstart-portal/create-subscription.png" alt-text="Screenshot showing the Create Event Subscription page with all fields selected.":::
110
-
1. View your web app again, and notice that a subscription validation event has been sent to it. Select the eye icon to expand the event data. Event Grid sends the validation event so the endpoint can verify that it wants to receive event data. The web app includes code to validate the subscription.
108
+
1. View your web app again, and notice that a subscription validation event is sent to it. Select the eye icon to expand the event data. Event Grid sends the validation event so the endpoint can verify that it wants to receive event data. The web app includes code to validate the subscription.
111
109
112
110
:::image type="content" source="./media/blob-event-quickstart-portal/view-subscription-event.png" alt-text="Screenshot showing the Event Grid Viewer with the subscription validation event.":::
113
111
@@ -120,15 +118,15 @@ You trigger an event for the Blob storage by uploading a file. The file doesn't
120
118
1. In the Azure portal, navigate to your Blob storage account, and select **Containers** on the let menu.
121
119
1. Select **+ Container**. Give your container a name, and use any access level, and select **Create**.
122
120
123
-
:::image type="content" source="./media/blob-event-quickstart-portal/add-container.png" alt-text="Screenshot showing the New container page.":::
121
+
:::image type="content" source="./media/blob-event-quickstart-portal/add-container.png" alt-text="Screenshot showing the New container page." lightbox="./media/blob-event-quickstart-portal/add-container.png":::
124
122
1. Select your new container.
125
123
126
-
:::image type="content" source="./media/blob-event-quickstart-portal/select-container.png" alt-text="Screenshot showing the selection of the container.":::
124
+
:::image type="content" source="./media/blob-event-quickstart-portal/select-container.png" alt-text="Screenshot showing the selection of the container." lightbox="./media/blob-event-quickstart-portal/select-container.png":::
127
125
1. To upload a file, select **Upload**. On the **Upload blob** page, browse and select a file that you want to upload for testing, and then select **Upload** on that page.
:::image type="content" source="./media/blob-event-quickstart-portal/upload-file.png" alt-text="Screenshot showing the Upload blob page to upload a sample image." lightbox="./media/blob-event-quickstart-portal/upload-file.png":::
130
128
1. Browse to your test file and upload it.
131
-
1. You've triggered the event, and Event Grid sent the message to the endpoint you configured when subscribing. The message is in the JSON format and it contains an array with one or more events. In the following example, the JSON message contains an array with one event. View your web app and notice that a **blob created** event was received.
129
+
1. You triggered the event, and Event Grid sent the message to the endpoint you configured when subscribing. The message is in the JSON format and it contains an array with one or more events. In the following example, the JSON message contains an array with one event. View your web app and notice that a **blob created** event was received.
132
130
133
131
:::image type="content" source="./media/blob-event-quickstart-portal/blob-created-event.png" alt-text="Screenshot showing the Event Grid Viewer page with the Blob Created event.":::
134
132
@@ -138,11 +136,10 @@ If you plan to continue working with this event, don't clean up the resources cr
138
136
139
137
Select the resource group, and select **Delete resource group**.
140
138
141
-
## Next steps
139
+
## Related content
142
140
143
141
Now that you know how to create custom topics and event subscriptions, learn more about what Event Grid can help you do:
144
142
145
-
-[About Event Grid](overview.md)
146
143
-[Route Blob storage events to a custom web endpoint](../storage/blobs/storage-blob-event-quickstart.md?toc=%2fazure%2fevent-grid%2ftoc.json)
147
144
-[Monitor virtual machine changes with Azure Event Grid and Logic Apps](monitor-virtual-machine-changes-logic-app.md)
148
145
-[Stream big data into a data warehouse](event-hubs-integration.md)
0 commit comments