Merge pull request #203950 from v-MarkAllen/deploy-with-arm-template-2.md

edit pass: deploy-with-arm-template-2

Author: ShawnJackson

articles/azure-video-indexer/deploy-with-arm-template.md

@@ -1,108 +1,105 @@
 ---
-title:  Deploy Azure Video Indexer with ARM template
-description: Learn how to create an Azure Video Indexer account by using Azure Resource Manager (ARM) template.
+title: Deploy Azure Video Indexer by using an ARM template
+description: Learn how to create an Azure Video Indexer account by using an Azure Resource Manager (ARM) template.
 ms.topic: tutorial
 ms.date: 05/23/2022
 ms.author: juliako
 ---
 
-# Tutorial: deploy Azure Video Indexer with ARM template
+# Tutorial: Deploy Azure Video Indexer by using an ARM template
 
-## Overview
-
-In this tutorial, you will create an Azure Video Indexer account by using Azure Resource Manager (ARM) template (preview).
-The resource will be deployed to your subscription and will create the Azure Video Indexer resource based on parameters defined in the avam.template file.
+In this tutorial, you'll create an Azure Video Indexer account by using the Azure Resource Manager template (ARM template, which is in preview). The resource will be deployed to your subscription and will create the Azure Video Indexer resource based on parameters defined in the *avam.template* file.
 
 > [!NOTE]
-> This sample is *not* for connecting an existing Azure Video Indexer classic account to an ARM-based Azure Video Indexer account.
-> For full documentation on Azure Video Indexer API, visit the [Developer portal](https://aka.ms/avam-dev-portal) page.
-> For the latest API version for Microsoft.VideoIndexer, see the [template reference](/azure/templates/microsoft.videoindexer/accounts?tabs=bicep).
+> This sample is *not* for connecting an existing Azure Video Indexer classic account to a Resource Manager-based Azure Video Indexer account.
+>
+> For full documentation on the Azure Video Indexer API, visit the [developer portal](https://aka.ms/avam-dev-portal). For the latest API version for *Microsoft.VideoIndexer*, see the [template reference](/azure/templates/microsoft.videoindexer/accounts?tabs=bicep).
 
 ## Prerequisites
 
-* An Azure Media Services (AMS) account. You can create one for free through the [Create AMS Account](/azure/media-services/latest/account-create-how-to).
+You need an Azure Media Services account. You can create one for free through [Create a Media Services account](/azure/media-services/latest/account-create-how-to).
 
 ## Deploy the sample
 
 ----
 
-### Option 1: Click the "Deploy To Azure Button", and fill in the missing parameters
+### Option 1: Select the button for deploying to Azure, and fill in the missing parameters
 
 [![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure-Samples%2Fmedia-services-video-indexer%2Fmaster%2FARM-Quick-Start%2Favam.template.json)
 
 ----
 
-### Option 2 : Deploy using PowerShell Script
+### Option 2: Deploy by using a PowerShell script
 
-1. Open The [template file](https://github.com/Azure-Samples/media-services-video-indexer/blob/master/ARM-Quick-Start/avam.template.json) file and inspect its content.
-2. Fill in the required parameters (see below)
-3. Run the Following PowerShell commands:
+1. Open the [template file](https://github.com/Azure-Samples/media-services-video-indexer/blob/master/ARM-Quick-Start/avam.template.json) and inspect its contents.
+2. Fill in the required parameters.
+3. Run the following PowerShell commands:
 
-    * Create a new Resource group on the same location as your Azure Video Indexer account, using the [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup) cmdlet.
+   * Create a new resource group on the same location as your Azure Video Indexer account by using the [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup) cmdlet.
 
-    ```powershell
-    New-AzResourceGroup -Name myResourceGroup -Location eastus
-    ```
+     ```powershell
+      New-AzResourceGroup -Name myResourceGroup -Location eastus
+     ```
 
-    * Deploy the template to the resource group using the [New-AzResourceGroupDeployment](/powershell/module/az.resources/new-azresourcegroupdeployment) cmdlet.
+   * Deploy the template to the resource group by using the [New-AzResourceGroupDeployment](/powershell/module/az.resources/new-azresourcegroupdeployment) cmdlet.
 
-    ```powershell
-    New-AzResourceGroupDeployment -ResourceGroupName myResourceGroup -TemplateFile ./avam.template.json
-    ```
+     ```powershell
+     New-AzResourceGroupDeployment -ResourceGroupName myResourceGroup -TemplateFile ./avam.template.json
+     ```
 
 > [!NOTE]
-> If you would like to work with bicep format, see [Deploy by using Bicep](./deploy-with-bicep.md).
+> If you want to work with Bicep format, see [Deploy by using Bicep](./deploy-with-bicep.md).
 
 ## Parameters
 
 ### name
 
 * Type: string
-* Description: Specifies the name of the new Azure Video Indexer account.
-* required: true
+* Description: The name of the new Azure Video Indexer account.
+* Required: true
 
 ### location
 
 * Type: string
-* Description: Specifies the Azure location where the Azure Video Indexer account should be created.
+* Description: The Azure location where the Azure Video Indexer account should be created.
 * Required: false
 
 > [!NOTE]
-> You need to deploy Your Azure Video Indexer account in the same location (region) as the associated Azure Media Services(AMS) resource exists.
+> You need to deploy your Azure Video Indexer account in the same location (region) as the associated Azure Media Services resource.
 
 ### mediaServiceAccountResourceId
 
 * Type: string
-* Description: The Resource ID of the Azure Media Services(AMS) resource.
+* Description: The resource ID of the Azure Media Services resource.
 * Required: true
 
 ### managedIdentityId
 
 * Type: string
-* Description: The Resource ID of the Managed Identity used to grant access between Azure Media Services(AMS) resource and the Azure Video Indexer account.
+* Description: The resource ID of the managed identity that's used to grant access between Azure Media Services resource and the Azure Video Indexer account.
 * Required: true
 
 ### tags
 
 * Type: object
-* Description: Array of objects that represents custom user tags on the Azure Video Indexer account
-
-    Required: false
+* Description: The array of objects that represents custom user tags on the Azure Video Indexer account.
+* Required: false
 
 ## Reference documentation
 
 If you're new to Azure Video Indexer, see:
 
-* [Azure Video Indexer Documentation](./index.yml)
-* [Azure Video Indexer Developer Portal](https://api-portal.videoindexer.ai/)
-* After completing this tutorial, head to other Azure Video Indexer samples, described on [README.md](https://github.com/Azure-Samples/media-services-video-indexer/blob/master/README.md)
+* [Azure Video Indexer documentation](./index.yml)
+* [Azure Video Indexer developer portal](https://api-portal.videoindexer.ai/)
+
+After you complete this tutorial, head to other Azure Video Indexer samples described in [README.md](https://github.com/Azure-Samples/media-services-video-indexer/blob/master/README.md).
 
 If you're new to template deployment, see:
 
 * [Azure Resource Manager documentation](../azure-resource-manager/index.yml)
-* [Deploy Resources with ARM Template](../azure-resource-manager/templates/deploy-powershell.md)
-* [Deploy Resources with Bicep and Azure CLI](../azure-resource-manager/bicep/deploy-cli.md)
+* [Deploy resources with ARM templates](../azure-resource-manager/templates/deploy-powershell.md)
+* [Deploy resources with Bicep and the Azure CLI](../azure-resource-manager/bicep/deploy-cli.md)
 
 ## Next steps
 
-[Connect an existing classic paid Azure Video Indexer account to ARM-based account](connect-classic-account-to-arm.md)
+Connect a [classic paid Azure Video Indexer account to a Resource Manager-based account](connect-classic-account-to-arm.md).