Merge pull request #190534 from eric-urban/eur/create-cog-resources

 prototype create resource pillar tabs

Author: ttorble

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

@@ -7,8 +7,8 @@ author: aahill
 manager: nitinme
 keywords: cognitive services, cognitive intelligence, cognitive solutions, ai services
 ms.service: cognitive-services
-ms.topic: quickstart
-ms.date: 10/28/2021
+ms.topic: conceptual
+ms.date: 03/03/2022
 ms.author: aahi
 ---
 
@@ -28,79 +28,92 @@ Azure Cognitive Services are cloud-based services with REST APIs, and client lib
 
 ## Create a new Azure Cognitive Services resource
 
-1. Create a resource.
+### [Multi-service](#tab/multiservice)
 
-### [Multi-service resource](#tab/multiservice)
+The multi-service resource is named **Cognitive Services** in the portal. The multi-service resource enables access to the following Cognitive Services:
 
-The multi-service resource is named **Cognitive Services** in the portal. [Create a Cognitive Services resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne).
+* **Decision** - Content Moderator
+* **Language** - Language, Translator
+* **Speech** - Speech
+* **Vision** - Computer Vision, Custom Vision, Face
 
-At this time, the multi-service resource enables access to the following Cognitive Services:
+1. You can select this link to create an Azure Cognitive multi-service resource: [Create a Cognitive Services resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne).
 
-* **Vision** - Computer Vision, Custom Vision, Face
-* **Speech** - Speech
-* **Language** - Language, Translator
-* **Decision** - Content Moderator
+1. On the **Create** page, provide the following information:
 
-### [Single-service resource](#tab/singleservice)
+    [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
+    
+    :::image type="content" source="media/cognitive-services-apis-create-account/resource_create_screen-multi.png" alt-text="Multi-service resource creation screen":::
 
-Use the below links to create a resource for the available Cognitive Services:
+1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
 
-| Vision                      | Speech                  | Language                          | Decision             |
-|-----------------------------|-------------------------|-----------------------------------|----------------------|
-| [Computer vision](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision)         | [Speech Services](https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices)     | [Immersive reader](https://portal.azure.com/#create/Microsoft.CognitiveServicesImmersiveReader)              | [Anomaly Detector](https://portal.azure.com/#create/Microsoft.CognitiveServicesAnomalyDetector) | 
-| [Custom vision service](https://portal.azure.com/#create/Microsoft.CognitiveServicesCustomVision) |  | [Language Understanding (LUIS)](https://portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne) | [Content Moderator](https://portal.azure.com/#create/Microsoft.CognitiveServicesContentModerator) | 
-| [Face](https://portal.azure.com/#create/Microsoft.CognitiveServicesFace)                    |                         | [QnA Maker](https://portal.azure.com/#create/Microsoft.CognitiveServicesQnAMaker)                     | [Personalizer](https://portal.azure.com/#create/Microsoft.CognitiveServicesPersonalizer)     |
-|        |                         | [Language service](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextAnalytics)                |  [Metrics Advisor](https://go.microsoft.com/fwlink/?linkid=2142156)                    |
-| | | [Translator](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) | |
+### [Decision](#tab/decision)
 
----
+1. You can select one of these links to create a Decision resource: 
+    - [Anomaly Detector](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesAnomalyDetector)
+    - [Content Moderator](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesContentModerator)
+    - [Metrics Advisor](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesMetricsAdvisor)
+    - [Personalizer](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesPersonalizer)
+
+1. On the **Create** page, provide the following information:
 
-2. On the **Create** page, provide the following information:
-<!-- markdownlint-disable MD024 -->
+    [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
 
-### [Multi-service resource](#tab/multiservice)
+1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
 
-|Project details| Description   |
-|--|--|
-| **Subscription** | Select one of your available Azure subscriptions. |
-| **Resource group** | The Azure resource group that will contain your Cognitive Services resource. You can create a new group or add it to a pre-existing group. |
-| **Region** | The location of your cognitive service instance. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
-| **Name** | A descriptive name for your cognitive services resource. For example, *MyCognitiveServicesResource*. |
-| **Pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/).
+### [Language](#tab/language)
 
-<!--![Multi-service resource creation screen](media/cognitive-services-apis-create-account/resource_create_screen-multi.png)-->
-:::image type="content" source="media/cognitive-services-apis-create-account/resource_create_screen-multi.png" alt-text="Multi-service resource creation screen":::
+1. You can select one of these links to create a Language resource: 
+    - [Immersive reader](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesImmersiveReader)
+    - [Language Understanding (LUIS)](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne)
+    - [Language service](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesTextAnalytics)
+    - [Translator](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation)
+    - [QnA Maker](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesQnAMaker)
 
-Read and accept the conditions (as applicable for you) and then select **Review + create**.
+1. On the **Create** page, provide the following information:
 
-### [Single-service resource](#tab/singleservice)
+    [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
 
-|Project details| Description   |
-|--|--|
-| **Subscription** | Select one of your available Azure subscriptions. |
-| **Resource group** | The Azure resource group that will contain your Cognitive Services resource. You can create a new group or add it to a pre-existing group. |
-| **Region** | The location of your cognitive service instance. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
-| **Name** | A descriptive name for your cognitive services resource. For example, *MyCognitiveServicesResource*. |
-| **Pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/).
+1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
 
-<!--![Single-service resource creation screen](media/cognitive-services-apis-create-account/resource_create_screen.png)-->
-:::image type="content" source="media/cognitive-services-apis-create-account/resource_create_screen.png" alt-text="Single-service resource creation screen":::
+### [Speech](#tab/speech)
 
-Select **Next: Virtual Network** and choose the type of network access you want to allow for your resource, and then select **Review + create**.
+1. You can select this link to create a Speech resource: [Speech Services](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices)
+
+1. On the **Create** page, provide the following information:
+
+    [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
+
+1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
+
+### [Vision](#tab/vision)
+
+1. You can select one of these links to create a Vision resource: 
+    - [Computer vision](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision)
+    - [Custom vision service](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesCustomVision)
+    - [Face](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesFace) 
+
+1. On the **Create** page, provide the following information:
+
+    [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
+
+1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
 
 ---
 
 [!INCLUDE [Register Azure resource for subscription](./includes/register-resource-subscription.md)]
 
 ## Get the keys for your resource
 
-1. After your resource is successfully deployed, click on **Go to resource** under **Next Steps**.
+1. After your resource is successfully deployed, select **Next Steps** > **Go to resource**.
+
+    :::image type="content" source="media/cognitive-services-apis-create-account/cognitive-services-resource-deployed.png" alt-text="Get resource keys screen":::
 
-    ![Search for Cognitive Services](media/cognitive-services-apis-create-account/resource-next-steps.png)
+1. From the quickstart pane that opens, you can access the resource endpoint and manage keys.
 
-2. From the quickstart pane that opens, you can access your key and endpoint.
+1. If you missed the previous steps or need to find your resource later, go to the [Azure services](https://ms.portal.azure.com/#home) home page. From here you can view recent resources, select **My resources**, or use the search box to find your resource by name.
 
-    ![Get key and endpoint](media/cognitive-services-apis-create-account/get-cog-serv-keys.png)
+    :::image type="content" source="media/cognitive-services-apis-create-account/home-my-resources.png" alt-text="Find resource keys from home screen":::
 
 [!INCLUDE [cognitive-services-environment-variables](../../includes/cognitive-services-environment-variables.md)]
 
@@ -109,8 +122,8 @@ Select **Next: Virtual Network** and choose the type of network access you want
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources contained in the group.
 
 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. Locate the resource group containing the resource to be deleted
+1. Right-click on the resource group listing. Select **Delete resource group**, and confirm.
 
 If you need to recover a deleted resource, see [Recover deleted Cognitive Services resources](manage-resources.md).
 

articles/cognitive-services/includes/quickstarts/cognitive-resource-project-details.md

@@ -0,0 +1,19 @@
+---
+title: "Cognitive Service resource project details"
+services: cognitive-services
+author: eric-urban
+manager: nitinme
+ms.service: cognitive-services
+ms.topic: include
+ms.date: 01/22/2022
+ms.author: eur
+---
+
+
+|Project details| Description   |
+|--|--|
+| **Subscription** | Select one of your available Azure subscriptions. |
+| **Resource group** | The Azure resource group that will contain your Cognitive Services resource. You can create a new group or add it to a pre-existing group. |
+| **Region** | The location of your cognitive service instance. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
+| **Name** | A descriptive name for your cognitive services resource. For example, *MyCognitiveServicesResource*. |
+| **Pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/).