Merge pull request #209554 from PatrickFarley/cogserv-qss

[cog svcs] Cogserv qss

Author: 19BMG00

articles/cognitive-services/TOC.yml

@@ -23,14 +23,14 @@
   - name: Create a new resource using an ARM template
     displayName: Resource Manager
     href: create-account-resource-manager-template.md  
-  - name: Create a new resource with commitment tier pricing 
-    href: commitment-tier.md  
 - name: How-To
   items:
   - name: Plan and manage costs 
     href: plan-manage-costs.md
   - name: Increase rate limit
     href: autoscale.md
+  - name: Use commitment tier pricing 
+    href: commitment-tier.md
   - name: Diagnostic logging
     href: diagnostic-logging.md
   - name: Manage resources

articles/cognitive-services/big-data/cognitive-services-for-big-data.md

@@ -24,7 +24,7 @@ Cognitive Services for big data can use resources from any [supported region](ht
 
 ## Supported services
 
-[Cognitive Services](../index.yml), accessed through APIs and SDKs, help developers build intelligent applications without having AI or data science skills. With Cognitive Services you can make your applications see, hear, speak, understand, and reason. To use Cognitive Services, your application must send data to the service over the network. Once received, the service sends an intelligent response in return. The following Cognitive Services resources are available for big data workloads:
+[Cognitive Services](../index.yml), accessed through APIs and SDKs, help developers build intelligent applications without having AI or data science skills. With Cognitive Services you can make your applications see, hear, speak, and understand. To use Cognitive Services, your application must send data to the service over the network. Once received, the service sends an intelligent response in return. The following Cognitive Services resources are available for big data workloads:
 
 ### Vision
 

articles/cognitive-services/cognitive-services-apis-create-account-cli.md

@@ -16,11 +16,11 @@ ms.devlang: azurecli
 
 # Quickstart: Create a Cognitive Services resource using the Azure CLI
 
-Use this quickstart to create a Cognitive Services resource using [Azure Command-Line Interface (CLI)](/cli/azure/install-azure-cli) commands. After creating the resource, use the keys and endpoint generated for you to authenticate your applications.
+Use this quickstart to create a Cognitive Services resource using [Azure Command-Line Interface (CLI)](/cli/azure/install-azure-cli) commands. After you create the resource, use the keys and endpoint generated for you to authenticate your applications.
 
-Azure Cognitive Services is a cloud-based service with REST APIs, and client library SDKs available to help developers build cognitive intelligence into applications without having direct artificial intelligence (AI) or data science skills or knowledge. Azure Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, understand, and even begin to reason.
+Azure Cognitive 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 Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, and analyze.
 
-## Types of Cognitive Services resource
+## Types of Cognitive Services resources
 
 [!INCLUDE [cognitive-services-subscription-types](../../includes/cognitive-services-subscription-types.md)]
 
@@ -43,37 +43,31 @@ You can also use the green **Try It** button to run these commands in your brows
 
 ## Create a new Azure Cognitive Services resource group
 
-Before creating a Cognitive Services resource, you must have an Azure resource group to contain the resource. When you create a new resource, you can either create a new resource group, or use an existing one. This article shows how to create a new resource group.
+Before you create a Cognitive Services resource, you must have an Azure resource group to contain the resource. When you create a new resource, you can either create a new resource group, or use an existing one. This article shows how to create a new resource group.
 
 ### Choose your resource group location
 
 To create a resource, you'll need one of the Azure locations available for your subscription. You can retrieve a list of available locations with the [az account list-locations](/cli/azure/account#az-account-list-locations) command. Most Cognitive Services can be accessed from several locations. Choose the one closest to you, or see which locations are available for the service.
 
 > [!IMPORTANT]
-> * Remember your Azure location, as you will need it when calling the Azure Cognitive Services.
+> * Remember your Azure location, as you will need it when calling the Azure Cognitive Services resources.
 > * The availability of some Cognitive Services can vary by region. For more information, see [Azure products by region](https://azure.microsoft.com/global-infrastructure/services/?products=cognitive-services).
 
 ```azurecli-interactive
-az account list-locations \
-    --query "[].{Region:name}" \
-    --out table
+az account list-locations --query "[].{Region:name}" --out table
 ```
 
-After you have your Azure location, create a new resource group in the Azure CLI using the [az group create](/cli/azure/group#az-group-create) command.
-
-In the example below, replace the Azure location `westus2` with one of the Azure locations available for your subscription.
+After you have your Azure location, create a new resource group in the Azure CLI using the [az group create](/cli/azure/group#az-group-create) command. In the example below, replace the Azure location `westus2` with one of the Azure locations available for your subscription.
 
 ```azurecli-interactive
-az group create \
-    --name cognitive-services-resource-group \
-    --location westus2
+az group create --name cognitive-services-resource-group --location westus2
 ```
 
 ## Create a Cognitive Services resource
 
-### Choose a cognitive service and pricing tier
+### Choose a service and pricing tier
 
-When creating a new resource, you'll need to know the "kind" of service you want to use, along with the [pricing tier](https://azure.microsoft.com/pricing/details/cognitive-services/) (or sku) you want. You'll use this and other information as parameters when creating the resource.
+When you create a new resource, you'll need to know the kind of service you want to use, along with the [pricing tier](https://azure.microsoft.com/pricing/details/cognitive-services/) (or SKU) you want. You'll use this and other information as parameters when you create the resource.
 
 [!INCLUDE [cognitive-services-subscription-types](../../includes/cognitive-services-subscription-types.md)]
 
@@ -88,18 +82,12 @@ az cognitiveservices account list-kinds
 
 ### Add a new resource to your resource group
 
-To create and subscribe to a new Cognitive Services resource, use the [az cognitiveservices account create](/cli/azure/cognitiveservices/account#az-cognitiveservices-account-create) command. This command adds a new billable resource to the resource group created earlier. When creating your new resource, you'll need to know the "kind" of service you want to use, along with its pricing tier (or sku) and an Azure location:
+To create and subscribe to a new Cognitive Services resource, use the [az cognitiveservices account create](/cli/azure/cognitiveservices/account#az-cognitiveservices-account-create) command. This command adds a new billable resource to the resource group you created earlier. When you create your new resource, you'll need to know the "kind" of service you want to use, along with its pricing tier (or SKU) and an Azure location:
 
 You can create an F0 (free) resource for Anomaly Detector, named `anomaly-detector-resource` with the command below.
 
 ```azurecli-interactive
-az cognitiveservices account create \
-    --name anomaly-detector-resource \
-    --resource-group cognitive-services-resource-group \
-    --kind AnomalyDetector \
-    --sku F0 \
-    --location westus2 \
-    --yes
+az cognitiveservices account create --name anomaly-detector-resource --resource-group cognitive-services-resource-group  --kind AnomalyDetector --sku F0 --location westus2 --yes
 ```
 
 [!INCLUDE [Register Azure resource for subscription](./includes/register-resource-subscription.md)]
@@ -115,9 +103,7 @@ az login
 Use the [az cognitiveservices account keys list](/cli/azure/cognitiveservices/account/keys#az-cognitiveservices-account-keys-list) command to get the keys for your Cognitive Service resource.
 
 ```azurecli-interactive
-    az cognitiveservices account keys list \
-    --name anomaly-detector-resource \
-    --resource-group cognitive-services-resource-group
+    az cognitiveservices account keys list  --name anomaly-detector-resource --resource-group cognitive-services-resource-group
 ```
 
 [!INCLUDE [cognitive-services-environment-variables](../../includes/cognitive-services-environment-variables.md)]
@@ -134,10 +120,7 @@ Pricing tiers (and the amount you get billed) are based on the number of transac
 Use the [az cognitiveservices account list-usage](/cli/azure/cognitiveservices/account#az-cognitiveservices-account-list-usage) command to get the usage for your Cognitive Service resource.
 
 ```azurecli-interactive
-az cognitiveservices account list-usage \
-    --name anomaly-detector-resource \
-    --resource-group cognitive-services-resource-group \
-    --subscription subscription-name
+az cognitiveservices account list-usage --name anomaly-detector-resource --resource-group cognitive-services-resource-group --subscription subscription-name
 ```
 
 ## Clean up resources

articles/cognitive-services/cognitive-services-apis-create-account-client-library.md

@@ -18,7 +18,7 @@ ms.custom: mode-api
 
 Use this quickstart to create and manage Azure Cognitive Services resources using the Azure Management client library.
 
-Azure Cognitive Services is a family of cloud-base services with REST APIs and client libraries available to help developers build cognitive intelligence into their applications. Developers do not need direct artificial intelligence (AI) or data science skills or knowledge to achieve success. Azure Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, understand, and even begin to reason.
+Azure Cognitive 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 Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, and analyze.
 
 Individual AI services are represented by Azure [resources](../azure-resource-manager/management/manage-resources-portal.md) that you create under your Azure subscription. After you create a resource, you can use the keys and endpoint generated to authenticate your applications.
 

articles/cognitive-services/cognitive-services-apis-create-account.md

@@ -16,9 +16,9 @@ ms.author: aahi
 
 Use this quickstart to create a Cognitive Services resource. After you create a Cognitive Service resource in the Azure portal, you'll get an endpoint and a key for authenticating your applications.
 
-Azure Cognitive Services are cloud-based services with REST APIs, and client library SDKs available to help developers build cognitive intelligence into applications without having direct artificial intelligence (AI) or data science skills or knowledge. Azure Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, understand, and even begin to reason.
+Azure Cognitive 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 Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, and analyze.
 
-## Types of Cognitive Services resource
+## Types of Cognitive Services resources
 
 [!INCLUDE [cognitive-services-subscription-types](../../includes/cognitive-services-subscription-types.md)]
 

articles/cognitive-services/commitment-tier.md

@@ -5,14 +5,13 @@ author: aahill
 ms.author: aahi
 ms.custom: subject-cost-optimization, mode-other
 ms.service: cognitive-services
-ms.topic: quickstart
-ms.date: 11/04/2021
+ms.topic: conceptual
+ms.date: 09/01/2022
 ---
 
-# Quickstart: Purchase commitment tier pricing
-
-Cognitive Services offers commitment tier pricing,  each offering a discounted rate compared to the pay-as-you-go pricing model. With commitment tier pricing, you can commit to using the following Cognitive Services features for a fixed fee, enabling you to have a predictable total cost based on the needs of your workload:
+# Purchase commitment tier pricing
 
+Cognitive Services offers commitment tier pricing, each offering a discounted rate compared to the pay-as-you-go pricing model. With commitment tier pricing, you can commit to using the following Cognitive Services features for a fixed fee, enabling you to have a predictable total cost based on the needs of your workload:
 * Speech to Text (Standard)
 * Text to Speech (Neural)
 * Text Translation (Standard)
@@ -21,7 +20,7 @@ Cognitive Services offers commitment tier pricing,  each offering a discounted r
     * Sentiment Analysis
     * Key Phrase Extraction
     * Language Detection
-* Computer Vision - Read
+* Computer Vision - OCR
 
 Commitment tier pricing is also available for the following Applied AI service:
 * Form Recognizer – Custom/Invoice
@@ -76,7 +75,6 @@ Once you are approved, you can use either create a new resource to use a commitm
 
     * **Auto-renewal** - Choose how you want to renew, change, or cancel the current commitment plan starting with the next billing cycle. If you decide to auto-renew, the **Auto-renewal date** is the date (in your local timezone) when you will be charged for the next billing cycle. This date coincides with the start of the calendar month.
 
-
     > [!CAUTION]
     > Once you click **Purchase** you will be charged for the tier you select. Once purchased, the commitment plan is non-refundable.
     > 

articles/cognitive-services/create-account-bicep.md

@@ -15,7 +15,7 @@ ms.custom: subject-armqs, mode-arm
 
 Follow this quickstart to create Cognitive Services resource using Bicep.
 
-Azure Cognitive Services are cloud-base services with REST APIs, and client library SDKs available to help developers build cognitive intelligence into applications without having direct artificial intelligence (AI) or data science skills or knowledge. Azure Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, understand, and even begin to reason.
+Azure Cognitive 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 Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, and analyze.
 
 [!INCLUDE [About Bicep](../../includes/resource-manager-quickstart-bicep-introduction.md)]
 
@@ -37,8 +37,9 @@ The Bicep file used in this quickstart is from [Azure Quickstart Templates](http
 
 :::code language="bicep" source="~/quickstart-templates/quickstarts/microsoft.cognitiveservices/cognitive-services-universalkey/main.bicep":::
 
-One Azure resource is defined in the Bicep file:
-* [Microsoft.CognitiveServices/accounts](/azure/templates/microsoft.cognitiveservices/accounts): creates a Cognitive Services resource.
+One Azure resource is defined in the Bicep file: [Microsoft.CognitiveServices/accounts](/azure/templates/microsoft.cognitiveservices/accounts) specifies that it is a Cognitive Services resource. The `kind` field in the Bicep file defines the type of resource.
+
+[!INCLUDE [SKUs and pricing](./includes/quickstarts/sku-pricing.md)]
 
 ## Deploy the Bicep file
 

articles/cognitive-services/create-account-resource-manager-template.md

@@ -7,7 +7,7 @@ author: aahill
 manager: nitinme
 ms.service: cognitive-services
 ms.topic: quickstart
-ms.date: 06/04/2021
+ms.date: 09/01/2022
 ms.author: aahi
 ms.custom: subject-armqs, mode-arm
 ---
@@ -16,7 +16,7 @@ ms.custom: subject-armqs, mode-arm
 
 This quickstart describes how to use an Azure Resource Manager template (ARM template) to create Cognitive Services.
 
-Azure Cognitive Services are cloud-base services with REST APIs, and client library SDKs available to help developers build cognitive intelligence into applications without having direct artificial intelligence (AI) or data science skills or knowledge. Azure Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, understand, and even begin to reason.
+Azure Cognitive 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 Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, and analyze.
 
 Create a resource using an Azure Resource Manager template (ARM template). This multi-service resource lets you:
 
@@ -26,10 +26,6 @@ Create a resource using an Azure Resource Manager template (ARM template). This
 
 [!INCLUDE [About Azure Resource Manager](../../includes/resource-manager-quickstart-introduction.md)]
 
-If your environment meets the prerequisites and you're familiar with using ARM templates, select the **Deploy to Azure** button. The template will open in the Azure portal.
-
-[![Deploy your cognitive service to Azure](../media/template-deployments/deploy-to-azure.svg "Deploy your cognitive service to Azure")](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.cognitiveservices%2Fcognitive-services-universalkey%2Fazuredeploy.json)
-
 ## Prerequisites
 
 * If you don't have an Azure subscription, [create one for free](https://azure.microsoft.com/free/cognitive-services).
@@ -40,8 +36,9 @@ The template used in this quickstart is from [Azure Quickstart Templates](https:
 
 :::code language="json" source="~/quickstart-templates/quickstarts/microsoft.cognitiveservices/cognitive-services-universalkey/azuredeploy.json":::
 
-One Azure resource is defined in the template:
-* [Microsoft.CognitiveServices/accounts](/azure/templates/microsoft.cognitiveservices/accounts): creates a Cognitive Services resource.
+One Azure resource is defined in the Bicep file: [Microsoft.CognitiveServices/accounts](/azure/templates/microsoft.cognitiveservices/accounts) specifies that it is a Cognitive Services resource. The `kind` field in the Bicep file defines the type of resource.
+
+[!INCLUDE [SKUs and pricing](./includes/quickstarts/sku-pricing.md)]
 
 ## Deploy the template