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
+28-23Lines changed: 28 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: 'Use Azure Event Grid to 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: 07/01/2021
4
+
ms.date: 10/27/2022
5
5
ms.topic: quickstart
6
6
ms.custom: mode-ui
7
7
---
@@ -36,13 +36,20 @@ When you're finished, you see that the event data has been sent to the web app.
36
36
3. Enter the name for your storage account.
37
37
1. Select the **Region** in which you want the storage account to be created.
38
38
1. For **Redundancy**, select **Locally-redundant storage (LRS)** from the drop-down list.
39
-
1. Select **Review + create**.
39
+
1. Select **Review** at the bottom of the page.
40
40
41
41
:::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 + create** page, review the settings, and select **Create**.
42
+
5. On the **Review** page, review the settings, and select **Create**.
43
43
44
44
>[!NOTE]
45
45
> 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.
46
+
1. The deployment may take a few minutes to complete. On the **Deployment** page, select **Go to resource**.
47
+
48
+
:::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
+
1. On the **Storage account** page, select **Events** on the left menu.
50
+
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.":::
52
+
1. Keep this page in the web browser open.
46
53
47
54
## Create a message endpoint
48
55
Before subscribing to the events for the Blob storage, let's create the endpoint for the event message. Typically, the endpoint takes actions based on the event data. To simplify this quickstart, you deploy a [pre-built web app](https://github.com/Azure-Samples/azure-event-grid-viewer) that displays the event messages. The deployed solution includes an App Service plan, an App Service web app, and source code from GitHub.
@@ -51,23 +58,22 @@ Before subscribing to the events for the Blob storage, let's create the endpoint
51
58
52
59
<ahref="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure-Samples%2Fazure-event-grid-viewer%2Fmaster%2Fazuredeploy.json"target="_blank"><imgsrc="../media/template-deployments/deploy-to-azure.svg"alt="Button to deploy to Azure."></a>
53
60
2. On the **Custom deployment** page, do the following steps:
54
-
1. For **Resource group**, select the resource group that you created when creating the storage account. It will be easier for you to clean up after you are done with the tutorial by deleting the resource group.
61
+
1. For **Resource group**, select the resource group that you created when creating the storage account. It will be easier for you to clean up after you're done with the tutorial by deleting the resource group.
55
62
2. For **Site Name**, enter a name for the web app.
56
63
3. For **Hosting plan name**, enter a name for the App Service plan to use for hosting the web app.
57
64
5. Select **Review + create**.
58
65
59
66
:::image type="content" source="./media/blob-event-quickstart-portal/template-deploy-parameters.png" alt-text="Screenshot showing the Custom deployment page.":::
60
67
1. On the **Review + create** page, select **Create**.
61
-
1. The deployment may take a few minutes to complete. Select Alerts (bell icon) in the portal, and then select **Go to resource group**.
68
+
1. The deployment may take a few minutes to complete. On the **Deployment** page, select **Go to resource group**.
62
69
63
-

70
+
:::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.":::
64
71
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.
65
72
66
-

73
+
:::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.":::
67
74
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`.
68
-
69
-

70
75
76
+
:::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.":::
71
77
6. Confirm that you see the site but no events have been posted to it yet.
72
78
73
79

@@ -81,29 +87,28 @@ Before subscribing to the events for the Blob storage, let's create the endpoint
81
87
82
88
You subscribe to a topic to tell Event Grid which events you want to track, and where to send the events.
83
89
84
-
1.In the portal, navigate to your Azure Storage account that you created earlier. On the left menu, select **All resources** and select your storage account.
85
-
2. On the **Storage account** page, select **Events** on the left menu.
86
-
1. Select **More Options**, and **Web Hook**. You are sending events to your viewer app using a web hook for the endpoint.
90
+
1.If you closed the **Storage account** page, navigate to your Azure Storage account that you created earlier. On the left menu, select **All resources** and select your storage account.
91
+
1. On the **Storage account** page, select **Events** on the left menu.
92
+
1. Select **More Options**, and **Web Hook**. You're sending events to your viewer app using a web hook for the endpoint.
87
93
88
-

94
+
:::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.":::
89
95
3. On the **Create Event Subscription** page, do the following steps:
90
96
1. Enter a **name** for the event subscription.
91
97
2. Enter a **name** for the **system topic**. To learn about system topics, see [Overview of system topics](system-topics.md).
92
98
93
-

99
+
:::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.":::
94
100
2. Select **Web Hook** for **Endpoint type**.
95
101
96
-

102
+
:::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.":::
97
103
4. For **Endpoint**, click **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**.
:::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.":::
104
109
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.
:::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.":::
107
112
108
113
Now, let's trigger an event to see how Event Grid distributes the message to your endpoint.
109
114
@@ -114,17 +119,17 @@ You trigger an event for the Blob storage by uploading a file. The file doesn't
114
119
1. In the Azure portal, navigate to your Blob storage account, and select **Containers** on the let menu.
115
120
1. Select **+ Container**. Give your container a name, and use any access level, and select **Create**.
:::image type="content" source="./media/blob-event-quickstart-portal/select-container.png" alt-text="Screenshot showing the selection of the container.":::
121
126
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.
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.
126
131
127
-

132
+
:::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.":::
0 commit comments