su

Author: HangyiWang

HISTORY.rst

@@ -7,7 +7,7 @@ Release History
 
 **General updates**
 
-* Updated all ``az iot adr ns`` commands to the ``Microsoft.DeviceRegistry/2026-11-02-preview`` management API.
+* Updated all ``az iot adr ns`` commands to the ``Microsoft.DeviceRegistry/2026-11-02-preview`` management API and marked the complete command tree as preview.
 * Regenerated the complete synchronous and asynchronous Device Registry SDK from the ``package-preview-2026-11-02`` specification tag. The generated clients expose all 25 operation groups and 118 operations in the source specification.
 * Generated a dedicated synchronous and asynchronous Device Update control-plane SDK from the ``package-2026-11-02-preview`` DuDeviceRegistry specification tag without replacing the existing ``az iot du`` SDK.
 * Added safer long-running-operation handling: resource mutations poll ``provisioningState`` and POST actions poll the authenticated ``Location`` URL instead of the service's unsupported ``Azure-AsyncOperation`` host.
@@ -29,7 +29,9 @@ Release History
   - Added ``az iot adr ns su instance check-name / create / show / list / update / delete / wait`` for ``Microsoft.DeviceUpdate/updateInstances`` resources.
   - Update Instance create and update support tags plus complete system- and user-assigned managed identity configuration. List supports resource-group and subscription scopes.
   - Namespace updating endpoints remain under ``az iot adr ns link su add / show / list / update / wait``, consistent with the existing Hub and DPS link groups.
-  - Software Updates data-plane commands and the service-internal ``linkPreflight``, ``linkInitiate``, ``linkNotify``, and ``linkUpdate`` actions are intentionally not exposed.
+  - Added ``az iot adr ns su update import / list / show / delete``, ``su update file list / show``, local ``su update calculate-hash`` and ``su update init v5``, and ``su device-class list / show / delete`` using the linked namespace's Software Updates data-plane endpoint.
+  - Added ``az iot adr ns device show`` as the Software Updates workflow alias for ``registry-device show``.
+  - Device-class update remains unavailable because ``2026-11-02-preview`` exposes no update route or writable friendly-name property. The service-internal ``linkPreflight``, ``linkInitiate``, ``linkNotify``, and ``linkUpdate`` actions remain intentionally hidden.
 
 * **Namespace parity**
 

azext_iot/_factory.py

@@ -34,6 +34,7 @@
     "iot_service_provisioning_factory",
     "adr_service_factory",
     "adr_su_service_factory",
+    "adr_su_data_service_factory",
 ]
 
 
@@ -164,6 +165,17 @@ def adr_su_service_factory(cli_ctx, *_):
     )
 
 
+def adr_su_data_service_factory(cli_ctx, *_):
+    """Create the Software Updates data-plane client."""
+    from azext_iot.sdk.deviceupdate.duregistrydata import DeviceRegistryUpdateClient
+
+    return DeviceRegistryUpdateClient(
+        credential=AZURE_CLI_CREDENTIAL,
+        user_agent_policy=UserAgentPolicy(user_agent=USER_AGENT),
+        http_logging_policy=_get_default_logging_policy(),
+    )
+
+
 def resource_service_factory(cli_ctx, **_):
     from azure.cli.core.commands.client_factory import get_mgmt_service_client
     from azure.cli.core.profiles import ResourceType

azext_iot/adr/_help.py

@@ -547,8 +547,8 @@ def load_adr_help():
   short-summary: Manage Software Updates for Device Registry namespaces.
   long-summary: |
     Manages the Update Instance (Microsoft.DeviceUpdate/updateInstances) that powers
-    Software Updates. Namespace links remain under 'az iot adr ns link su'.
-    Software Updates data-plane operations are not part of this command group.
+    Software Updates and the updates and device classes available through a linked
+    Device Registry namespace. Namespace links remain under 'az iot adr ns link su'.
   """
 
     helps[
@@ -642,6 +642,158 @@ def load_adr_help():
       text: az iot adr ns su instance wait -n myUpdateInstance -g myResourceGroup --custom "properties.provisioningState=='Succeeded'"
   """
 
+    helps["iot adr ns device"] = """
+  type: group
+  short-summary: View Device Registry device identity information.
+  """
+
+    helps["iot adr ns device show"] = """
+  type: command
+  short-summary: Show a device identity in a Device Registry namespace.
+  long-summary: |
+    This Software Updates workflow alias returns the same Registry Device
+    resource as 'az iot adr ns registry-device show'.
+  examples:
+    - name: Show a device identity
+      text: az iot adr ns device show -n myDevice --ns myNamespace -g myResourceGroup
+  """
+
+    helps["iot adr ns su update"] = """
+  type: group
+  short-summary: Import and manage Software Updates content.
+  long-summary: |
+    Uses the data-plane serviceAddress materialized on the namespace's Software
+    Updates link. The link must finish provisioning before these commands can run.
+  """
+
+    helps["iot adr ns su update import"] = """
+  type: command
+  short-summary: Import an update into Software Updates.
+  long-summary: |
+    Imports a v5 manifest from a read-accessible URL. When --size or --hashes is
+    omitted, the CLI streams the manifest to calculate its size and SHA-256 hash.
+  examples:
+    - name: Import a manifest and one payload file
+      text: |
+        az iot adr ns su update import --ns myNamespace -g myResourceGroup \\
+          --url "https://storage.example/manifest.json?<sas>" \\
+          --file filename=payload.bin url="https://storage.example/payload.bin?<sas>"
+  """
+
+    helps["iot adr ns su update list"] = """
+  type: command
+  short-summary: List updates imported into Software Updates.
+  examples:
+    - name: List all imported updates
+      text: az iot adr ns su update list --ns myNamespace -g myResourceGroup
+    - name: List deployable updates
+      text: az iot adr ns su update list --ns myNamespace -g myResourceGroup --filter "isDeployable eq true"
+  """
+
+    helps["iot adr ns su update show"] = """
+  type: command
+  short-summary: Show an imported update.
+  examples:
+    - name: Show an update version
+      text: |
+        az iot adr ns su update show --ns myNamespace -g myResourceGroup \\
+          --update-provider Contoso --update-name Thermostat --update-version 1.0
+  """
+
+    helps["iot adr ns su update delete"] = """
+  type: command
+  short-summary: Delete an imported update.
+  examples:
+    - name: Delete an update version without prompting
+      text: |
+        az iot adr ns su update delete --ns myNamespace -g myResourceGroup \\
+          --update-provider Contoso --update-name Thermostat --update-version 1.0 --yes
+  """
+
+    helps["iot adr ns su update calculate-hash"] = """
+  type: command
+  short-summary: Calculate update-file hashes locally.
+  examples:
+    - name: Calculate a SHA-256 hash
+      text: az iot adr ns su update calculate-hash --file-path ./payload.bin
+  """
+
+    helps["iot adr ns su update file"] = """
+  type: group
+  short-summary: Inspect files belonging to an imported update.
+  """
+
+    helps["iot adr ns su update file list"] = """
+  type: command
+  short-summary: List file identifiers for an imported update.
+  examples:
+    - name: List files
+      text: |
+        az iot adr ns su update file list --ns myNamespace -g myResourceGroup \\
+          --update-provider Contoso --update-name Thermostat --update-version 1.0
+  """
+
+    helps["iot adr ns su update file show"] = """
+  type: command
+  short-summary: Show an imported update file.
+  examples:
+    - name: Show a file
+      text: |
+        az iot adr ns su update file show --ns myNamespace -g myResourceGroup \\
+          --update-provider Contoso --update-name Thermostat --update-version 1.0 \\
+          --update-file-id payload
+  """
+
+    helps["iot adr ns su update init"] = """
+  type: group
+  short-summary: Create Software Updates import manifests locally.
+  """
+
+    helps["iot adr ns su update init v5"] = """
+  type: command
+  short-summary: Create a version 5 import manifest.
+  examples:
+    - name: Create a simple manifest
+      text: |
+        az iot adr ns su update init v5 --update-provider Contoso \\
+          --update-name Thermostat --update-version 1.0 \\
+          --compat manufacturer=Contoso model=T1000 \\
+          --step handler=microsoft/script:1 --file path=./install.sh
+  """
+
+    helps["iot adr ns su device-class"] = """
+  type: group
+  short-summary: View and delete Software Updates device classes.
+  """
+
+    helps["iot adr ns su device-class list"] = """
+  type: command
+  short-summary: List device classes in a linked Software Updates instance.
+  examples:
+    - name: List device classes
+      text: az iot adr ns su device-class list --ns myNamespace -g myResourceGroup
+  """
+
+    helps["iot adr ns su device-class show"] = """
+  type: command
+  short-summary: Show a Software Updates device class.
+  examples:
+    - name: Show a device class
+      text: |
+        az iot adr ns su device-class show --ns myNamespace -g myResourceGroup \\
+          --device-class-id 0123456789abcdef
+  """
+
+    helps["iot adr ns su device-class delete"] = """
+  type: command
+  short-summary: Delete a Software Updates device class.
+  examples:
+    - name: Delete a device class without prompting
+      text: |
+        az iot adr ns su device-class delete --ns myNamespace -g myResourceGroup \\
+          --device-class-id 0123456789abcdef --yes
+  """
+
     helps[
         "iot adr ns link add"
     ] = """