Network Cloud Preview Version 4.0.0b1 for 2025-07-01-preview

src/networkcloud/HISTORY.rst

@@ -3,21 +3,37 @@
 Release History
 ===============
 
+4.0.0b1
+++++++++
+* This beta version supports NetworkCloud 2025-07-01-preview APIs.
+* New `run-data-extract-restricted` command is added for `baremetalmachine`.
+* New `run-data-read` command is added for `storageappliance`.
+* New `assign-relay` command is added for `virtualmachine`.
+* Cluster Manager can now be created with a user defined SKU and availability zones. Only a limited set of SKUs is supported and at least 2 availability zones are required.
+* Cluster service principal properties are deprecated in favor of Managed Identity.
+* `cluster create` and `cluster update` support added for the command output settings override to define command specific containers.
+* `cluster baremetalmachinekeyset create` command is updated to allow for non-standard privilege setting.
+* `virtualmachine create` command is updated to support `user-data-content` and `network-data-content` parameters, which are treated as secrets. These parameters should be used instead of now deprecated `user-data` and `network-data`, which store and return information in a clear text.
+* `volume create` command is updated to support allocation at the desired storage appliance.
+* All `list` commands are updated to support the `--top` parameter, which allows limiting the number of items returned in the API response. When provided, the CLI will retrieve the max of `--top` results at a time and iterate over the paginated response using `nextLink` until all retrieved.
+* This version requires a minimum of 2.75 Azure core CLI. See release notes for more details: https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/docs-ref-conceptual/Latest-version/release-notes-azure-cli.md
+* This version upgrades the internal generation tool aaz-dev-tools to 4.2.0. Refer to the release notes for more details: https://github.com/Azure/aaz-dev-tools/releases/tag/v4.2.0.
+
 3.0.0
 ++++++++
 * This stable version supports NetworkCloud 2025-02-01 APIs.
-* Concurency control parameters have been introduced and include `ETag` property on resources and the ability to pass it via `--if-match` or `--if-none-match` parameters to create and update commands.
-* Alias `--mrg` is added to the `--managed-resource-group-configuration` parameter of the Cluster and Cluster Manager create commands for convenience.
+* Concurency control parameters have been introduced and include `ETag` property on resources and the ability to pass it via `--if-match` or `--if-none-match` parameters to `create` and `update` commands.
+* Alias `--mrg` is added to the `--managed-resource-group-configuration` parameter of the `cluster create` and `clustermanager create` commands for convenience.
 
 3.0.0b1
 ++++++++
 * This beta version supports NetworkCloud 2024-10-01-preview APIs.
-* This version requires a minimum of 2.67 Azure core CLI. See release notes for more details: https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/docs-ref-conceptual/Latest-version/release-notes-azure-cli.md
+* This version requires a minimum of 2.67 Azure core CLI. See release notes for more details: https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/docs-ref-conceptual/release-notes-azure-cli.md
 * This version upgrades the internal generation tool aaz-dev-tools to 3.2.0. Refer to the release notes for more details: https://github.com/Azure/aaz-dev-tools/releases/tag/v3.2.0.
-* A bug fix for delete commands returning 204 without content is included in this release.
-* New `identity` command group is added to Cluster Manager for handling system-assigned and user-assigned identity updates.
-* Breaking change: Cluster create and update commands support new parameter `--analytics-output-settings` for configuring Log Analytics Workspace, which replaces the deprecated `--analytics-workspace-id`.
-* Breaking change: Cluster create and update commands support new parameter `--secret-archive-settings` to hold credentials for the cluster, which replaces the deprecated `--secret-archive`.
+* A bug fix for `delete` commands returning 204 without content is included in this release.
+* New `identity` command group is added to `clustermanager` for handling system-assigned and user-assigned identity updates.
+* Breaking change: `cluster create` and `cluster update` commands support new parameter `--analytics-output-settings` for configuring Log Analytics Workspace, which replaces the deprecated `--analytics-workspace-id`.
+* Breaking change: `cluster create` and `cluster update` commands support new parameter `--secret-archive-settings` to hold credentials for the Cluster, which replaces the deprecated `--secret-archive`.
 * Cluster includes `--vulnerability-scanning-settings`, featuring a single field called containerScan, which determines how security vulnerability scanning is applied to the cluster.
 * VirtualMachine is updated to display the extended location to use for creation of a VirtualMachine console resource.
 * VirtualMachine is updated to support persistent storage for OS disk.
@@ -27,11 +43,11 @@ Release History
 2.0.0
 ++++++++
 * This is the stable version of the CLI extension that supports NetworkCloud 2024-07-01 APIs.
-* Additional validation is added to Cluster create and update commands for the containerUrl child property within the `--command-output-settings`.
+* Additional validation is added to `cluater create` and `cluster update` commands for the containerUrl child property within the `--command-output-settings`.
 
 2.0.0b7
 ++++++++
-* This version requires a minimum of 2.66 Azure core CLI. See release notes for more details: https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/docs-ref-conceptual/Latest-version/release-notes-azure-cli.md
+* This version requires a minimum of 2.66 Azure core CLI. See release notes for more details: https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/docs-ref-conceptual/release-notes-azure-cli.md
 * This version upgrades the internal generation tool aaz-dev-tools to 3.1.0. Refer to the release notes for more details: https://github.com/Azure/aaz-dev-tools/releases/tag/v3.1.0.
 * Optional Cluster properties can be now set to null during update (PATCH) operation. This includes `--cluster-service-principal`, `--command-output-settings`, `--compute-deployment-threshold`, `--update-strategy`, `--secret-archive`, and `--runtime-protection`. In that case, the value will be reset to the default if defined by the API.
 * This version introduces custom code to validate the `--command-output-settings` property of a cluster for both create and update operations. When the `identity-type` is `SystemAssignedIdentity`, the UAI(User Assigned Identity) should not be provided and will be set to None to erase any previous value. When the `identity-type` is `UserAssignedIdentity`, the UAI must be provided.
@@ -42,7 +58,7 @@ Release History
 
 2.0.0b5
 ++++++++
-* This version updates the baremetalmachine resource commands (run-command, run-read-command, and run-data-extract) to utilize a customer-provided Storage Account for storing command execution results.
+* This version updates the `baremetalmachine` resource commands (`run-command`, `run-read-command`, and `run-data-extract`) to utilize a customer-provided Storage Account for storing command execution results.
 
 2.0.0b4
 ++++++++
@@ -53,59 +69,59 @@ Release History
 * This beta version supports NetworkCloud 2024-06-01-preview APIs.
 * Note is added regarding Virtual machine memory and disk size being in gibibytes. Avoid using property names `--memory-size-gb` and `--disk-size-gb`.
 * New functionality supported in this release:
-  * ClusterManager commands are updated with custom parameters --mi-system-assigned --mi-user-assigned to support managing identity.
-  * Cluster commands are updated with custom parameters --mi-system-assigned --mi-user-assigned to support managing identity.
-  * Cluster can now configure a storage account that will be used for downloading BareMetalMachine command execution results.
+  * `clustermanager` commands are updated with custom parameters `--mi-system-assigned` and `--mi-user-assigned` to support managing identity.
+  * `cluster` commands are updated with custom parameters `--mi-system-assigned` and `--mi-user-assigned` to support managing identity.
+  * Cluster can now configure a storage account that will be used for downloading `baremetalmachine` command execution results.
   * Cluster rack pause functionality support is added with the new command `continue-update-version`.
-  * KubernetesCluster feature commands are added to manage addons for the Kubernetes cluster.
-  * BareMetalMachines and StorageAppliance are updated with new properties for secret rotation status.
-  * KubernetesClusters commands are enhanced to support an alternative load balancer configuration that represents an L2 load balancer in property `l2ServiceLoadBalancerConfiguration`.
-  * KubernetesClusters commands are enhanced to support additional upgrade settings `drainTimeout` and `maxUnavailable` for initial agent pools.
-  * KubernetesClusters agentpool commands are enhanced to support additional upgrade settings `drainTimeout` and `maxUnavailable`.
+  * `kubernetescluster feature` commands are added to manage addons for the Kubernetes cluster.
+  * `baremetalmachines` and `storageappliance` are updated with new properties for secret rotation status.
+  * `kubernetescluster` commands are enhanced to support an alternative load balancer configuration that represents an L2 load balancer in property `l2ServiceLoadBalancerConfiguration`.
+  * `kubernetescluster` commands are enhanced to support additional upgrade settings `drainTimeout` and `maxUnavailable` for initial agent pools.
+  * `kubernetescluster agentpool` commands are enhanced to support additional upgrade settings `drainTimeout` and `maxUnavailable`.
 * This version requires a minimum of 2.61 Azure core CLI.
 
 2.0.0b2
 ++++++++
-* Examples updated to include new property user-principal-name for baremetalmachinekeyset and bmckeyset create and update commands.
+* Examples updated to include new property `user-principal-name` for `baremetalmachinekeyset` and bmckeyset create and update commands.
 
 2.0.0b1
 ++++++++
 * This beta version supports NetworkCloud 2023-10-01-preview APIs.
 * Format restrictions and resource type validations are added to fields that represent ARM ID resources.
 * New functionality supported in this release:
-  * New configuration is added to cluster create and update commands for runtime protection scan, secret archive, and cluster update strategy.
-  * New Cluster command scan-runtime is added to trigger the execution of a runtime protection scan.
-  * baremetalmachine returns new properties with runtime protection status.
+  * New configuration is added to `cluster create` and `cluster update` commands for runtime protection scan, secret archive, and cluster update strategy.
+  * New `scan-runtime` command is added to `cluster` to trigger the execution of a runtime protection scan.
+  * `baremetalmachine` returns new properties with runtime protection status.
   * Additional status "Disconnected" is added to clusterConnectionStatus.
-  * kubernetescluster update command allows modification of SSH keys for cluster administrator and control plane administrator.
-  * kubernetescluster agentpool update command allows modification of SSH keys for the agent pool administrator.
+  * `kubernetescluster update` command allows modification of SSH keys for cluster administrator and control plane administrator.
+  * `kubernetescluster agentpool update` command allows modification of SSH keys for the agent pool administrator.
 * This version requires a minimum of 2.51 Azure core CLI.
 * This version upgrades the internal generation tool aaz-dev-tools to 1.8.0. Refer to the release notes for more details: https://github.com/Azure/aaz-dev-tools/releases/tag/v1.8.0.
 
 1.1.0
 ++++++++
-* This version removes the experimental commands for defaultcninetwork and hybridakscluster as these resources are no longer available.
+* This version removes the experimental commands for `defaultcninetwork` and `hybridakscluster` as these resources are no longer available.
 
 1.0.0
 ++++++++
 * This is the first stable version of the CLI extension that supports NetworkCloud 2023-07-01 stable APIs.
-* Virtualmachine console create and update commands have been enhanced to accept a file path for ssh_public_key parameter.
+* Commands `create` and `update` on `virtualmachine console` have been enhanced to accept a file path for `ssh_public_key` parameter.
 
 1.0.0b1
 ++++++++
 * This is first beta version of the CLI extension that supports NetworkCloud 2023-07-01 stable APIs.
-* The defaultcninetwork and hybridakscluster resources are no longer available.
+* The `defaultcninetwor`k and `hybridakscluster` resources are no longer available.
 
 0.4.1
 ++++++
-* This version updates the kubernetescluster resource to not send an empty array `sshPubKeys` for control plane configuration and agent pool configuration if the input contains no ssh keys provided for these parameters.
-* This version updates the agentpool child resource of kubernetescluster to not send an empty array `sshPubKeys` is not provided in the input.
+* This version updates the `kubernetescluster` resource to not send an empty array `sshPubKeys` for control plane configuration and agent pool configuration if the input contains no ssh keys provided for these parameters.
+* This version updates the `agentpool` child resource of `kubernetescluster` to not send an empty array `sshPubKeys` is not provided in the input.
 
 0.4.0
 ++++++
 * This version supports NetworkCloud 2023-05-01-preview APIs.
-* It introduces a new resource kubernetescluster and its child resource agentpool.
-* The defaultcninetwork and hybridakscluster resources are preserved and will continue using 2022-12-12-preview APIs.
+* It introduces a new resource `kubernetescluster` and its child resource `agentpool`.
+* The `defaultcninetwork` and `hybridakscluster` resources are preserved and will continue using 2022-12-12-preview APIs.
 * This version is experimental. Changes to the interface are expected but will be done in backward compatible way where possible.
 
 0.3.0

src/networkcloud/azext_networkcloud/aaz/latest/networkcloud/__cmd_group.py

@@ -13,6 +13,7 @@
 
 @register_command_group(
     "networkcloud",
+    is_preview=True,
 )
 class __CMDGroup(AAZCommandGroup):
     """Manage Network Cloud resources

src/networkcloud/azext_networkcloud/aaz/latest/networkcloud/baremetalmachine/__cmd_group.py

@@ -13,6 +13,7 @@
 
 @register_command_group(
     "networkcloud baremetalmachine",
+    is_preview=True,
 )
 class __CMDGroup(AAZCommandGroup):
     """Manage bare metal machine

src/networkcloud/azext_networkcloud/aaz/latest/networkcloud/baremetalmachine/__init__.py

@@ -17,6 +17,7 @@
 from ._restart import *
 from ._run_command import *
 from ._run_data_extract import *
+from ._run_data_extracts_restricted import *
 from ._run_read_command import *
 from ._show import *
 from ._start import *

src/networkcloud/azext_networkcloud/aaz/latest/networkcloud/baremetalmachine/_cordon.py

@@ -13,6 +13,7 @@
 
 @register_command(
     "networkcloud baremetalmachine cordon",
+    is_preview=True,
 )
 class Cordon(AAZCommand):
     """Cordon the provided bare metal machine's Kubernetes node.
@@ -22,9 +23,9 @@ class Cordon(AAZCommand):
     """
 
     _aaz_info = {
-        "version": "2025-02-01",
+        "version": "2025-07-01-preview",
         "resources": [
-            ["mgmt-plane", "/subscriptions/{}/resourcegroups/{}/providers/microsoft.networkcloud/baremetalmachines/{}/cordon", "2025-02-01"],
+            ["mgmt-plane", "/subscriptions/{}/resourcegroups/{}/providers/microsoft.networkcloud/baremetalmachines/{}/cordon", "2025-07-01-preview"],
         ]
     }
 
@@ -151,7 +152,7 @@ def url_parameters(self):
         def query_parameters(self):
             parameters = {
                 **self.serialize_query_param(
-                    "api-version", "2025-02-01",
+                    "api-version", "2025-07-01-preview",
                     required=True,
                 ),
             }
@@ -242,13 +243,16 @@ def _build_schema_error_detail_read(cls, _schema):
         additional_info.Element = AAZObjectType()
 
         _element = _schema_error_detail_read.additional_info.Element
-        _element.info = AAZFreeFormDictType(
+        _element.info = AAZDictType(
             flags={"read_only": True},
         )
         _element.type = AAZStrType(
             flags={"read_only": True},
         )
 
+        info = _schema_error_detail_read.additional_info.Element.info
+        info.Element = AAZAnyType()
+
         details = _schema_error_detail_read.details
         details.Element = AAZObjectType()
         cls._build_schema_error_detail_read(details.Element)