Merge pull request #245011 from dominicbetts/central-create-app

IoT Central: change recommended way to create an IoT Central app

Author: ttorble

articles/iot-central/core/howto-create-custom-rules.md

@@ -206,7 +206,7 @@ To send emails with SendGrid, you need to configure the bindings for your functi
 1. Select **+ Add output**.
 1. Select **SendGrid** as the binding type.
 1. For the **SendGrid API Key App Setting**, select **New**.
-1. Enter the *Name* and *Value* of your SendGrid API key. If you followed the instructions above, the name of your SendGrid API key is **AzureFunctionAccess**.
+1. Enter the *Name* and *Value* of your SendGrid API key. If you followed the previous instructions, the name of your SendGrid API key is **AzureFunctionAccess**.
 1. Add the following information:
 
     | Setting | Value |
@@ -317,7 +317,7 @@ This solution uses a Stream Analytics query to detect when a device stops sendin
 
 ## Configure export in IoT Central
 
-On the [Azure IoT Central application manager](https://aka.ms/iotcentral) website, navigate to the IoT Central application the script created. The name of the app is **In-store analytics - Condition Monitoring (custom rules scenario)**.
+On the [Azure IoT Central My apps](https://apps.azureiotcentral.com/myapps) page, locate the IoT Central application the script created. The name of the app is **In-store analytics - Condition Monitoring (custom rules scenario)**.
 
 To enable the data export to Event Hubs, navigate to the **Data Export** page and enable the **All telemetry** export.
 Wait until the export status is **Running** before you continue.

articles/iot-central/core/howto-create-iot-central-application.md

@@ -5,7 +5,7 @@ services: iot-central
 ms.service: iot-central
 author: dominicbetts
 ms.author: dobett
-ms.date: 10/28/2022
+ms.date: 07/14/2023
 ms.topic: how-to
 ---
 
@@ -42,7 +42,7 @@ The following table summarizes the differences between the three standard plans:
 
 ### Application name
 
-The _application name_ you choose appears in the title bar on every page in your IoT Central application. It also appears on your application's tile on the **My apps** page on the [Azure IoT Central](https://aka.ms/iotcentral) site.
+The _application name_ you choose appears in the title bar on every page in your IoT Central application.
 
 The _subdomain_ you choose uniquely identifies your application. The subdomain is part of the URL you use to access the application. The URL for an IoT Central application looks like `https://yoursubdomain.azureiotcentral.com`.
 
@@ -58,26 +58,41 @@ If you choose one of the standard plans, you need to provide billing information
 - The directory that contains the subscription you're using.
 - The location to host your application. IoT Central uses Azure regions as locations: Australia East, Canada Central, Central US, East US, East US 2, Japan East, North Europe, South Central US, Southeast Asia, UK South, West Europe, and West US.
 
-## Azure IoT Central site
+## Azure portal
 
-The easiest way to get started creating IoT Central applications is on the [Azure IoT Central](https://aka.ms/iotcentral) site.
+The easiest way to get started creating IoT Central applications is in the [Azure portal](https://portal.azure.com/#create/Microsoft.IoTCentral).
 
-The [Build](https://apps.azureiotcentral.com/build) lets you select the application template you want to use:
+[!INCLUDE [Warning About Access Required](../../../includes/iot-central-warning-contribitorrequireaccess.md)]
+
+Enter the following information:
+
+| Field | Description |
+| ----- | ----------- |
+| Subscription | The Azure subscription you want to use. |
+| Resource group | The resource group you want to use.  You can create a new resource group or use an existing one. |
+| Resource name | A valid Azure resource name. |
+| Application URL | The URL subdomain for your application. The URL for an IoT Central application looks like `https://yoursubdomain.azureiotcentral.com`. |
+| Template | The application template you want to use. For a blank application template, select **Custom application**.|
+| Region | The Azure region you want to use. |
+| Pricing plan | The pricing plan you want to use. |
 
-If you select **Create app**, you can provide the necessary information to create an application from the template:
+:::image type="content" source="media/howto-create-iot-central-application/create-app-portal.png" alt-text="Screenshot that shows the create application experience in the Azure portal.":::
 
-:::image type="content" source="media/howto-create-iot-central-application/create-application.png" alt-text="Screenshot showing create application page for IoT Central.":::
+Select **Review + create**, Then select **Create** to create the application.
 
-The **My apps** page lists all the IoT Central applications you have access to. The list includes applications you created and applications that you've been granted access to.
+When the app is ready, you can navigate to it from the Azure portal:
 
-> [!TIP]
-> All the applications you create using a standard pricing plan on the Azure IoT Central site use the **IOTC** resource group in your subscription. The approaches described in the following section let you choose a resource group to use.
+:::image type="content" source="media/howto-create-iot-central-application/view-app-portal.png" alt-text="Screenshot that shows the IoT Central application resource in the Azure portal. The application URL is highlighted.":::
+
+To list all the IoT Central apps you've created, navigate to [IoT Central Applications](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.IoTCentral%2FIoTApps).
+
+To list all the IoT Central applications you have access to, navigate to [IoT Central Applications](https://apps.azureiotcentral.com/myapps).
 
 ## Copy an application
 
 You can create a copy of any application, minus any device instances, device data history, and user data. The copy uses a standard pricing plan that you'll be billed for.
 
-Navigate to **Application > Management** and select **Copy**. In the dialog box, enter the details for the new application. Then select **Copy** to confirm that you want to continue. To learn more about the fields in the form, see [Create an application](howto-create-iot-central-application.md).
+Navigate to **Application > Management** and select **Copy**. In the dialog box, enter the details for the new application. Then select **Copy** to confirm that you want to continue. To learn more about the fields in the form, see [Options](#options).
 
 :::image type="content" source="media/howto-create-iot-central-application/app-copy.png" alt-text="Screenshot that shows the copy application settings page." lightbox="media/howto-create-iot-central-application/app-copy.png":::
 
@@ -121,9 +136,7 @@ To create an application template from an existing IoT Central application:
 
 ### Use an application template
 
-To use an application template to create a new IoT Central application, you need a previously created **Shareable Link**. Paste the **Shareable Link** into your browser's address bar. The **Create an application** page displays with your custom application template selected:
-
-:::image type="content" source="media/howto-create-iot-central-application/create-app.png" alt-text="Screenshot that shows create an application from a template.":::
+To use an application template to create a new IoT Central application, you need a previously created **Shareable Link**. Paste the **Shareable Link** into your browser's address bar. The **Create an application** page displays with your custom application template selected.
 
 Select your pricing plan and fill out the other fields on the form. Then select **Create** to create a new IoT Central application from the application template.
 
@@ -139,7 +152,6 @@ To update your application template, change the template name or description on
 
 You can also use the following approaches to create an IoT Central application:
 
-- [Create an IoT Central application from the Azure portal](howto-manage-iot-central-from-portal.md#create-iot-central-applications)
 - [Create an IoT Central application using the command line](howto-manage-iot-central-from-cli.md#create-an-application)
 - [Create an IoT Central application programmatically](/samples/azure-samples/azure-iot-central-arm-sdk-samples/azure-iot-central-arm-sdk-samples/)
 

articles/iot-central/core/howto-manage-iot-central-from-cli.md

@@ -12,7 +12,7 @@ ms.custom: [devx-track-azurecli, devx-track-azurepowershell]
 
 # Manage IoT Central from Azure CLI or PowerShell
 
-Instead of creating and managing IoT Central applications on the [Azure IoT Central application manager](https://aka.ms/iotcentral) website, you can use [Azure CLI](/cli/azure/) or [Azure PowerShell](/powershell/azure/) to manage your applications.
+Instead of creating and managing IoT Central applications in the [Azure portal](https://portal.azure.com/#create/Microsoft.IoTCentral), you can use [Azure CLI](/cli/azure/) or [Azure PowerShell](/powershell/azure/) to manage your applications.
 
 If you prefer to use a language such as JavaScript, Python, C#, Ruby, or Go to create, update, list, and delete Azure IoT Central applications, see the [Azure IoT Central ARM SDK samples](/samples/azure-samples/azure-iot-central-arm-sdk-samples/azure-iot-central-arm-sdk-samples/) repository.
 

articles/iot-central/core/howto-manage-iot-central-from-portal.md

@@ -5,33 +5,15 @@ services: iot-central
 ms.service: iot-central
 author: dominicbetts
 ms.author: dobett
-ms.date: 08/04/2022
+ms.date: 07/14/2023
 ms.topic: how-to
 ---
 
 # Manage and monitor IoT Central from the Azure portal
 
 You can use the [Azure portal](https://portal.azure.com) to create, manage, and monitor IoT Central applications.
 
-## Create IoT Central applications
-
-[!INCLUDE [Warning About Access Required](../../../includes/iot-central-warning-contribitorrequireaccess.md)]
-
-To create an application, navigate to the [IoT Central Application](https://portal.azure.com/#create/Microsoft.IoTCentral) page in the Azure portal:
-
-:::image type="content" source="media/howto-manage-iot-central-from-portal/create-form.png" alt-text="Screenshot that shows the Azure portal form for creating an I o T Central application.":::
-
-* **Resource name** is a unique name you can choose for your IoT Central application in your Azure resource group.
-
-* **Application URL** is the URL you can use to access your application.
-
-* **Template** is the type of IoT Central application you want to create. You can create a new application either from the list of industry-relevant templates to help you get started quickly, or start from scratch using the **Custom application** template.
-
-* **Location** is the Azure region where you'd like to create your application. Typically, you should choose the location that's physically closest to your devices to get optimal performance. For a list of the regions where Azure IoT Central is currently available, see [Availability by region](https://azure.microsoft.com/global-infrastructure/services/?regions=all&products=iot-central).
-
-  Once you choose a location, you can't later move your application to a different location.
-
-After filling out all fields, select **Create**. To learn more, see [Create an IoT Central application](howto-create-iot-central-application.md).
+To learn how to create an IoT Central application, see [Create an IoT Central application](howto-create-iot-central-application.md).
 
 ## Manage existing IoT Central applications
 
@@ -115,7 +97,7 @@ Use the **Workbooks** page to analyze logs and create visual reports. To learn m
 
 ### Metrics and invoices
 
-Metrics may differ from the numbers shown on your Azure IoT Central invoice. This situation occurs for a number of reasons such as:
+Metrics may differ from the numbers shown on your Azure IoT Central invoice. This situation occurs for reasons such as:
 
 * IoT Central [standard pricing plans](https://azure.microsoft.com/pricing/details/iot-central/) include two devices and varying message quotas for free. While the free items are excluded from billing, they're still counted in the metrics.
 
@@ -129,7 +111,7 @@ To learn how to remotely monitor your IoT Edge fleet using Azure Monitor and bui
 
 ## Next steps
 
-Now that you've learned how to manage and monitor Azure IoT Central applications from the Azure portal, here is the suggested next step:
+Now that you've learned how to manage and monitor Azure IoT Central applications from the Azure portal, here's the suggested next step:
 
 > [!div class="nextstepaction"]
 > [Administer your application](howto-administer.md)

articles/iot-central/core/media/howto-create-iot-central-application/create-app-portal.png

@@ -16,17 +16,9 @@ This article introduces you to Azure IoT Central UI. You can use the UI to creat
 
 ## IoT Central homepage
 
-The [IoT Central homepage](https://apps.azureiotcentral.com/) page is the place to learn more about the latest news and features available on IoT Central, create new applications, and see and launch your existing applications.
+The [IoT Central homepage](https://apps.azureiotcentral.com/) page is the place to learn more about the latest news and features available on IoT Central and see and launch your existing applications.
 
-:::image type="content" source="media/overview-iot-central-tour/iot-central-homepage.png" alt-text="Screenshot that shows the IoT Central homepage where you can create new IoT Central applications.":::
-
-### Create an application
-
-In the **Build** section you can browse the list of industry-relevant IoT Central templates, or start from scratch using a Custom application template.  
-
-:::image type="content" source="media/overview-iot-central-tour/iot-central-build.png" alt-text="Screenshot that shows the IoT Central build page where you can select an application template.":::
-
-To learn more, see the [Create an Azure IoT Central application](quick-deploy-iot-central.md) quickstart.
+:::image type="content" source="media/overview-iot-central-tour/iot-central-homepage.png" alt-text="Screenshot that shows the IoT Central homepage where you can see the IoT Central applications you have access to.":::
 
 ### Launch your application
 
@@ -44,7 +36,7 @@ Once you're inside your IoT application, use the left pane to access various fea
 :::row:::
   :::column span="":::
 
-    :::image type="content" source="media/overview-iot-central-tour/navigation-bar.png" alt-text="left pane":::
+    :::image type="content" source="media/overview-iot-central-tour/navigation-bar.png" alt-text="Screenshot that shows the IoT Central left navigation pane.":::
 
   :::column-end:::
   :::column span="2":::