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

How to create app

Author: megvanhuygen

articles/iot-central/TOC.yml

@@ -200,6 +200,8 @@
   items:
     - name: Develop and connect devices
       items:
+        - name: Create an application
+          href: core/howto-create-iot-central-application.md
         - name: Set up a device template
           href: core/howto-set-up-template.md
         - name: Version device template

articles/iot-central/core/concepts-app-templates.md

@@ -24,28 +24,13 @@ You choose the application template when you create your application. You can't
 
 ## Custom templates
 
-If you want to create your application from scratch, choose one of the **Custom application** templates.
+If you want to create your application from scratch, choose the **Custom application** template. The custom application template id is `iotc-pnp-preview`.
 
 ## Industry focused templates
 
-Azure IoT Central is an industry agnostic application platform. Application templates are industry focused examples available for these industries today, with more to come in the future:
-
-- [Retail](../retail/overview-iot-central-retail.md)
-  - Connected logistics
-  - Digital distribution center
-  - In-store analytics - condition monitoring
-  - In-store analytics - checkout
-  - Smart Inventory Management
-  - Video analytics - object and motion detection
-- [Energy](../energy/overview-iot-central-energy.md)
-  - Smart meter monitoring
-  - Solar panel monitoring
-- [Government](../government/overview-iot-central-government.md)
-  - Connected waste management
-  - Water consumption monitoring
-  - Water quality monitoring
-- [Healthcare](../healthcare/overview-iot-central-healthcare.md).
-  - Continuous patient monitoring
+Azure IoT Central is an industry agnostic application platform. Application templates are industry focused examples available for these industries today:
+
+[!INCLUDE [iot-central-template-list](../../../includes/iot-central-template-list.md)]
 
 ## Next steps
 

articles/iot-central/core/how-to-connect-iot-edge-transparent-gateway.md

@@ -20,11 +20,11 @@ This article uses virtual machines to host the downstream device and gateway. In
 
 ## Prerequisites
 
-To complete the steps in this tutorial, you need an active Azure subscription.
+To complete the steps in this article, you need:
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+- An active Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-Complete the [Create an Azure IoT Central application](./quick-deploy-iot-central.md) quickstart to create an IoT Central application using the **Custom app > Custom application** template.
+- An [IoT Central application created](howto-create-iot-central-application.md) from the **Custom application** template. To learn more, see [Create an IoT Central application](howto-create-iot-central-application.md).
 
 To follow the steps in this article, download the following files to your computer:
 

articles/iot-central/core/howto-build-iotc-device-bridge.md

@@ -22,11 +22,9 @@ The device bridge solution provisions several Azure resources into your Azure su
 
 ## Prerequisites
 
-To complete the steps in this how-to guide, you need an active Azure subscription.
+To complete the steps in this how-to guide, you need:
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
-
-Complete the [Create an Azure IoT Central application](./quick-deploy-iot-central.md) quickstart to create an IoT Central application using the **Custom app > Custom application** template.
+[!INCLUDE [iot-central-prerequisites-basic](../../../includes/iot-central-prerequisites-basic.md)]
 
 ## Overview
 

articles/iot-central/core/howto-configure-rules-advanced.md

@@ -22,9 +22,9 @@ The Azure IoT Central V3 connector for Power Automate and Azure Logic Apps lets
 
 ## Prerequisites
 
-To complete the steps in this how-to guide, you need an active Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+To complete the steps in this how-to guide, you need:
 
-Setting up the solution requires a version 3 IoT Central application. To learn how to check your application version, see [About your application](./howto-get-app-info.md). To learn how to create an IoT Central application, see [Create an Azure IoT Central application](./quick-deploy-iot-central.md).
+[!INCLUDE [iot-central-prerequisites-basic](../../../includes/iot-central-prerequisites-basic.md)]
 
 > [!NOTE]
 > If you're using a version 2 IoT Central application, see [Build workflows with the IoT Central connector in Azure Logic Apps](/previous-versions/azure/iot-central/core/howto-build-azure-logic-apps) on the previous versions documentation site and use the Azure IoT Central V2 connector

articles/iot-central/core/howto-connect-powerbi.md

@@ -29,11 +29,10 @@ This solution sets up a pipeline that reads data from your [legacy data export](
 
 ## Prerequisites
 
-To complete the steps in this how-to guide, you need an active Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+To complete the steps in this how-to guide, you need:
 
-Setting up the solution requires the following resources:
+[!INCLUDE [iot-central-prerequisites-basic](../../../includes/iot-central-prerequisites-basic.md)]
 
-- A version 3 IoT Central application. To learn how to check your application version, see [About your application](./howto-get-app-info.md). To learn how to create an IoT Central application, see [Create an Azure IoT Central application](./quick-deploy-iot-central.md).
 - Legacy continuous data export which is configured to export telemetry, devices, and device templates to Azure Blob storage. To learn more, see [legacy data export documentation](howto-export-data-legacy.md).
   - Make sure that only your IoT Central application is exporting data to the blob container.
   - Your [devices must send JSON encoded messages](../../iot-hub/iot-hub-devguide-messages-d2c.md). Devices must specify `contentType:application/JSON` and `contentEncoding:utf-8` or `contentEncoding:utf-16` or `contentEncoding:utf-32` in the message system properties.

articles/iot-central/core/howto-connect-rigado-cascade-500.md

@@ -23,10 +23,12 @@ Cascade 500 IoT gateway is a hardware offering from Rigado that is included as p
 Cascade 500 is certified for Azure IoT Plug and Play and allows you to easily onboard the device into your end to end solutions. The Cascade gateway allows you to wirelessly connect to a variety of condition monitoring sensors that are in proximity to the gateway device. These sensors can be onboarded into IoT Central via the gateway device.
 
 ## Prerequisites
-To step through this how-to guide, you need the following resources:
 
-* A Rigado Cascade 500 device. For more information, please visit [Rigado](https://www.rigado.com/).
-* An Azure IoT Central application. For more information, see the [create a new application](./quick-deploy-iot-central.md).
+To complete the steps in this how-to guide, you need:
+
+[!INCLUDE [iot-central-prerequisites-basic](../../../includes/iot-central-prerequisites-basic.md)]
+
+- A Rigado Cascade 500 device. For more information, please visit [Rigado](https://www.rigado.com/).
 
 ## Add a device template
 

articles/iot-central/core/howto-connect-ruuvi.md

@@ -28,9 +28,12 @@ Please follow the [instructions here](./howto-connect-rigado-cascade-500.md) if
 
 To connect RuuviTag sensors, you need the following resources:
 
-* A RuuviTag sensor. For more information, please visit [RuuviTag](https://ruuvi.com/).
-* A Rigado Cascade 500 device or another BLE gateway. For more information, please visit [Rigado](https://www.rigado.com/).
-* An Azure IoT Central application. For more information, see the [create a new application](./quick-deploy-iot-central.md).
+[!INCLUDE [iot-central-prerequisites-basic](../../../includes/iot-central-prerequisites-basic.md)]
+
+- A RuuviTag sensor. For more information, please visit [RuuviTag](https://ruuvi.com/).
+
+- A Rigado Cascade 500 device or another BLE gateway. For more information, please visit [Rigado](https://www.rigado.com/).
+
 
 ## Add a RuuviTag device template
 

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

@@ -0,0 +1,101 @@
+---
+title: Create an IoT Central application | Microsoft Docs
+description: This article describes the options to create an IoT Central application including from the Azure IoT Central site, the Azure portal, and from a command-line environment.
+services: iot-central
+ms.service: iot-central
+author: dominicbetts
+ms.author: dobett
+ms.date: 05/11/2021
+ms.topic: how-to
+---
+
+# Create an IoT Central application
+
+You have several ways to create an IoT Central application. You can use one of the GUI-based methods if you prefer a manual approach, or one of the CLI or programmatic methods if you want to automate the process.
+
+Whichever approach you choose, the configuration options are the same, and the process typically takes less than a minute to complete.
+
+[!INCLUDE [Warning About Access Required](../../../includes/iot-central-warning-contribitorrequireaccess.md)]
+
+## Options
+
+This section describes the available options when you create an IoT Central application. Depending on the method you choose, you might need to supply the options on a form or as command-line parameters:
+
+### Pricing plans
+
+The *free* plan lets you create an IoT Central application to try for seven days. The free plan:
+
+- Doesn't require an Azure subscription.
+- Can only be created and managed on the [Azure IoT Central](https://aka.ms/iotcentral) site.
+- Lets you connect up to five devices.
+- Can be upgraded to a standard plan if you want to keep your application.
+
+The *standard* plans:
+
+- Do require an Azure subscription. You should have at least **Contributor** access in your Azure subscription. If you created the subscription yourself, you're automatically an administrator with sufficient access. To learn more, see [What is Azure role-based access control?](../../role-based-access-control/overview.md).
+- Let you create and manage IoT Central applications using any of the available methods.
+- Let you connect as many devices as you need. You're billed by device. To learn more, see [Azure IoT Central pricing](/pricing/details/iot-central/).
+- Cannot be downgraded to a free plan, but can be upgraded or downgraded to other standard plans.
+
+The following table summarizes the differences between the three standard plans:
+
+| Plan name | Free devices | Messages/month | Use case |
+| --------- | ------------ | -------------- | -------- |
+| S0        | 2            | 400            | A few messages per day |
+| S1        | 2            | 5,000          | A few messages per hour |
+| S2        | 2            | 30,000         | Messages every few minutes |
+
+To learn more, see [Manage your bill in an IoT Central application](howto-view-bill.md).
+
+### 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 _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`.
+
+### Application template ID
+
+The application template you choose determines the initial contents of your application, such as dashboards and device templates. The template ID For a custom application, use `iotc-pnp-preview` as the template ID.
+
+To learn more about custom and industry-focused application templates, see [What are application templates?](concepts-app-templates.md).
+
+### Billing information
+
+If you choose one of the standard plans, you need to provide billing information:
+
+- The Azure subscription you're using.
+- The directory that contains the subscription you're using.
+- The location to host your application. IoT Central uses Azure geographies as locations: United States, Europe, Asia Pacific, Australia, United Kingdom, or Japan.
+
+## Azure IoT Central site
+
+The easiest way to get started creating IoT Central applications is on the [Azure IoT Central](https://aka.ms/iotcentral) site.
+
+The [Build](https://apps.azureiotcentral.com/build) lets you select the application template you want to use:
+
+:::image type="content" source="media/howto-create-iot-central-application/choose-template.png" alt-text="Screenshot of build page that lets you choose an application template.":::
+
+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-application.png" alt-text="Screenshot showing create application page for IoT Central.":::
+
+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.
+
+> [!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 decribed in the following section let you choose a resource group to use.
+
+## Other approaches
+
+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 Azure CLI](howto-manage-iot-central-from-cli.md#create-an-application)
+- [Create an IoT Central application using PowerShell](howto-manage-iot-central-from-powershell.md#create-an-application)
+- [Create an IoT Central application programmatically](howto-manage-iot-central-programmatically.md)
+
+## Next steps
+
+Now that you've learned how to manage Azure IoT Central applications from Azure CLI, here's the suggested next step:
+
+> [!div class="nextstepaction"]
+> [Administer your application](howto-administer.md)

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

@@ -56,8 +56,12 @@ These commands first create a resource group in the east US region for the appli
 | template          | The application template to use. For more information, see the following table. |
 | display-name      | The name of the application as displayed in the UI. |
 
+### Application templates
+
 [!INCLUDE [iot-central-template-list](../../../includes/iot-central-template-list.md)]
 
+If you've created your own application template, you can use it to create a new application. When asked for an application template, enter the app ID shown in the exported app's URL shareable link under the [Application template export](howto-use-app-templates.md#create-an-application-template) section of your app.
+
 ## View your applications
 
 Use the [az iot central app list](/cli/azure/iot/central/app#az_iot_central_app_list) command to list your IoT Central applications and view metadata.