Merge pull request #110038 from diberry/diberry/0401-luis-portal-create-blade

[Cogsvcs] LUIS portal create blade

Author: megvanhuygen

articles/cognitive-services/LUIS/deploy-luis-on-container-instances.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 01/06/2020
+ms.date: 04/06/2020
 ms.author: dapine
 ---
 
@@ -20,6 +20,8 @@ Learn how to deploy the Cognitive Services [LUIS](luis-container-howto.md) conta
 
 [!INCLUDE [Create LUIS resource](includes/create-luis-resource.md)]
 
+[!INCLUDE [Gathering required parameters](../containers/includes/container-gathering-required-parameters.md)]
+
 ## Create an Azure file share
 
 The LUIS container requires a `.gz` model file that is pulled in at runtime. The container must be able to access this model file via a volume mount from the Container instance. For information on creating an Azure file share, see [create a file share](../../storage/files/storage-how-to-create-file-share.md). Take note of the Azure Storage account name, key, and file share name as you'll need them later.

articles/cognitive-services/LUIS/get-started-portal-deploy-app.md

@@ -1,15 +1,8 @@
 ---
 title: "Quickstart: Deploy an app with the LUIS portal"
-titleSuffix: Azure Cognitive Services
 description: This quickstart shows how to deploy an app by creating a prediction endpoint resource, assigning the resource, training, and publishing the app.
-services: cognitive-services
-author: diberry
-manager: nitinme
-ms.service: cognitive-services
-ms.subservice: language-understanding
 ms.topic: quickstart
-ms.date: 01/27/2020
-ms.author: diberry
+ms.date: 04/06/2020
 #Customer intent: As a new user, I want to deploy a LUIS app in the LUIS portal so I can understand the process of putting the model on the prediction endpoint.
 ---
 
@@ -25,35 +18,13 @@ In this quickstart, you learn to deploy an application. You create a prediction
 * Complete the [previous portal quickstart](get-started-portal-build-app.md) or [download and import the app](https://github.com/Azure-Samples/cognitive-services-language-understanding/blob/master/documentation-samples/quickstarts/in-portal/build-portal-app.json).
 * If you have apps that pre-date Azure resource authentication, [migrate to an Azure resource](luis-migration-authoring.md). Some portal pages look different when email authentication is in effect.
 
-## Create the endpoint resource
+<a name="create-the-endpoint-resource"></a>
 
-You create the prediction endpoint resource in the Azure portal. This resource should only be used for endpoint prediction queries. Do not use this resource for authoring changes to the app.
-
-1. Sign in and create a resource in the [Azure portal](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne).
-
-1. Configure the subscription with the following settings:
-
-   |Setting|Value|Purpose|
-   |--|--|--|
-   |Name|`my-luis-resource`|The name of the Azure resource. You need this name when you assign the resource to the app in the LUIS portal.|
-   |Subscription|Your subscription|Select one of the subscriptions associated with your account.|
-   |Resource group|`my-resource-group`|Create a new resource group for all your cognitive service resources. When you're done with the resources, you can delete the resource group to clean up your subscription. |
-   |Authoring location|**West US**|The Azure region for authoring.|
-   |Authoring pricing tier|**F0**|The default pricing tier for authoring.|
-   |Runtime location|**West US**|The Azure region for prediction endpoint queries.|
-   |Runtime pricing tier|**S0**|This pricing tier provides for high-traffic websites.|
-   | | | |
-
-
-   ![Azure API choice](./media/luis-how-to-azure-subscription/create-resource-in-azure.png)
-
-1. Select **Create** to create the Azure resource.
-
-   In the next section, you learn how to connect this new resource to a LUIS app in the LUIS portal.
+[!INCLUDE [Create LUIS resource](includes/create-luis-resource.md)]
 
 ## Assign the resource key to the LUIS app in the LUIS portal
 
-Every time you create a new resource for LUIS, you need to assign the resource to the LUIS app. After it's assigned, you won't need to do this step again unless you create a new resource. You might create a new resource to expand the regions of your app or to support a higher number of prediction queries.
+Every time you create a new authoring or query prediction resource for LUIS, you need to assign the resource to the LUIS app. After it's assigned, you won't need to do this step again unless you create a new resource. You might create a new resource to expand the regions of your app or to support a higher number of prediction queries.
 
 1. Sign in to the [preview LUIS portal](https://preview.luis.ai) and choose the **myEnglishApp** app from the apps list.
 

articles/cognitive-services/LUIS/includes/create-luis-resource.md

@@ -5,26 +5,34 @@ services: cognitive-services
 author: IEvangelist
 manager: nitinme
 ms.service: cognitive-services
-ms.topic: include 
-ms.date: 10/23/2019
+ms.topic: include
+ms.date: 04/06/2020
 ms.author: dapine
 ---
 
-## Create a LUIS resource
+<a name="create-luis-resources"></a>
+
+## Create LUIS resources in Azure portal
+
+1. Use [this link](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne) to begin creating LUIS resources in the Azure portal.
 
-1. Sign into the [Azure portal](https://portal.azure.com)
-1. Click [Create **Language Understanding**](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne)
 1. Enter all required settings:
 
-    |Setting|Value|
+    |Name|Purpose|
     |--|--|
-    |Name|Desired name (2-64 characters)|
-    |Subscription|Select appropriate subscription|
-    |Location|Select any nearby and available location|
-    |Pricing Tier|`F0` - the minimal pricing tier|
-    |Resource Group|Select an available resource group|
+    |Subscription name| the subscription that will be billed for the resource.|
+    |Resource group| A custom resource group name you choose or create. Resource groups allow you to group Azure resources for access and management.|
+    |Name| A custom name you choose, used as your custom subdomain for your authoring and prediction endpoint queries.|
+    |Authoring location|The region associated with your model.|
+    |Authoring pricing tier|The pricing tier determines the maximum transaction per second and month.|
+    |Runtime location|The region associated with your published prediction endpoint runtime.|
+    |Runtime pricing tier|The pricing tier determines the maximum transaction per second and month.|
+
+    > [!div class="mx-imgBorder"]
+    > [![Create the language understanding resource](../media/luis-how-to-azure-subscription/create-resource-in-azure-small.png)](../media/luis-how-to-azure-subscription/create-resource-in-azure-small.png#lightbox)
 
-1. Click **Create** and wait for the resource to be created. After it is created, navigate to the resource page.
-1. Collect configured `endpoint` and an API key, see [gathering required parameters](#gathering-required-parameters).
+1. Click **Review + create** and wait for the resource to be created.
+1. After both resources are created, still in the Azure portal, select the new authoring resource, then **Quickstarts** to get the authoring **endpoint URL** and **key** for authoring programmatically.
 
-[!INCLUDE [Gathering required parameters](../../containers/includes/container-gathering-required-parameters.md)]
+> [!TIP]
+> To use the resources, in the LUIS portal, [assign the resources](../luis-how-to-azure-subscription.md#assign-an-authoring-resource-in-the-luis-portal-for-all-apps).