Merge pull request #262848 from spelluru/egridfresh0104

Event Grid freshness

Author: prmerger-automator[bot]

articles/event-grid/custom-event-quickstart.md

@@ -1,7 +1,7 @@
 ---
 title: 'Quickstart: Send custom events with Event Grid and Azure CLI'
 description: 'Quickstart Use Azure Event Grid and Azure CLI to publish a custom topic, and subscribe to events for that topic. The events are handled by a web application.'
-ms.date: 10/28/2022
+ms.date: 01/05/2024
 ms.topic: quickstart
 ms.custom: devx-track-azurecli, mode-api
 ---
@@ -25,7 +25,7 @@ When you're finished, you see that the event data has been sent to the web app.
 
 Event Grid topics are Azure resources, and must be placed in an Azure resource group. The resource group is a logical collection into which Azure resources are deployed and managed.
 
-Create a resource group with the [az group create](/cli/azure/group#az-group-create) command. The following example creates a resource group named *gridResourceGroup* in the *westus2* location. If you click **Try it**, you'll see the Azure Cloud Shell window in the right pane. Then, click **Copy** to copy the command and paste it in the Azure Cloud Shell window, and press ENTER to run the command. Change the name of the resource group and the location if you like. 
+Create a resource group with the [az group create](/cli/azure/group#az-group-create) command. The following example creates a resource group named *gridResourceGroup* in the *westus2* location. If you select **Try it**, you'll see the Azure Cloud Shell window in the right pane. Then, select **Copy** to copy the command and paste it in the Azure Cloud Shell window, and press ENTER to run the command. Change the name of the resource group and the location if you like. 
 
 ```azurecli-interactive
 az group create --name gridResourceGroup --location westus2
@@ -35,7 +35,7 @@ az group create --name gridResourceGroup --location westus2
 
 ## Create a custom topic
 
-An Event Grid topic provides a user-defined endpoint that you post your events to. The following example creates the custom topic in your resource group using Bash in Azure Cloud Shell. Replace `<your-topic-name>` with a unique name for your topic. The custom topic name must be unique because it's part of the DNS entry. Additionally, it must be between 3-50 characters and contain only values a-z, A-Z, 0-9, and "-"
+An Event Grid topic provides a user-defined endpoint that you post your events to. The following example creates the custom topic in your resource group using Bash in Azure Cloud Shell. Replace `<your-topic-name>` with a unique name for your topic. The custom topic name must be unique because it's part of the Domain Name System (DNS) entry. Additionally, it must be between 3-50 characters and contain only values a-z, A-Z, 0-9, and "-"
 
 1. Copy the following command, specify a name for the topic, and press ENTER to run the command. 
 
@@ -50,7 +50,7 @@ An Event Grid topic provides a user-defined endpoint that you post your events t
 
 ## Create a message endpoint
 
-Before subscribing to the custom topic, 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.
+Before subscribing to the custom topic, 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 [prebuilt 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.
 
 
 
@@ -68,7 +68,7 @@ Before subscribing to the custom topic, let's create the endpoint for the event
       --parameters siteName=$sitename hostingPlanName=viewerhost
     ```
 
-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: 
+The deployment might 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`
 
 You should see the site with no messages currently displayed.
@@ -79,19 +79,27 @@ You subscribe to an Event Grid topic to tell Event Grid which events you want to
 
 The endpoint for your web app must include the suffix `/api/updates/`.
 
-```azurecli-interactive
-endpoint=https://$sitename.azurewebsites.net/api/updates
-
-az eventgrid event-subscription create \
-  --source-resource-id "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.EventGrid/topics/$topicname" \
-  --name demoViewerSub \
-  --endpoint $endpoint
-  
-```
+1. Copy the following command, replace `$sitename` with the name of the web app you created in the previous step, and press ENTER to run the command. 
 
-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.
+    ```azurecli-interactive
+    endpoint=https://$sitename.azurewebsites.net/api/updates
+    ```
+2. Run the following command to get the resource ID of the topic you created.
+    
+    ```azurecli-interactive
+    topicresourceid=$(az eventgrid topic show --resource-group gridResourceGroup --name $topicname --query "id" --output tsv)
+    ```
+3. Run the following command to create a subscription to the custom topic using the endpoint.
+    ```azurecli-interactive
+    az eventgrid event-subscription create \
+      --source-resource-id $topicresourceid \
+      --name demoViewerSub \
+      --endpoint $endpoint      
+    ```
 
-![View the subscription event in Azure Event Grid Viewer](./media/custom-event-quickstart/viewer-subscription-validation-event.png)
+    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 the subscription event in Azure Event Grid Viewer](./media/custom-event-quickstart/viewer-subscription-validation-event.png)
 
 
 ## Send an event to your custom topic