Event Grid - ARM quickstart

Author: spelluru

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

@@ -0,0 +1,113 @@
+---
+title: 'Send Blob storage events to web endpoint - template'
+description: Use Azure Event Grid and an Azure Resource Manager template to create Blob storage account, and subscribe its events. Send the events to a Webhook.'
+services: event-grid 
+keywords: 
+author: spelluru
+ms.author: spelluru
+ms.date: 01/15/2020
+ms.topic: quickstart
+ms.service: event-grid
+---
+# Route Blob storage events to web endpoint by using Azure Resource Manager template
+Azure Event Grid is an eventing service for the cloud. In this article, you use an **Azure Resource Manager template** to create a Blob storage account, subscribe to events for that blob storage, and trigger an event to view the result. Typically, you send events to an endpoint that processes the event data and takes actions. However, to simplify this article, you send the events to a web app that collects and displays the messages.
+
+[Resource Manager template](../azure-resource-manager/templates/overview.md) is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. The template uses declarative syntax, which lets you state what you intend to deploy without having to write the sequence of programming commands to create it. If you want to learn more about developing Resource Manager templates, see [Resource Manager documentation](/azure/azure-resource-manager/).
+
+If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
+
+## Prerequisites
+### Create a message endpoint
+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.
+
+1. Select **Deploy to Azure** to deploy the solution to your subscription. In the Azure portal, provide values for the parameters.
+
+   <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>
+
+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: 
+`https://<your-site-name>.azurewebsites.net`
+
+1. You see the site but no events have been posted to it yet.
+
+   ![View new site](./media/blob-event-quickstart-portal/view-site.png)
+
+
+## Create a storage account with an Event Grid subscription
+The template used in this quickstart is from [Azure Quickstart templates](https://github.com/Azure/azure-quickstart-templates/tree/master/101-event-grid-subscription-and-storage).
+
+[!code-json[<Azure Resource Manager template create Blob strage Event Grid subscription>](~/quickstart-templates/101-event-grid-subscription-and-storage/azuredeploy.json)]
+
+Two Azure resources are defined in the template:
+
+* **Microsoft.Storage/storageAccounts**: create an Azure Storage account.
+* **"Microsoft.Storage/storageAccounts/providers/eventSubscriptions**: create an Azure Event Grid subscription for the storage account. 
+
+You can find more Azure Key Vault template samples [here](https://azure.microsoft.com/en-us/resources/templates/?resourceType=Microsoft.Eventgrid).
+
+1. Select the following image to sign in to Azure and open a template. The template creates a key vault and a secret.
+
+    <a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F101-event-grid-subscription-and-storage%2Fazuredeploy.json"><img src="./media/quick-create-template/deploy-to-azure.png" alt="deploy to azure"/></a>
+2. Select or enter the following values.
+    
+    - **Subscription**: select an Azure subscription.
+    - **Resource group**: select the resource group that contains the web application that you deployed earlier. 
+    - **Location**: select a location.  For example, **Central US**.
+    - **Endpoint**: provide the URL of your web app and add `api/updates` to the home page URL.
+3. Select **Purchase** to deploy the template. 
+
+The Azure portal is used to deploy the template. In addition to the Azure portal, you can also use the Azure PowerShell, Azure CLI, and REST API. To learn other deployment methods, see [Deploy templates](../azure-resource-manager/templates/deploy-powershell.md).
+
+## Validate the deployment
+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.
+
+   ![View subscription event](./media/blob-event-quickstart-portal/view-subscription-event.png)
+
+Now, let's trigger an event to see how Event Grid distributes the message to your endpoint.
+
+## Send an event to your endpoint
+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.
+
+When you upload the file to the Azure Blob storage, Event Grid sends a 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. 
+
+   ```json
+   [{
+    "topic": "/subscriptions/{subscription-id}/resourceGroups/eventgroup/providers/Microsoft.Storage/storageAccounts/demoblob0625",
+    "subject": "/blobServices/default/containers/eventcontainer/blobs/testfile.txt",
+    "eventType": "Microsoft.Storage.BlobCreated",
+    "eventTime": "2018-06-25T22:50:41.1823131Z",
+    "id": "0000000000-0000-0000-0000-000000000000",
+    "data": {
+      "api": "PutBlockList",
+      "clientRequestId": "000000000-0000-0000-0000-000000000000",
+      "requestId": "000000000-0000-0000-0000-000000000000",
+      "eTag": "0x8D5DAEE13C8F9ED",
+      "contentType": "text/plain",
+      "contentLength": 4,
+      "blobType": "BlockBlob",
+      "url": "https://demoblob0625.blob.core.windows.net/eventcontainer/testfile.txt",
+      "sequencer": "00000000000000000000000000001C24000000000004712b",
+      "storageDiagnostics": {
+        "batchId": "ef633252-32fd-464b-8f5a-0d10d68885e6"
+      }
+    },
+    "dataVersion": "",
+    "metadataVersion": "1"
+   }]
+   ```
+
+You see that the event data has been sent to the web app.
+
+![View results](./media/blob-event-quickstart-portal/view-results.png)
+
+
+
+## Clean up resources
+When no longer needed, [delete the resource group](../azure-resource-manager/management/delete-resource-group.md?tabs=azure-portal#delete-resource-group
+). 
+
+## Next steps
+For more information about Azure Resource Manager templates, see the following articles:
+
+- [Azure Resource Manager documentation](/azure/azure-resource-manager)
+- [Define resources in Azure Resource Manager templates](/azure/templates/)
+- [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/)

articles/event-grid/toc.yml

@@ -19,6 +19,9 @@
       href: ../storage/blobs/storage-blob-event-quickstart-powershell.md?toc=%2fazure%2fevent-grid%2ftoc.json
     - name: Portal
       href: blob-event-quickstart-portal.md
+    - name: Template
+      displayName: arm, resource manager template 
+      href: blob-event-quickstart-template.md      
   - name: Custom events
     items:
     - name: Azure CLI