Merge pull request #268526 from ShawnJackson/create-account-resource-manager-template

ktoliver · web-flow · commit f2b28d7033c8 · 2024-03-13T11:29:42.000-07:00
[AQ] edit pass: create-account-resource-manager-template
diff --git a/articles/ai-services/create-account-resource-manager-template.md b/articles/ai-services/create-account-resource-manager-template.md
@@ -1,6 +1,6 @@
 ---
-title: Create an Azure AI services resource using ARM templates
-description: Create an Azure AI service resource with ARM template.
+title: "Quickstart: Create an Azure AI services resource by using an ARM template"
+description: Learn how to use an Azure Resource Manager template to create an Azure AI services resource.
 keywords: Azure AI services, cognitive solutions, cognitive intelligence, cognitive artificial intelligence
 #services: cognitive-services
 author: aahill
@@ -16,31 +16,33 @@ ms.custom:
   - ignite-2023
 ---
 
-# Create an Azure AI services resource using an ARM template
+# Quickstart: Create an Azure AI services resource by using an ARM template
 
-This quickstart shows you how to use an Azure Resource Manager template (ARM template) to create Azure AI services.
+This quickstart shows you how to use an Azure Resource Manager template (ARM template) to create a resource in Azure AI services.
 
-Azure AI services are cloud-based artificial intelligence (AI) services that help developers build cognitive intelligence into applications without having direct AI or data science skills or knowledge. They are available through REST APIs and client library SDKs in popular development languages. Azure AI services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, and analyze.
+Azure AI services is a cloud-based portfolio of AI services. It helps developers build cognitive intelligence into applications without needing direct skills or knowledge of AI or data science.
 
-Create a resource using an Azure Resource Manager template (ARM template). This multi-service resource lets you:
+Azure AI services is available through REST APIs and client library SDKs in popular development languages. It enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, and analyze.
 
-* Access multiple Azure AI services with a single key and endpoint.
-* Consolidate billing from the services you use.
-* [!INCLUDE [terms-azure-portal](./includes/quickstarts/terms-azure-portal.md)]
+By creating an Azure AI services resource, you can:
+
+* Access multiple AI services in Azure with a single key and endpoint.
+* Consolidate billing from the services that you use.
 
 [!INCLUDE [About Azure Resource Manager](../../includes/resource-manager-quickstart-introduction.md)]
 
 ## Prerequisites
 
 * If you don't have an Azure subscription, [create one for free](https://azure.microsoft.com/free/cognitive-services).
+* [!INCLUDE [terms-azure-portal](./includes/quickstarts/terms-azure-portal.md)]
 
 ## Review the template
 
-The template used in this quickstart is from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/cognitive-services-universalkey/).
+The template that you use in this quickstart is from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/cognitive-services-universalkey/).
 
 :::code language="json" source="~/quickstart-templates/quickstarts/microsoft.cognitiveservices/cognitive-services-universalkey/azuredeploy.json":::
 
-One Azure resource is defined in the Bicep file: [Microsoft.CognitiveServices/accounts](/azure/templates/microsoft.cognitiveservices/accounts) specifies that it is an Azure AI services resource. The `kind` field in the Bicep file defines the type of resource.
+One Azure resource is defined in the Bicep file: [Microsoft.CognitiveServices/accounts](/azure/templates/microsoft.cognitiveservices/accounts) specifies that it's an Azure AI services resource. The `kind` field in the Bicep file defines the type of resource.
 
 [!INCLUDE [SKUs and pricing](./includes/quickstarts/sku-pricing.md)]
 
@@ -58,21 +60,21 @@ One Azure resource is defined in the Bicep file: [Microsoft.CognitiveServices/ac
     |---------|---------|
     | **Subscription** | Select an Azure subscription. |
     | **Resource group** | Select **Create new**, enter a unique name for the resource group, and then select **OK**. |
-    | **Region** | Select a region.  For example, **East US** |
-    | **Cognitive Service Name** | Replace with a unique name for your Azure AI services resource. You will need the name in the next section when you validate the deployment. |
-    | **Location** | Replace with the region used above. |
-    | **Sku** | The [pricing tier](https://azure.microsoft.com/pricing/details/cognitive-services/) for your resource. |
+    | **Region** | Select a region (for example, **East US**). |
+    | **Cognitive Service Name** | Replace the value with a unique name for your Azure AI services resource. You'll need the name in the next section when you validate the deployment. |
+    | **Location** | Replace with the region that you selected. |
+    | **Sku** | Select the [pricing tier](https://azure.microsoft.com/pricing/details/cognitive-services/) for your resource. |
 
-    :::image type="content" source="media/arm-template/universal-key-portal-template.png" alt-text="Resource creation screen.":::
+    :::image type="content" source="media/arm-template/universal-key-portal-template.png" alt-text="Screenshot that shows the pane for resource creation.":::
 
-3. Select **Review + Create**, then **Create**. After the resource has successfully finished deploying, the **Go to resource** button will be highlighted.
+3. Select **Review + Create**, and then select **Create**. When deployment is successful, the **Go to resource** button is available.
 
 # [Azure CLI](#tab/CLI)
 
-> [!NOTE]
-> `az deployment group` create requires Azure CLI version 2.6 or later. To display the version type `az --version`. For more information, see the [documentation](/cli/azure/deployment/group).
+Run the following script from [your local machine](/cli/azure/install-azure-cli), or run it from a browser by using the **Try it** button. Include a name and location (for example, `centralus`) for a new resource group, and the ARM template will be used to deploy an Azure AI services resource within it. Remember the name that you use. You'll use it later to validate the deployment.
 
-Run the following script via the Azure CLI, either from [your local machine](/cli/azure/install-azure-cli), or from a browser by using the **Try it** button. Enter a name and location (for example `centralus`) for a new resource group, and the ARM template will be used to deploy an Azure AI services resource within it. Remember the name you use. You will use it later to validate the deployment.
+> [!NOTE]
+> The `az deployment group create` command in the script requires Azure CLI version 2.6 or later. To display the version, enter `az --version`. For more information, see the [documentation](/cli/azure/deployment/group).
 
 ```azurecli-interactive
 read -p "Enter a name for your new resource group:" resourceGroupName &&
@@ -87,20 +89,20 @@ read
 ---
 
 > [!TIP]
-> If your subscription doesn't allow you to create an Azure AI services resource, you may need to enable the privilege of that [Azure resource provider](../azure-resource-manager/management/resource-providers-and-types.md#register-resource-provider) using the [Azure portal](../azure-resource-manager/management/resource-providers-and-types.md#azure-portal), [PowerShell command](../azure-resource-manager/management/resource-providers-and-types.md#azure-powershell) or an [Azure CLI command](../azure-resource-manager/management/resource-providers-and-types.md#azure-cli). If you are not the subscription owner, ask the *Subscription Owner* or someone with a role of *admin* to complete the registration for you or ask for the **/register/action** privileges to be granted to your account.
+> If your subscription doesn't allow you to create an Azure AI services resource, you might need to enable the privilege of that [Azure resource provider](../azure-resource-manager/management/resource-providers-and-types.md#register-resource-provider) by using the [Azure portal](../azure-resource-manager/management/resource-providers-and-types.md#azure-portal), a [PowerShell command](../azure-resource-manager/management/resource-providers-and-types.md#azure-powershell) or an [Azure CLI command](../azure-resource-manager/management/resource-providers-and-types.md#azure-cli). If you're not the subscription owner, ask the subscription owner or someone with an admin role to complete the registration for you. Or ask for the */register/action* privileges to be granted to your account.
 
 ## Review deployed resources
 
 # [Portal](#tab/portal)
 
-When your deployment finishes, you will be able to select the **Go to resource** button to see your new resource. You can also find the resource group by:
+When your deployment finishes, you can select the **Go to resource** button to see your new resource. You can also find the resource group by:
 
-1. Selecting **Resource groups** from the left navigation menu.
+1. Selecting **Resource groups** from the left pane.
 2. Selecting the resource group name.
 
 # [Azure CLI](#tab/CLI)
 
-Using the Azure CLI, run the following script, and enter the name of the resource group you created earlier.
+Run the following script. Include the name of the resource group that you created earlier.
 
 ```azurecli-interactive
 echo "Enter the resource group where the Azure AI services resource exists:" &&
@@ -110,20 +112,19 @@ az cognitiveservices account list -g $resourceGroupName
 
 ---
 
-
 ## Clean up resources
 
-If you want to clean up and remove an Azure AI services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources contained in the group.
+If you want to clean up and remove an Azure AI services subscription, you can delete the resource or the resource group. Deleting the resource group also deletes any other resources that the group contains.
 
 # [Azure portal](#tab/portal)
 
-1. In the Azure portal, expand the menu on the left side to open the menu of services, and choose **Resource Groups** to display the list of your resource groups.
-2. Locate the resource group containing the resource to be deleted
-3. Right-click on the resource group listing. Select **Delete resource group**, and confirm.
+1. On the left pane, select **Resource groups** to display the list of your resource groups.
+2. Locate the resource group that contains the resource to be deleted.
+3. Right-click the resource group, select **Delete resource group**, and then confirm.
 
 # [Azure CLI](#tab/CLI)
 
-Using the Azure CLI, run the following script, and enter the name of the resource group you created earlier.
+Run the following script. Include the name of the resource group that you created earlier.
 
 ```azurecli-interactive
 echo "Enter the resource group name, for deletion:" &&
@@ -133,10 +134,10 @@ az group delete --name $resourceGroupName
 
 ---
 
-## See also
+## Related content
 
-* See [Authenticate requests to Azure AI services](authentication.md) on how to securely work with Azure AI services.
-* See [What are Azure AI services?](./what-are-ai-services.md) for a list of Azure AI services.
-* See [Natural language support](language-support.md) to see the list of natural languages that Azure AI services supports.
-* See [Use Azure AI services as containers](cognitive-services-container-support.md) to understand how to use Azure AI services on-prem.
-* See [Plan and manage costs for Azure AI services](../ai-studio/how-to/costs-plan-manage.md) to estimate cost of using Azure AI services.
+* For more information on how to securely work with Azure AI services, see [Authenticate requests to Azure AI services](authentication.md).
+* For a list of Azure AI services, see [What are Azure AI services?](./what-are-ai-services.md).
+* For a list of natural languages that Azure AI services supports, see [Natural language support in Azure AI services](language-support.md).
+* To understand how to use Azure AI services on-premises, see [What are Azure AI containers?](cognitive-services-container-support.md).
+* To estimate the cost of using Azure AI services, see [Plan and manage costs for Azure AI Studio](../ai-studio/how-to/costs-plan-manage.md).
diff --git a/articles/ai-services/includes/quickstarts/sku-pricing.md b/articles/ai-services/includes/quickstarts/sku-pricing.md
@@ -1,5 +1,5 @@
 ---
-title: "Azure AI services SKUs and pricing"
+title: "Azure AI services products and pricing"
 #services: cognitive-services
 author: PatrickFarley
 manager: nitinme
@@ -9,20 +9,19 @@ ms.date: 10/28/2021
 ms.author: pafarley
 ---
 
-See the list of SKUs and pricing information below. 
+The following tables provide information about products and pricing for Azure AI services.
 
 #### Multi-service
 
 | Service     | Kind    |
 |-------------|------------|
 | Multiple services. For more information, see the [pricing](https://azure.microsoft.com/pricing/details/cognitive-services/) page.            | `CognitiveServices`     |
 
-
 #### Vision
 
 | Service    | Kind    |
 |------------|---------|
-| Azure AI Vision            | `ComputerVision`          |
+| Vision            | `ComputerVision`          |
 | Custom Vision - Prediction | `CustomVision.Prediction` |
 | Custom Vision - Training   | `CustomVision.Training`   |
 | Face                       | `Face`                    |
@@ -32,15 +31,15 @@ See the list of SKUs and pricing information below.
 
 | Service            | Kind                 |
 |--------------------|----------------------|
-| Speech Services    | `SpeechServices`     |
+| Speech    | `SpeechServices`     |
 
 #### Language
 
 | Service            | Kind                |
 |--------------------|---------------------|
-| LUIS               | `LUIS`              |
+| Language Understanding (LUIS)               | `LUIS`              |
 | QnA Maker          | `QnAMaker`          |
-| Language service   | `TextAnalytics`     |
+| Language   | `TextAnalytics`     |
 | Text Translation   | `TextTranslation`   |
 
 #### Decision
@@ -59,10 +58,11 @@ See the list of SKUs and pricing information below.
 
 #### Pricing tiers and billing
 
-Pricing tiers (and the amount you get billed) are based on the number of transactions you send using your authentication information. Each pricing tier specifies the:
-* maximum number of allowed transactions per second (TPS).
-* service features enabled within the pricing tier.
-* cost for a predefined number of transactions. Going above this number will cause an extra charge as specified in the [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/custom-vision-service/) for your service.
+Pricing tiers (and the amount you're billed) are based on the number of transactions that you send by using your authentication information. Each pricing tier specifies the:
+
+* Maximum number of allowed transactions per second (TPS).
+* Service features enabled within the pricing tier.
+* Cost for a predefined number of transactions. Going above this number will cause an extra charge, as specified in the [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/custom-vision-service/) for your service.
 
 > [!NOTE]
-> Many of the Azure AI services have a free tier you can use to try the service. To use the free tier, use `F0` as the SKU for your resource.
+> Many of the Azure AI services have a free tier that you can use to try the service. To use the free tier, use `F0` as the pricing tier for your resource.
diff --git a/articles/ai-services/includes/quickstarts/terms-azure-portal.md b/articles/ai-services/includes/quickstarts/terms-azure-portal.md
@@ -9,4 +9,4 @@ ms.date: 10/28/2021
 ms.author: pafarley
 ---
 
-You must create your first Face, Language service, or Azure AI Vision resources from the Azure portal to review and acknowledge the terms and conditions. You can do so here: [Face](https://portal.azure.com/#create/Microsoft.CognitiveServicesFace), [Language service](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextAnalytics), [Azure AI Vision](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision). After that, you can create subsequent resources using any deployment tool (SDK, CLI, or ARM template, etc) under the same Azure subscription.
+You must create your first [Azure AI Face](https://portal.azure.com/#create/Microsoft.CognitiveServicesFace), [Azure AI Language](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextAnalytics), or [Azure AI Vision](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision) resources from the Azure portal so that you can review and acknowledge the terms and conditions. After that, you can create resources by using any deployment tool (for example, SDK, Azure CLI, or ARM template) under the same Azure subscription.
diff --git a/includes/resource-manager-quickstart-introduction.md b/includes/resource-manager-quickstart-introduction.md
@@ -6,4 +6,4 @@ ms.date: 02/26/2020
 ms.author: jgao
 ---
 
-An [Azure Resource Manager template](../articles/azure-resource-manager/templates/overview.md) is a JavaScript Object Notation (JSON) file that defines infrastructure and configuration for your project. The template uses declarative syntax. You describe your intended deployment without writing the sequence of programming commands to create the deployment.
+An [Azure Resource Manager template](../articles/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. You describe your intended deployment without writing the sequence of programming commands to create the deployment.
