new version of networkcloud cli

Author: Nafiz Haider

src/networkcloud/HISTORY.rst

@@ -3,6 +3,22 @@
 Release History
 ===============
 
+4.0.0b1
+++++++++
+* This beta version supports NetworkCloud 2025-07-01-preview APIs.
+* New run-data-extract-restricted command is added for Bare metal machine.
+* New run-data-read command is added for Storage appliance.
+* New assign-relay command is added for Virtual machine.
+* 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 update support added for the command output settings override to define command specific containers.
+* Bare metal machine key set create command is updated to allow for non-standard privilege setting.
+* Virtual machine 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.70 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 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.
@@ -12,7 +28,7 @@ Release History
 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.
@@ -31,7 +47,7 @@ Release History
 
 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.

src/networkcloud/README.md

@@ -1,6 +1,6 @@
-# Azure CLI AFOI-Network Cloud Extension #
+# Microsoft Azure CLI 'networkcloud' Extension #
 
-This is an extension to Azure CLI to manage Azure Operator Nexus - Network Cloud on-premises clusters and their resources, such as racks, bare metal hosts, virtual machines, workload networks and more.
+This is an extension to Azure CLI to manage Microsoft.NetworkCloud on-premises clusters and their resources, such as racks, bare metal hosts, virtual machines, workload networks and more.
 
 ## How to use ##
 

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)