Skip to content

Commit b2925ee

Browse files
authored
Merge pull request #111709 from spelluru/egridblobcreate0416
added as much detail as I could
2 parents 4932374 + 8ca0cb9 commit b2925ee

18 files changed

+52
-52
lines changed

articles/event-grid/blob-event-quickstart-portal.md

Lines changed: 47 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: event-grid
55
keywords:
66
author: spelluru
77
ms.author: spelluru
8-
ms.date: 11/05/2019
8+
ms.date: 04/16/2020
99
ms.topic: quickstart
1010
ms.service: event-grid
1111
ms.custom: seodec18
@@ -26,31 +26,50 @@ When you're finished, you see that the event data has been sent to the web app.
2626

2727
1. To create a Blob storage, select **Create a resource**.
2828

29-
![Create a resource](./media/blob-event-quickstart-portal/create-resource.png)
30-
3129
1. Select for **Storage** to filter the available options, and select **Storage account - blob, file, table, queue**.
3230

3331
![Select storage](./media/blob-event-quickstart-portal/create-storage.png)
3432

35-
1. To subscribe to events, create either a general-purpose v2 storage account or a Blob storage account. For more information, see [Create a storage account](../storage/common/storage-account-create.md).
33+
To subscribe to events, create either a general-purpose v2 storage account or a Blob storage account.
34+
35+
1. On the **Create storage account** page, do the following steps:
36+
1. Select your Azure subscription.
37+
2. For **Resource group**, create a new resource group or select an existing one.
38+
3. Enter the name for your storage account.
39+
4. Select **Review + create**.
3640

37-
![Start steps](./media/blob-event-quickstart-portal/provide-blob-values.png)
41+
![Start steps](./media/blob-event-quickstart-portal/provide-blob-values.png)
42+
5. On the **Review + create** page, review the settings, and select **Create**.
3843

39-
>[!NOTE]
40-
> Only storage accounts of kind **StorageV2 (general purpose v2)** and **BlobStorage** support event integration. **Storage (genral purpose v1)** does *not* support integration with Event Grid.
44+
>[!NOTE]
45+
> Only storage accounts of kind **StorageV2 (general purpose v2)** and **BlobStorage** support event integration. **Storage (genral purpose v1)** does *not* support integration with Event Grid.
4146
4247
## Create a message endpoint
4348

4449
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.
4550

46-
1. Select **Deploy to Azure** to deploy the solution to your subscription. In the Azure portal, provide values for the parameters.
51+
1. Select **Deploy to Azure** to deploy the solution to your subscription.
4752

4853
<a href="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"><img src="https://azuredeploy.net/deploybutton.png"/></a>
54+
2. On the **Custom deployment** page, do the following steps:
55+
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.
56+
2. For **Site Name**, enter a name for the web app.
57+
3. For **Hosting plan name**, enter a name for the App Service plan to use for hosting the web app.
58+
4. Select the check box for **I agree to the terms and conditions stated above**.
59+
5. Select **Purchase**.
60+
61+
![Deployment parameters](./media/blob-event-quickstart-portal/template-deploy-parameters.png)
62+
1. The deployment may take a few minutes to complete. Select Alerts (bell icon) in the portal, and then select **Go to resource group**.
4963

50-
1. The deployment may take a few minutes to complete. After the deployment has succeeded, view your web app to make sure it's running. In a web browser, navigate to:
51-
`https://<your-site-name>.azurewebsites.net`
64+
![Alert - navigate to resource group](./media/blob-event-quickstart-portal/navigate-resource-group.png)
65+
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.
5266

53-
1. You see the site but no events have been posted to it yet.
67+
![Select web site](./media/blob-event-quickstart-portal/resource-group-resources.png)
68+
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`.
69+
70+
![Navigate to web site](./media/blob-event-quickstart-portal/web-site.png)
71+
72+
6. Confirm that you see the site but no events have been posted to it yet.
5473

5574
![View new site](./media/blob-event-quickstart-portal/view-site.png)
5675

@@ -60,15 +79,20 @@ Before subscribing to the events for the Blob storage, let's create the endpoint
6079

6180
You subscribe to a topic to tell Event Grid which events you want to track, and where to send the events.
6281

63-
1. In the portal, select your blob storage and select **Events**.
64-
65-
![Select events](./media/blob-event-quickstart-portal/select-events.png)
66-
67-
1. To send events to your viewer app, use a web hook for the endpoint. Select **More Options**, and **Web Hook**.
82+
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.
83+
2. On the **Storage account** page, select **Events** on the left menu.
84+
1. Select **More Options**, and **Web Hook**. You are sending events to your viewer app using a web hook for the endpoint.
6885

6986
![Select web hook](./media/blob-event-quickstart-portal/select-web-hook.png)
87+
3. On the **Create Event Subscription** page, do the following steps:
88+
1. Enter a **name** for the event subscription.
89+
2. Select **Web Hook** for **Endpoint type**.
90+
91+
![Select web hook endpoint type](./media/blob-event-quickstart-portal/select-web-hook-end-point-type.png)
92+
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**.
7093

71-
1. The event subscription is prefilled with values for your Blob storage. For the web hook endpoint, provide the URL of your web app and add `api/updates` to the home page URL. Give your subscription a name. When done, select **Create**.
94+
![Confirm endpoint selection](./media/blob-event-quickstart-portal/confirm-endpoint-selection.png)
95+
5. Now, on the **Create Event Subscription** page, select **Create** to create the event subscription.
7296

7397
![Select logs](./media/blob-event-quickstart-portal/create-subscription.png)
7498

@@ -82,51 +106,27 @@ Now, let's trigger an event to see how Event Grid distributes the message to you
82106

83107
You trigger an event for the Blob storage by uploading a file. The file doesn't need any specific content. The articles assumes you have a file named testfile.txt, but you can use any file.
84108

85-
1. For your Blob storage, select **Blobs**.
109+
1. In the Azure portal, navigate to your Blob storage account, and select **Containers** on the **Overview** page.
86110

87111
![Select blobs](./media/blob-event-quickstart-portal/select-blobs.png)
88112

89-
1. Select **+ Container**. Give you container a name, and use any access level.
113+
1. Select **+ Container**. Give you container a name, and use any access level, and select **Create**.
90114

91115
![Add container](./media/blob-event-quickstart-portal/add-container.png)
92116

93117
1. Select your new container.
94118

95119
![Select container](./media/blob-event-quickstart-portal/select-container.png)
96120

97-
1. To upload a file, select **Upload**.
121+
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.
98122

99123
![Select upload](./media/blob-event-quickstart-portal/upload-file.png)
100124

101125
1. Browse to your test file and upload it.
102126

103-
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.
104-
105-
```json
106-
[{
107-
"topic": "/subscriptions/{subscription-id}/resourceGroups/eventgroup/providers/Microsoft.Storage/storageAccounts/demoblob0625",
108-
"subject": "/blobServices/default/containers/eventcontainer/blobs/testfile.txt",
109-
"eventType": "Microsoft.Storage.BlobCreated",
110-
"eventTime": "2018-06-25T22:50:41.1823131Z",
111-
"id": "89a2f9da-c01e-00bb-13d6-0c599506e4e3",
112-
"data": {
113-
"api": "PutBlockList",
114-
"clientRequestId": "41341a9b-e977-4a91-9000-c64125039047",
115-
"requestId": "89a2f9da-c01e-00bb-13d6-0c5995000000",
116-
"eTag": "0x8D5DAEE13C8F9ED",
117-
"contentType": "text/plain",
118-
"contentLength": 4,
119-
"blobType": "BlockBlob",
120-
"url": "https://demoblob0625.blob.core.windows.net/eventcontainer/testfile.txt",
121-
"sequencer": "00000000000000000000000000001C24000000000004712b",
122-
"storageDiagnostics": {
123-
"batchId": "ef633252-32fd-464b-8f5a-0d10d68885e6"
124-
}
125-
},
126-
"dataVersion": "",
127-
"metadataVersion": "1"
128-
}]
129-
```
127+
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.
128+
129+
![Blob created event](./media/blob-event-quickstart-portal/blob-created-event.png)
130130

131131
## Clean up resources
132132

39.3 KB
Loading
76.2 KB
Loading
77.9 KB
Loading
102 KB
Loading
52.1 KB
Loading
47.8 KB
Loading
29.1 KB
Loading
58 KB
Loading
52 KB
Loading

0 commit comments

Comments
 (0)