Merge pull request #241207 from dominicbetts/central-june-freshness-2

IoT Central: freshness

Author: ShannonLeavitt

articles/iot-central/core/overview-iot-central-api-tour.md

@@ -3,7 +3,7 @@ title: Take a tour of the Azure IoT Central API
 description: Become familiar with the key areas of the Azure IoT Central REST API. Use the API to create, manage, and use your IoT solution from client applications.
 author: dominicbetts
 ms.author: dobett
-ms.date: 06/10/2022
+ms.date: 06/12/2023
 ms.topic: overview
 ms.service: iot-central
 services: iot-central
@@ -20,18 +20,21 @@ The REST API operations are grouped into the:
 
 ## Data plane operations
 
-Version 2022-05-31 of the data plane API lets you manage the following resources in your IoT Central application:
+Version 2022-07-31 of the data plane API lets you manage the following resources in your IoT Central application:
 
 - API tokens
 - Device groups
 - Device templates
 - Devices
+- Enrollment groups
 - File uploads
+- Jobs
 - Organizations
 - Roles
+- Scheduled jobs
 - Users
 
-The preview devices API also lets you [query telemetry and property values from your devices](howto-query-with-rest-api.md), [manage jobs](howto-manage-jobs-with-rest-api.md), and [manage data exports](howto-manage-data-export-with-rest-api.md).
+The preview devices API also lets you [manage dashboards](howto-manage-dashboards-with-rest-api.md), [manage deployment manifests](howto-manage-deployment-manifests-with-rest-api.md), and [manage data exports](howto-manage-data-export-with-rest-api.md).
 
 To get started with the data plane APIs, see [Tutorial: Use the REST API to manage an Azure IoT Central application](tutorial-use-rest-api.md).
 

articles/iot-central/core/overview-iot-central-tour.md

@@ -3,12 +3,11 @@ title: Take a tour of the Azure IoT Central UI
 description: Become familiar with the key areas of the Azure IoT Central UI that you use to create, manage, and use your IoT solution.
 author: dominicbetts
 ms.author: dobett
-ms.date: 06/10/2022
+ms.date: 06/12/2023
 ms.topic: overview
 ms.service: iot-central
 services: iot-central
 ms.custom: mvc
-manager: corywink
 ---
 
 # Take a tour of the Azure IoT Central UI
@@ -19,21 +18,21 @@ This article introduces you to Azure IoT Central UI. You can use the UI to creat
 
 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.
 
-:::image type="content" source="media/overview-iot-central-tour/iot-central-homepage.png" alt-text="IoT Central homepage":::
+:::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="IoT Central build page":::
+:::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.
 
 ### Launch your application
 
-You launch your IoT Central application by navigating to the URL you chose during app creation. You can also see a list of all the applications you have access to in the [IoT Central app manager](https://apps.azureiotcentral.com/myapps).
+You launch your IoT Central application by navigating to the URL you chose during app creation. You can see a list of all the applications you have access to in the [IoT Central app manager](https://apps.azureiotcentral.com/myapps).
 
-:::image type="content" source="media/overview-iot-central-tour/app-manager.png" alt-text="IoT Central app manager":::
+:::image type="content" source="media/overview-iot-central-tour/app-manager.png" alt-text="Screenshot of the IoT Central app manager that shows a list of the applications you can access.":::
 
 ## Navigate your application
 
@@ -58,7 +57,7 @@ Once you're inside your IoT application, use the left pane to access various fea
 
     **Edge manifests** lets you import and manage deployment manifests for the IoT Edge devices that connect to your application.
 
-    **Data explorer** exposes rich capabilities to analyze historical trends and correlate various telemetries from your devices.
+    **Data explorer** exposes rich capabilities to analyze historical trends and correlate various telemetry types from your devices.
 
     **Dashboards** displays all application and personal dashboards. 
 
@@ -85,7 +84,7 @@ Once you're inside your IoT application, use the left pane to access various fea
 
 The top menu appears on every page:
 
-:::image type="content" source="media/overview-iot-central-tour/toolbar.png" alt-text="IoT Central Toolbar":::
+:::image type="content" source="media/overview-iot-central-tour/toolbar.png" alt-text="Screenshot that shows the IoT Central Toolbar with access to utilities such as search.":::
 
 * To search for devices, enter a **Search** value.
 * To change the UI language or theme, choose the **Settings** icon. Learn more about [managing your application preferences](howto-manage-preferences.md)
@@ -101,7 +100,7 @@ You can choose between a light theme or a dark theme for the UI:
 
 ### Devices
 
-:::image type="content" source="Media/overview-iot-central-tour/devices.png" alt-text="Screenshot of Devices Page.":::
+:::image type="content" source="Media/overview-iot-central-tour/devices.png" alt-text="Screenshot of the Devices page that list your devices.":::
 
 This page shows the devices in your IoT Central application grouped by _device template_.
 
@@ -110,73 +109,73 @@ This page shows the devices in your IoT Central application grouped by _device t
 
 ### Device groups
 
-:::image type="content" source="Media/overview-iot-central-tour/device-groups.png" alt-text="Device Group page":::
+:::image type="content" source="Media/overview-iot-central-tour/device-groups.png" alt-text="Screenshot of the Device Group page that shows device groupings.":::
 
 This page lets you create and view device groups in your IoT Central application. You can use device groups to do bulk operations in your application or to analyze data. To learn more, see the [Use device groups in your Azure IoT Central application](tutorial-use-device-groups.md) article.
 
 ### Device templates
 
-:::image type="content" source="Media/overview-iot-central-tour/templates.png" alt-text="Screenshot of Device Templates.":::
+:::image type="content" source="Media/overview-iot-central-tour/templates.png" alt-text="Screenshot of Device templates page where you can manage device templates.":::
 
 The device templates page is where you can view and create device templates in the application. To learn more, see [Connect Azure IoT Edge devices to an Azure IoT Central application](concepts-iot-edge.md).
 
 ### Edge manifests
 
-:::image type="content" source="Media/overview-iot-central-tour/manifests.png" alt-text="Screenshot of Edge manifests page.":::
+:::image type="content" source="Media/overview-iot-central-tour/manifests.png" alt-text="Screenshot of IoT Edge manifests page where you can manage IoT Edge deployment manifests.":::
 
 The edge manifests page is where you can import and manage IoT Edge deployment manifests in the application. To learn more, see the [Define a new device type in your Azure IoT Central application](howto-set-up-template.md) tutorial.
 
 ### Data Explorer
 
-:::image type="content" source="Media/overview-iot-central-tour/analytics.png" alt-text="Screenshot of data analytics page.":::
+:::image type="content" source="Media/overview-iot-central-tour/analytics.png" alt-text="Screenshot of data analytics page where you can build custom queries and charts.":::
 
-Data explorer exposes rich capabilities to analyze historical trends and correlate various telemetries from your devices. To learn more, see the [Create analytics for your Azure IoT Central application](howto-create-analytics.md) article.
+Data explorer exposes rich capabilities to analyze historical trends and correlate various telemetry types from your devices. To learn more, see the [Create analytics for your Azure IoT Central application](howto-create-analytics.md) article.
 
 ### Dashboards
 
-:::image type="content" source="Media/overview-iot-central-tour/dashboard.png" alt-text="Screenshot of IoT Central Dashboard.":::
+:::image type="content" source="Media/overview-iot-central-tour/dashboard.png" alt-text="Screenshot of IoT Central Dashboard, a customizable UI for your application.":::
 
 * Personal dashboards can also be created to monitor what you care about. To learn more, see the [Create Azure IoT Central personal dashboards](howto-manage-dashboards.md) how-to article.
 
 ### Jobs
 
-:::image type="content" source="Media/overview-iot-central-tour/jobs.png" alt-text="Jobs Page":::
+:::image type="content" source="Media/overview-iot-central-tour/jobs.png" alt-text="Screenshot that shows the Jobs page where you can manage your application's jobs.":::
 
 This page lets you view and create jobs that can be used for bulk device management operations on your devices. You can update device properties, settings, and execute commands against device groups. To learn more, see the [Run a job](howto-manage-devices-in-bulk.md) article.
 
 ### Rules
 
-:::image type="content" source="Media/overview-iot-central-tour/rules.png" alt-text="Screenshot of Rules Page.":::
+:::image type="content" source="Media/overview-iot-central-tour/rules.png" alt-text="Screenshot of Rules page where you manage your rules.":::
 
 This page lets you view and create rules based on device data. When a rule fires, it can trigger one or more actions such as sending an email or invoking a webhook. To learn, see the [Configuring rules](tutorial-create-telemetry-rules.md) tutorial.
 
 ### Data export
 
-:::image type="content" source="Media/overview-iot-central-tour/export.png" alt-text="Data Export":::
+:::image type="content" source="Media/overview-iot-central-tour/export.png" alt-text="Screenshot that shows the Data export page where you configure data exports to various destinations.":::
 
 Data export enables you to set up streams of data to external systems. To learn more, see the [Export your data in Azure IoT Central](./howto-export-to-blob-storage.md) article.
 
 ### Audit logs
 
-:::image type="content" source="Media/overview-iot-central-tour/audit.png" alt-text="Screenshot of audit logs page.":::
+:::image type="content" source="Media/overview-iot-central-tour/audit.png" alt-text="Screenshot of audit logs page where you can track activity in the application.":::
 
 Audit logs enable you to view a list of recent changes made in your IoT Central application. To learn more, see the [Use audit logs to track activity in your IoT Central application](howto-use-audit-logs.md) article.
 
 ### Permissions
 
-:::image type="content" source="Media/overview-iot-central-tour/permissions.png" alt-text="Screenshot of Permissions Page.":::
+:::image type="content" source="Media/overview-iot-central-tour/permissions.png" alt-text="Screenshot of Permissions page where you can manage access to your application.":::
 
 This page let you define a hierarchy that you use to manage which users can see which devices in your IoT Central application. To learn, see the [Manage IoT Central organizations](howto-create-organizations.md).
 
 ### Application
 
-:::image type="content" source="media/overview-iot-central-tour/administration.png" alt-text="Screenshot of IoT Application.":::
+:::image type="content" source="media/overview-iot-central-tour/administration.png" alt-text="Screenshot of IoT application page where can access various configuration settings for the application.":::
 
 The application page allows you to configure your IoT Central application. Here you can change your application name, URL, theming, manage users and roles, create API tokens, and export your application. To learn more, see the [Administer your Azure IoT Central application](howto-administer.md) article.
 
 ### Customization
 
-:::image type="content" source="media/overview-iot-central-tour/customization.png" alt-text="Screenshot of customization.":::
+:::image type="content" source="media/overview-iot-central-tour/customization.png" alt-text="Screenshot of customization page where you can customize the application's UI.":::
 
 The customization page allows you to customize your IoT Central application. Here you can change your masthead logo, browser icon, and browser colors. To learn more, see the [How to customize the Azure IoT Central UI](howto-customize-ui.md) article.
 

articles/iot-central/core/troubleshoot-data-export.md

@@ -4,7 +4,7 @@ description: Troubleshoot data exports in IoT Central for issues such as managed
 services: iot-central
 author: dominicbetts
 ms.author: dobett
-ms.date: 06/10/2022
+ms.date: 06/12/2023
 ms.topic: troubleshooting
 ms.service: iot-central
 
@@ -16,11 +16,11 @@ This document helps you find out why the data your IoT Central application isn't
 
 ## Managed identity issues
 
-You're using a managed identity to authorize the connection to an export destination. Data is not arriving at the export destination.
+You're using a managed identity to authorize the connection to an export destination. Data isn't arriving at the export destination.
 
 Before you configure or enable the export destination, make sure that you complete the following steps:
 
-- Enable the managed identity for the the application.
+- Enable the managed identity for the application.
 - Configure the permissions for the managed identity.
 - Configure any virtual networks, private endpoints, and firewall policies.