Merge pull request #108043 from mumian/0317-eventhub

Make the article compliant with the new ARM quickstart guidance

Author: Jak-MS

articles/event-hubs/TOC.yml

@@ -21,8 +21,8 @@
       href: event-hubs-quickstart-cli.md
     - name: Azure PowerShell
       href: event-hubs-quickstart-powershell.md
-    - name: Azure Resource Manager template
-      displayName: ARM
+    - name: ARM template
+      displayName: Resource Manager
       href: event-hubs-resource-manager-namespace-event-hub.md
   - name: Send and receive events
     items:
@@ -39,16 +39,16 @@
     - name: C (send only)
       href: event-hubs-c-getstarted-send.md
     - name: Apache Storm (receive only)
-      href: event-hubs-storm-getstarted-receive.md   
+      href: event-hubs-storm-getstarted-receive.md
   - name: Send and receive events (old versions/packages)
     items:
     - name: .NET Core (Microsoft.Azure.EventHubs)
       href: event-hubs-dotnet-standard-getstarted-send.md
     - name: Java (azure-eventhubs)
-      href: event-hubs-java-get-started-send.md        
+      href: event-hubs-java-get-started-send.md
     - name: Python (azure-eventhub version 1)
       href: event-hubs-python-get-started-send.md
-    - name: JavaScript (azure/event-hubs version 2)    
+    - name: JavaScript (azure/event-hubs version 2)
       href: event-hubs-node-get-started-send.md
     - name: .NET Framework (Microsoft.ServiceBus)
       href: event-hubs-dotnet-framework-getstarted-send.md
@@ -86,29 +86,29 @@
   - name: Event processor host (legacy SDK)
     href: event-hubs-event-processor-host.md
   - name: Event processor (latest SDK)
-    href: event-processor-balance-partition-load.md    
+    href: event-processor-balance-partition-load.md
   - name: Availability and consistency
     href: event-hubs-availability-and-consistency.md
   - name: Scalability
     href: event-hubs-scalability.md
   - name: Geo-disaster recovery
     items:
     - name: Geo-disaster recovery and Geo-replication
-      href: event-hubs-geo-dr.md  
+      href: event-hubs-geo-dr.md
   - name: Security
     items:
     - name: Authorization
       items:
-      - name: Authorize access to Azure Event Hubs 
-        href: authorize-access-event-hubs.md        
+      - name: Authorize access to Azure Event Hubs
+        href: authorize-access-event-hubs.md
       - name: Authorize access with Azure Active Directory
         href: authorize-access-azure-active-directory.md
       - name: Authorize access with a shared access signature
         href: authorize-access-shared-access-signature.md
     - name: Authentication
       items:
       - name: Authenticate with Azure Active Directory
-        items: 
+        items:
         - name: Authenticate with a managed identity
           href: authenticate-managed-identity.md
         - name: Authenticate from an application
@@ -125,8 +125,8 @@
 - name: How-to guides
   items:
   - name: Migrate from Azure Service Manager (classic) APIs to Resource Manager APIs
-    href: ../service-bus-messaging/deprecate-service-bus-management.md?toc=%2fazure%2fevent-hubs%2ftoc.json    
-  - name: Develop 
+    href: ../service-bus-messaging/deprecate-service-bus-management.md?toc=%2fazure%2fevent-hubs%2ftoc.json
+  - name: Develop
     items:
     - name: Get Event Hubs connection string
       href: event-hubs-get-connection-string.md
@@ -135,9 +135,9 @@
     - name: Programming guides
       items:
       - name: .NET (Azure.Messaging.EventHubs)
-        href: https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/eventhub/Azure.Messaging.EventHubs/README.md      
+        href: https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/eventhub/Azure.Messaging.EventHubs/README.md
       - name: Java (azure-messaging-eventhubs)
-        href: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/eventhubs/azure-messaging-eventhubs/README.md        
+        href: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/eventhubs/azure-messaging-eventhubs/README.md
       - name: Python (azure-eventhub version 5)
         href: https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub/README.md
       - name: JavaScript (azure/event-hubs version 5)
@@ -146,17 +146,17 @@
         href: event-hubs-programming-guide.md
   - name: Process data
     items:
-    - name: Process data using Azure Stream Analytics 
+    - name: Process data using Azure Stream Analytics
       href: process-data-azure-stream-analytics.md
   - name: Integrate with Spring framework
     items:
     - name: Create a Spring Cloud Stream Binder app
       href: /java/azure/spring-framework/configure-spring-cloud-stream-binder-java-app-azure-event-hub
-      maintainContext: true        
+      maintainContext: true
     - name: Use the Spring Boot Starter for Apache Kafka
       href: /java/azure/spring-framework/configure-spring-cloud-stream-binder-java-app-kafka-azure-event-hub
-      maintainContext: true               
-  - name: Integrate with Apache Kafka 
+      maintainContext: true
+  - name: Integrate with Apache Kafka
     items:
       - name: Create Apache Kafka-enabled event hubs
         href: event-hubs-create-kafka-enabled.md
@@ -182,7 +182,7 @@
       href: event-hubs-auto-inflate.md
     - name: Event Hubs management libraries
       href: event-hubs-management-libraries.md
-  - name: Secure 
+  - name: Secure
     items:
     - name: Configure IP firewall
       href: event-hubs-ip-filtering.md
@@ -239,7 +239,7 @@
     - name: Management library
       href: /python/api/overview/azure/event-hub?view=azure-python
   - name: JavaScript
-    items: 
+    items:
     - name: Migrate from azure/eventhubs version 2 to version 5
       href: https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/eventhub/event-hubs/migrationguide.md
     - name: Client library

articles/event-hubs/event-hubs-resource-manager-namespace-event-hub.md

@@ -14,28 +14,42 @@ ms.tgt_pltfrm: dotnet
 ms.workload: na
 ms.date: 02/11/2020
 ms.author: spelluru
+ms.custom: subject-armqs
 
 ---
 
 # Quickstart: Create an event hub by using an Azure Resource Manager template
 
-Azure Event Hubs is a Big Data streaming platform and event ingestion service, capable of receiving and processing millions of events per second. Event Hubs can process and store events, data, or telemetry produced by distributed software and devices. Data sent to an event hub can be transformed and stored using any real-time analytics provider or batching/storage adapters. For detailed overview of Event Hubs, see [Event Hubs overview](event-hubs-about.md) and [Event Hubs features](event-hubs-features.md).
+Azure Event Hubs is a Big Data streaming platform and event ingestion service, capable of receiving and processing millions of events per second. Event Hubs can process and store events, data, or telemetry produced by distributed software and devices. Data sent to an event hub can be transformed and stored using any real-time analytics provider or batching/storage adapters. For detailed overview of Event Hubs, see [Event Hubs overview](event-hubs-about.md) and [Event Hubs features](event-hubs-features.md). In this quickstart, you create an event hub by using an [Azure Resource Manager template](../azure-resource-manager/management/overview.md). You deploy an Azure Resource Manager template to create a namespace of type [Event Hubs](event-hubs-what-is-event-hubs.md), with one event hub.
 
-In this quickstart, you create an event hub by using an [Azure Resource Manager template](../azure-resource-manager/management/overview.md). You deploy an Azure Resource Manager template to create a namespace of type [Event Hubs](event-hubs-what-is-event-hubs.md), with one event hub. The article shows how to define which resources are deployed and how to define parameters that are specified when the deployment is executed. You can use this template for your own deployments, or customize it to meet your requirements. For information about creating templates, see [Authoring Azure Resource Manager templates][Authoring Azure Resource Manager templates]. For the JSON syntax and properties to use in a template, see [Microsoft.EventHub resource types](/azure/templates/microsoft.eventhub/allversions).
+[!INCLUDE [About Azure Resource Manager](../../includes/resource-manager-quickstart-introduction.md)]
 
 If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
 
+## Prerequisites
+
+None.
+
 ## Create an event hub
 
-In this quickstart, you use an [existing quickstart template](https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-eventhubs-create-namespace-and-eventhub/azuredeploy.json):
+### Review the template
+
+The template used in this quickstart is from [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/101-eventhubs-create-namespace-and-eventhub/).
 
-[!code-json[create-azure-event-hub-namespace](~/quickstart-templates/101-eventhubs-create-namespace-and-eventhub/azuredeploy.json)]
+:::code language="json" source="~/quickstart-templates/101-eventhubs-create-namespace-and-eventhub/azuredeploy.json" range="1-61" highlight="32-59":::
+
+The resources defined in the template include:
+
+- [**Microsoft.EventHub/namespaces**](/azure/templates/microsoft.eventhub/namespaces)
+- [**Microsoft.EventHub/namespaces/eventhubs**](/azure/templates/microsoft.eventhub/namespaces/eventhubs)
 
 To find more template samples, see [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/?term=eventhub&pageNumber=1&sort=Popular).
 
+### Deploy the template
+
 To deploy the template:
 
-1. Select **Try it** from the following code block, and then follow the instructions to sign in to the Azure Cloud shell.
+1. Select **Try it** from the following code block, and then follow the instructions to sign in to the Azure Cloud Shell.
 
    ```azurepowershell-interactive
    $projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
@@ -56,7 +70,7 @@ To deploy the template:
 
 ## Verify the deployment
 
-To verify the deployment, you can either open the resource group from the [Azure portal](https://portal.azure.com), or use the following Azure PowerShell script.  If the Cloud shell is still open, you don't need to copy/run the first line (Read-Host).
+To verify the deployment, you can either open the resource group from the [Azure portal](https://portal.azure.com), or use the following Azure PowerShell script.  If the Cloud Shell is still open, you don't need to copy/run the first line (Read-Host).
 
 ```azurepowershell-interactive
 $projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"
@@ -70,7 +84,7 @@ Write-Host "Press [ENTER] to continue ..."
 
 ## Clean up resources
 
-When the Azure resources are no longer needed, clean up the resources you deployed by deleting the resource group. If the Cloud shell is still open, you don't need to copy/run the first line (Read-Host).
+When the Azure resources are no longer needed, clean up the resources you deployed by deleting the resource group. If the Cloud Shell is still open, you don't need to copy/run the first line (Read-Host).
 
 ```azurepowershell-interactive
 $projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"