Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This article explains the supported versions, environments, and regions for Azure IoT Operations, along with its key dependencies and related resources. Use this guide to ensure compatibility and optimize your deployment. The guide also provides information about licensing for Azure IoT Operations.
Supported versions
Microsoft supports three generally available (GA) versions of Azure IoT Operations at any time: the latest version, and the two previous minor versions. Additionally, preview versions are available for testing new features.
Currently, Azure support is available for the following versions:
| Version | Type | Current patch release (YYMM) |
Current CLI version |
Release notes |
|---|---|---|---|---|
| 1.2.x | Preview | 1.2.72 (2509) | 2.0.0b3 (preview) | Release notes |
| 1.1.x | GA | 1.1.59 (2506) | 1.7.0 | Release notes |
| 1.0.x | GA | 1.0.34 (2503) | 1.3.0 | Release notes |
To learn about upgrades between versions, see Upgrade to a new version.
Important
Previous minor versions don't receive security patches. Upgrade to the latest version to get the latest security updates and features.
Warning
Don't use preview versions in production environments.
To verify your current version, go to the overview page for your Azure IoT Operations instance in the Azure portal or use the Azure IoT Operations CLI az iot ops instance show command.
Supported environments
Supported Windows environments
Microsoft supports the following Kubernetes distributions for Azure IoT Operations deployments on Windows. The table below details their support levels and the versions Microsoft uses to validate deployments:
| Kubernetes distribution | Architecture | Support level | Minimum validated version |
|---|---|---|---|
| AKS Edge Essentials | x86_64 | Public preview | AksEdge-K3s-1.29.6-1.8.202.0 |
| AKS on Azure Local | x86_64 | Public preview | Azure Stack HCI OS, version 23H2, build 2411 |
- The minimum validated version is the lowest version of the Kubernetes distribution that Microsoft uses to validate Azure IoT Operations deployments.
Supported Linux environments
Microsoft supports the following Kubernetes distributions for Azure IoT Operations deployments in Linux environments. The table below lists their support levels and the versions Microsoft uses to validate deployments:
| Kubernetes distribution | Architecture | Support level | Minimum validated version | Minimum validated OS |
|---|---|---|---|---|
| K3s | x86_64 | General availability | 1.31.1 | Ubuntu 24.04 |
| Tanzu Kubernetes release (TKr) | x86_64 | General availability | 1.28.11 | Tanzu Kubernetes Grid 2.5.2 |
- The minimum validated version is the lowest version of the Kubernetes distribution that Microsoft uses to validate Azure IoT Operations deployments.
- The minimum validated OS is the lowest operating system version that Microsoft uses to validate deployments.
Important
Support for Azure IoT Operations deployments is only available on version 1.28.11 of TKr.
Supported regions
Azure IoT Operations supports Arc-enabled clusters in these regions:
| Region | CLI value |
|---|---|
| East US | eastus |
| East US 2 | eastus2 |
| West US | westus |
| West US 2 | westus2 |
| West US 3 | westus3 |
| West Europe | westeurope |
| North Europe | northeurope |
| Germany West Central | germanywestcentral |
This list applies only to the region you use to connect your cluster to Azure Arc. It doesn't limit you from using your preferred Azure region for cloud resources. Azure IoT Operations components and other resources deployed to clusters in these regions connect to cloud resources in different regions.
Dependencies
Azure IoT Operations depends on these support services and features:
- Azure Device Registry
- Schema registry
- Azure Container Storage enabled by Azure Arc
- Azure Key Vault Secret Store extension
- Azure Monitor pipeline
- Workload identity federation in Azure Arc-enabled Kubernetes
Note
These features and services, used as dependencies by internal Azure IoT Operations systems, inherit general availability status from the Azure IoT Operations product license.
Note
For the Azure Device Registry and Schema registry capabilities, Azure IoT Operations is the only product under which these services are licensed for production use.
Licensing
Azure IoT Operations licensing is covered by the terms stated in the Microsoft Online Service Agreement (MOSA). Licensing that's specific to Azure IoT Operations can be found in the Service Specific Terms section of the MOSA.
If any of the licensing terms found in these documents block your adoption of Azure IoT Operations in trial, non-production, or production scenarios, contact azureiotoperationslicensinghelp@microsoft.com. Depending on your specific circumstances, there might be solutions to unblock your project.