How to administer your application
After you create a Microsoft Azure IoT Central application, you can use the Administration section of the Azure IoT Central user interface to administer it. To navigate to the Administration section, choose Administration on the left navigation menu.
The Administration section enables you to:
View billing information
Manage application settings
Extend a free trial
In the Administration section, there is a secondary navigation menu with links to the various administration tasks.
To access and use the Administration section, you must be in the Administrator role in the Azure IoT Central application. If you create an Azure IoT Central application, you are automatically assigned to the Administrator role for that application. The Managing Users section in this article explains more about how to assign the Administrator role to other users.
Change application name
To change the name of your application, use the secondary navigation menu to navigate to the Application Settings page in the Administration section.
On the Application Settings page, enter a name of your choice in the Application Name field, and then choose Save.
Change the application URL
To change the URL for your application, use the secondary navigation menu to navigate to the Application Settings page in the Administration section.
On the Application Settings page, enter the URL of your choice in the URL field, and then choose Save. Your URL can be at most 200 characters in length. If the URL is not available, you see a validation error
If you change your URL, your old URL can be taken by another Azure IoT Central customer. In that case, it is no longer available for you to use. When you change your URL, the old URL no longer works and you must notify your users about the new URL to use.
Change the application image
For more information about using images in an Azure IoT Central application, see Prepare and upload images to your Azure IoT Central application.
Copy an application
You can create a copy of any application, minus any device instances, device data history, and user data. The copy will be a paid application that you'll be charged for. You cannot create a trial application by copying another application.
To copy an application, navigate to the Application Settings page and click the Copy button.
Clicking the Copy button will open a dialog in which you can select a name, URL, AAD directory, subscription and Azure region for the new application that will be created by copying your application. Select values for each of those fields and then click the Copy button to confirm that you want to proceed. You can learn more about what to enter for those values in the article about how to create an application.
Once the app copy operation succeeds, you will be able to navigate to the new application that was created by copying your application by clicking the link that appears on the Application Settings page.
Copying an application will copy the definition of rules or actions. However, since users that have access to your original app aren't copied to the copied app, you'll have to manually add users to actions such as email for which users are a pre-requisite.
Delete an application
To delete your application, use the secondary navigation menu to navigate to the Application Settings page in the Administration section.
Deleting an application irrecoverably deletes all data associated with the application. To delete an application, you must also have the rights to delete resources in the Azure subscription you chose when you created the application. To learn more, see Use Role-Based Access Control to manage access to your Azure subscription resources.
Roles in Azure IoT Central
Roles enable you to control who, within your organization, can perform various Azure IoT Central tasks. Azure IoT Central has three roles you can assign to users of your application. Roles are assigned by each application. The same user can have different roles in different applications. You can assign the same user can to multiple roles within an application.
Users in the Administrator role have access to all functionality in an Azure IoT Central application.
The user creating an application is automatically assigned to the Administrator role. There must always be at least one user in the Administrator role.
Users in the Application Builder role can do everything in an Azure IoT Central application except administer the application.
Users in the Application Operator role don't have access to the Application Builder page. They can't administer the application.
Application administrators can assign users to the roles in the application.
Every user must have a user account before they can sign in and access an Azure IoT Central application. Microsoft Accounts (MSAs) and Azure Active Directory (AAD) accounts are supported in Azure IoT Central. Azure Active Directory groups are not currently supported in Azure IoT Central.
To learn more, see Microsoft account help and Quickstart: Add new users to Azure Active Directory.
To add a user account to an Azure IoT Central application, use the secondary navigation menu to navigate to the Users page in the Administration section.
On the Users page, choose + Add user to add a user.
When you add a user to your Azure IoT Central application, choose a role for the user from the Role drop-down. Learn more about roles in the Roles in Azure IoT Central section of this article.
To add users in bulk, enter the User IDs of all the users you'd like to add separated by semi-colons. Choose a role from the Role drop-down and choose Save.
After you add a user, an entry appears for that user on the Users page.
Edit the roles assigned to users
Roles cannot be changed once assinged. To change the role assigned to a user, delete the user and add the user again with a different role.
To delete users, check one or more checkboxes on the Users page and then choose Delete.
View your bill
To view your bill, navigate to the Billing page in the Administration section and choose Billing. The Azure billing page opens in a new tab and you can see the bill for each of your Azure IoT Central applications.
Convert your trial to a paid application
Once you've evaluated IoT Central, you can convert your trial to a paid application. To complete this self-service process, follow these steps:
Use the secondary navigation menu to navigate to the Billing page in the Administration section. If you haven't extended your trial, the page looks like the following:
Click Convert to Paid. If you haven't extended your trial, the pop-up looks like the following:
In the pop-up select the appropriate Azure Active Directory tenant and then the Azure Subscription that you want to use for your IoT Central application.
After you click Convert, your trial is converted to a paid application and you start getting billed.
Extend your free trial
By default, all free trials are available for 7 days. If you'd like to increase your trial to 30 days, you follow these steps:
Use the secondary navigation menu to navigate to the Billing page in the Administration section:
Click Extend Trial. In the pop-up select the appropriate Azure Active Directory tenant and then the Azure Subscription to use for your IoT Central application:
Then click Extend. Your trial is now valid for 30 days.
Utilize the Azure SDKs to do control plane operations
IoT Central Azure Resource Manager SDK packages are available for Node, Python, C#, Ruby, Java, and Go. These libraries support control plane operations for IoT Central, allowing you to create, list, update, or delete IoT Central applications. They also provide helpers for dealing with authentication and error handling that is specific to each language.
Examples of using the Azure Resource Manager SDKs can be found at https://github.com/emgarten/iotcentral-arm-sdk-examples.
To learn more take a look at these packages on GitHub.
Now that you have learned how to administer your Azure IoT Central application, here is the suggested next step: