You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-central/howto-administer.md
+51-51Lines changed: 51 additions & 51 deletions
Original file line number
Diff line number
Diff line change
@@ -10,9 +10,9 @@ services: iot-central
10
10
manager: peterpr
11
11
---
12
12
13
-
# How to administer your application
13
+
# Administer your IOT Central application
14
14
15
-
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.
15
+
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 go to the **Administration** section, select**Administration** on the left navigation menu.
16
16
17
17
The **Administration** section enables you to:
18
18
@@ -24,51 +24,51 @@ The **Administration** section enables you to:
24
24
25
25
- Manage application settings
26
26
27
-
-Extend a free trial
27
+
-Offer a free trial
28
28
29
-
In the **Administration** section, there is a secondary navigation menu with links to the various administration tasks.
29
+
In the **Administration** section, a secondary navigation menu has links to the various administration tasks.
30
30
31
-
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.
31
+
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 *Managing Users* section in this article explains more about how to assign the **Administrator** role to other users.
32
32
33
33
## Change application name
34
34
35
-
To change the name of your application, use the secondary navigation menu to navigate to the **Application Settings** page in the **Administration** section.
35
+
To change the name of your application, use the secondary navigation menu to go to the **Application Settings** page in the **Administration** section.
36
36
37
-
On the **Application Settings** page, enter a name of your choice in the **Application Name** field, and then choose**Save**.
37
+
On the **Application Settings** page, enter a name of your choice in the **Application Name** field. Then select**Save**.
38
38
39
39
## Change the application URL
40
40
41
41
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
45
+
On the **Application Settings** page, enter the URL of your choice in the **URL** field, and then select**Save**. Your URL can be at most 200 characters in length. If the URL isn't available, you see a validation error.
46
46
47
47
> [!Note]
48
-
> 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.
48
+
> 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.
49
49
50
50
## Change the application image
51
51
52
52
For more information about using images in an Azure IoT Central application, see [Prepare and upload images to your Azure IoT Central application](howto-prepare-images.md).
53
53
54
54
## Copy an application
55
55
56
-
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.
56
+
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're charged for. You can't create a trial application by copying another application.
57
57
58
-
To copy an application, navigate to the **Application Settings** page and click the **Copy** button.
58
+
To copy an application, go to the **Application Settings** page. Then select 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](howto-create-application.md).
62
+
Selecting the **Copy** button opens a dialog box in which you can select a name, URL, Azure AD directory, subscription, and Azure region for the new application that will be created by copying your application. Select values for each of those fields. Then select the **Copy** button to confirm that you want to proceed. You can learn more about what to enter for those values in this article about [how to create an application](howto-create-application.md).
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.
66
+
After the app copy operation succeeds, you can go to the new application that was created by copying your application. To go to the app, select 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.
71
+
> Copying an application also copies the definition of rules or 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 pre-requisite.
72
72
73
73
## Delete an application
74
74
@@ -77,17 +77,17 @@ To delete your application, use the secondary navigation menu to navigate to the
77
77
Choose **Delete**.
78
78
79
79
> [!Note]
80
-
> 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](https://docs.microsoft.com/azure/active-directory/role-based-access-control-configure).
80
+
> Deleting an application permanently deletes 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](https://docs.microsoft.com/azure/active-directory/role-based-access-control-configure).
81
81
82
82
## Roles in Azure IoT Central
83
83
84
-
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.
84
+
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 to multiple roles within an application.
85
85
86
86
### Administrator
87
87
88
88
Users in the **Administrator** role have access to all functionality in an Azure IoT Central application.
89
89
90
-
The user creating an application is automatically assigned to the **Administrator** role. There must always be at least one user in the **Administrator** role.
90
+
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.
91
91
92
92
### Application Builder
93
93
@@ -103,74 +103,74 @@ Application administrators can assign users to the roles in the application.
103
103
104
104
### Add users
105
105
106
-
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.
106
+
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.
107
107
108
-
To learn more, see [Microsoft account help](https://support.microsoft.com/products/microsoft-account?category=manage-account) and [Quickstart: Add new users to Azure Active Directory](https://docs.microsoft.com/azure/active-directory/add-users-azure-active-directory).
108
+
For more information, see [Microsoft account help](https://support.microsoft.com/products/microsoft-account?category=manage-account) and [Quickstart: Add new users to Azure Active Directory](https://docs.microsoft.com/azure/active-directory/add-users-azure-active-directory).
109
109
110
-
1. 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.
110
+
1. To add a user account to an Azure IoT Central application, use the secondary navigation menu to go to the **Users** page in the **Administration** section.
111
111
112
-

112
+

113
113
114
-
1.On the **Users** page, choose **+ Add user** to add a user.
114
+
1.To add a user, on the **Users** page, choose **+ Add user**.
115
115
116
-

116
+

117
117
118
-
1.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.
118
+
1.Choose a role for the user from the **Role** drop-down menu. 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**.
123
+
> 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**.
124
124
125
125
1. After you add a user, an entry appears for that user on the **Users** page.
126
126
127
-

127
+

128
128
129
-
### Edit the roles assigned to users
129
+
### Edit the roles that are assigned to users
130
130
131
-
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.
131
+
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.
132
132
133
133
### Delete users
134
134
135
-
To delete users, check one or more checkboxes on the **Users** page and then choose**Delete**.
135
+
To delete users, select one or more check boxes on the **Users** page. Then select**Delete**.
136
136
137
137
## View your bill
138
138
139
-
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.
139
+
To view your bill, go to the **Billing** page in the **Administration** section. Then select**Billing**. The Azure billing page opens in a new tab, where you can see the bill for each of your Azure IoT Central applications.
140
140
141
141
## Convert your trial to a paid application
142
142
143
-
Once you've evaluated IoT Central, you can convert your trial to a paid application. To complete this self-service process, follow these steps:
143
+
After you've evaluated IoT Central, you can convert your trial to a paid application. To complete this self-service process, follow these steps:
144
144
145
-
1. 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:
145
+
1. Use the secondary navigation menu to go to the **Billing** page in the **Administration** section. If you haven't extended your trial, the page looks like the following screenshot:
2. Click **Convert to Paid**. If you haven't extended your trial, the pop-up looks like the following:
150
-
151
-
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.
149
+
2. Select **Convert to Paid**. If you haven't extended your trial, the pop-up window looks like the following screenshot:
3. After you click **Convert**, your trial is converted to a paid application and you start getting billed.
153
+
3. In the pop-up window, select the appropriate Azure Active Directory tenant, and then the Azure subscription to use for your IoT Central application.
154
+
155
+
3. After you select **Convert**, your trial coverts to a paid application and you start getting billed.
156
156
157
157
## Extend your free trial
158
158
159
-
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:
159
+
By default, all free trials are available for seven days. If you'd like to increase your trial to 30 days, follow these steps:
160
160
161
-
1. Use the secondary navigation menu to navigate to the **Billing** page in the **Administration** section:
161
+
1. Use the secondary navigation menu to go to the **Billing** page in the **Administration** section.
162
162
163
-
1.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:
163
+
1.Select**Extend Trial**. In the pop-up window, select the appropriate Azure Active Directory tenant and then the Azure subscription to use for your IoT Central application.
164
164
165
-
1. Then click**Extend**. Your trial is now valid for 30 days.
165
+
1. Then select**Extend**. Your trial is now valid for 30 days.
166
166
167
-
## Utilize the Azure SDKs to do control plane operations
167
+
## Use the Azure SDKs for control plane operations
168
168
169
-
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.
169
+
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.
170
170
171
-
Examples of using the Azure Resource Manager SDKs can be found at [https://github.com/emgarten/iotcentral-arm-sdk-examples](https://github.com/emgarten/iotcentral-arm-sdk-examples).
171
+
You can find examples of how to use the Azure Resource Manager SDKs at [https://github.com/emgarten/iotcentral-arm-sdk-examples](https://github.com/emgarten/iotcentral-arm-sdk-examples).
172
172
173
-
To learn more take a look at these packages on GitHub.
173
+
To learn more, take a look at these packages on GitHub.
174
174
175
175
| Language | Repository | Package |
176
176
| ---------| ---------- | ------- |
@@ -183,7 +183,7 @@ To learn more take a look at these packages on GitHub.
183
183
184
184
## Next steps
185
185
186
-
Now that you have learned how to administer your Azure IoT Central application, here is the suggested next step:
186
+
Now that you've learned how to administer your Azure IoT Central application, here is the suggested next step:
187
187
188
188
> [!div class="nextstepaction"]
189
-
> [Set up the device template](howto-set-up-template.md)
189
+
> [Set up the device template](howto-set-up-template.md)
0 commit comments