Administer your IoT Central application

After you create an IoT Central application, you can go to the Administration section to:

  • Manage application settings
  • Manage users
  • Manage roles
  • View your bill
  • Convert your Trial to Pay-As-You-Go
  • Export data
  • Manage device connection
  • Use access tokens

To access and use the Administration section, you must be in the Administrator role for an Azure IoT Central application. If you create an Azure IoT Central application, you're automatically assigned to the Administrator role for that application. The Manage Users section in this article explains more about how to assign the Administrator role to other users.

Manage application settings

Change application name and URL

In the Application Settings page, you can change the name and URL of your application, then select Save.

Application settings page

Note

If you change your URL, your old URL can be taken by another Azure IoT Central customer. If that happens, it is no longer available for you to use. When you change your URL, the old URL no longer works, and you need to notify your users about the new URL to use.

Prepare and upload image

To change the application image, 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 Pay-As-You-Go application that you'll be charged for. You can't create a Trial application in this way.

Click the Copy button. In the dialog box, enter the details for the new Pay-As-You-Go application. Then click the Copy button to confirm that you want to proceed. Learn more about the fields in this form in Create an application quickstart.

Application settings page

After the app copy operation succeeds, you can go to the new application that was created by copying your application using the link that appears.

Application settings page

Note

Copying an application also copies the definition of rules and actions. But because users who have access to your original app aren't copied to the copied app, you have to manually add users to actions such as email for which users are a prerequisite. In general it is a good idea to check the rules and actions to make sure they are up to date in the new app.

Delete an application

Use the Delete button to permanently delete your IoT Central application. Doing this will permanently delete all data that's associated with that application. To delete an application, you must also have permissions 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.

Manage users

Add users

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 (Azure AD) accounts are supported in Azure IoT Central. Azure Active Directory groups aren't currently supported in Azure IoT Central.

For more information, see Microsoft account help and Quickstart: Add new users to Azure Active Directory.

  1. To add a user to an IoT Central application, go to the Users page in the Administration section.

    List of users

  2. To add a user, on the Users page, choose + Add user.

  3. Choose a role for the user from the Role drop-down menu. Learn more about roles in the Manage roles section of this article.

    Role selection

    Note

    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 menu. Then select Save.

Edit the roles that are assigned to users

Roles can't be changed after they are assigned. To change the role that's assigned to a user, delete the user, and then add the user again with a different role.

Delete users

To delete users, select one or more check boxes on the Users page. Then select Delete.

Manage roles

Roles enable you to control who within your organization can perform various tasks in IoT Central. There are three roles you can assign to users of your application.

Administrator

Users in the Administrator role have access to all functionality in an application.

The user who creates an application is automatically assigned to the Administrator role. There must always be at least one user in the Administrator role.

Application Builder

Users in the Application Builder role can do everything in an application except administer the application. This means builders can create, edit, and delete device templates and devices, manage device sets, and run analytics and jobs. Builders won't have access to the Administration section of the application.

Application Operator

Users in the Application Operator role can't make changes to device templates and can't administer the application. This means operators can adding and deleting devices, manage device sets, and run analytics and jobs. Operators won't have access to the Application Builder and Administration pages.

View your bill

To view your bill, go to the Billing page in the Administration section. The Azure billing page opens in a new tab, where you can see the bill for each of your Azure IoT Central applications.

Convert your Trial to Pay-As-You-Go

You can convert your Trial application to a Pay-As-You-Go application. Here are the differences between these types of applications.

  • Trial applications are free for 7 days before they expire. They can be converted to Pay-As-You-Go at any time before they expire.
  • Pay-As-You-Go applications are charged per device, with the first 5 devices free.

Learn more about pricing on the Azure IoT Central pricing page.

To complete this self-service process, follow these steps:

  1. Go to the Billing page in the Administration section.

    Trial state

  2. Click Convert to Pay-As-You-Go.

    Convert trial

  3. Select the appropriate Azure Active Directory, and then the Azure subscription to use for your Pay-As-You-Go application.

  4. After you click Convert, your application is now a Pay-As-You-Go application and you start getting billed.

Export data

You can enable Continuous data export to export measurements, devices, and device templates data to your Azure Blob storage account. Learn more about how to export your data.

Manage device connection

Connect devices at scale in your application using the keys and certificates here. Learn more about connecting devices.

Use access tokens

Generate access tokens to use them in developer tools. Currently there is one developer tool available which is the IoT Central explorer for monitoring device messages and changes in propreties and settings. Learn more about the IoT Central explorer.

Use the Azure SDKs for 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, which enable 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.

You can find examples of how to use the Azure Resource Manager SDKs at https://github.com/emgarten/iotcentral-arm-sdk-examples.

To learn more, take a look at these packages on GitHub.

Language Repository Package
Node https://github.com/Azure/azure-sdk-for-node https://www.npmjs.com/package/azure-arm-iotcentral
Python https://github.com/Azure/azure-sdk-for-python https://pypi.org/project/azure-mgmt-iotcentral
C# https://github.com/Azure/azure-sdk-for-net https://www.nuget.org/packages/Microsoft.Azure.Management.IotCentral
Ruby https://github.com/Azure/azure-sdk-for-ruby https://rubygems.org/gems/azure_mgmt_iot_central
Java https://github.com/Azure/azure-sdk-for-java https://search.maven.org/search?q=a:azure-mgmt-iotcentral
Go https://github.com/Azure/azure-sdk-for-go https://github.com/Azure/azure-sdk-for-go

Next steps

Now that you've learned how to administer your Azure IoT Central application, here is the suggested next step: