Add amlfs expansion module and CRUD scenario tests (#9751)

* Add amlfs expansion module and CRUD scenario tests

Add expansion job commands (create, delete, list, show, update, wait) for
Azure Managed Lustre Filesystem storage capacity expansion using API version
2026-01-01. Include full CRUD scenario test with NAT gateway setup for
private subnet compliance.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address PR review comments on test_expansion_job.py

- Add 'az' prefix to helper method self.cmd() calls
- Rewrite wait helpers to assert on failure/timeout with descriptive messages
- Use order-independent JMESPath filter for list assertions

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Add NAT gateway subnet setup to import/auto-export/auto-import tests

Add the same private subnet with NAT gateway configuration used in
expansion job tests to the import, auto-export, and auto-import test
files for policy compliance with default outbound access restrictions.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Add NAT gateway subnet setup to test_amlfs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Re-record test cassettes with NAT gateway subnet setup

Update VCR recordings for test_amlfs, test_import_job_crud,
test_auto_export_job_crud, and test_auto_import_job_crud to reflect
the NAT gateway subnet configuration changes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Aman Jain <amajai@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: 3 people

src/amlfs/HISTORY.rst

@@ -3,6 +3,10 @@
 Release History
 ===============
 
+1.3.0
++++++
+Added: az amlfs expansion create/update/list/show/delete commands for managing AMLFS expansion jobs. This helps the user manage the storage capacity expansion of their AMLFS instance as their data grows.
+
 1.2.0
 +++++
 Added: az amlfs auto-import create/update/list/show/delete commands for automatically importing data from Blob Storage to AMLFS

src/amlfs/azext_amlfs/aaz/latest/amlfs/expansion/__cmd_group.py

@@ -0,0 +1,23 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+
+from azure.cli.core.aaz import *
+
+
+@register_command_group(
+    "amlfs expansion",
+)
+class __CMDGroup(AAZCommandGroup):
+    """Manage Expansion
+    """
+    pass
+
+
+__all__ = ["__CMDGroup"]

src/amlfs/azext_amlfs/aaz/latest/amlfs/expansion/__init__.py

@@ -0,0 +1,17 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+
+from .__cmd_group import *
+from ._create import *
+from ._delete import *
+from ._list import *
+from ._show import *
+from ._update import *
+from ._wait import *

src/amlfs/azext_amlfs/aaz/latest/amlfs/expansion/_create.py

@@ -0,0 +1,332 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+
+from azure.cli.core.aaz import *
+
+
+@register_command(
+    "amlfs expansion create",
+)
+class Create(AAZCommand):
+    """Increase filesystem storage capacity.
+
+    :example: expansionJobs_CreateOrUpdate
+        az amlfs expansion create --resource-group scgroup --aml-filesystem-name fs1 --expansion-job-name expansionjob1 --tags "{Dept:ContosoAds}" --location eastus --new-storage-capacity 16.0
+    """
+
+    _aaz_info = {
+        "version": "2026-01-01",
+        "resources": [
+            ["mgmt-plane", "/subscriptions/{}/resourcegroups/{}/providers/microsoft.storagecache/amlfilesystems/{}/expansionjobs/{}", "2026-01-01"],
+        ]
+    }
+
+    AZ_SUPPORT_NO_WAIT = True
+
+    def _handler(self, command_args):
+        super()._handler(command_args)
+        return self.build_lro_poller(self._execute_operations, self._output)
+
+    _args_schema = None
+
+    @classmethod
+    def _build_arguments_schema(cls, *args, **kwargs):
+        if cls._args_schema is not None:
+            return cls._args_schema
+        cls._args_schema = super()._build_arguments_schema(*args, **kwargs)
+
+        # define Arg Group ""
+
+        _args_schema = cls._args_schema
+        _args_schema.aml_filesystem_name = AAZStrArg(
+            options=["--aml-filesystem-name"],
+            help="Name for the AML file system. Allows alphanumerics, underscores, and hyphens. Start and end with alphanumeric.",
+            required=True,
+            fmt=AAZStrArgFormat(
+                pattern="^[0-9a-zA-Z][-0-9a-zA-Z_]{0,78}[0-9a-zA-Z]$",
+                max_length=80,
+                min_length=2,
+            ),
+        )
+        _args_schema.expansion_job_name = AAZStrArg(
+            options=["-n", "--name", "--expansion-job-name"],
+            help="Name for the expansion job. Allows alphanumerics, underscores, and hyphens. Start and end with alphanumeric.",
+            required=True,
+            fmt=AAZStrArgFormat(
+                pattern="^[0-9a-zA-Z][-0-9a-zA-Z_]{0,78}[0-9a-zA-Z]$",
+                max_length=80,
+                min_length=2,
+            ),
+        )
+        _args_schema.resource_group = AAZResourceGroupNameArg(
+            required=True,
+        )
+
+        # define Arg Group "ExpansionJob"
+
+        _args_schema = cls._args_schema
+        _args_schema.location = AAZResourceLocationArg(
+            arg_group="ExpansionJob",
+            help="The geo-location where the resource lives",
+            required=True,
+            fmt=AAZResourceLocationArgFormat(
+                resource_group_arg="resource_group",
+            ),
+        )
+        _args_schema.tags = AAZDictArg(
+            options=["--tags"],
+            arg_group="ExpansionJob",
+            help="Resource tags.",
+        )
+
+        tags = cls._args_schema.tags
+        tags.Element = AAZStrArg()
+
+        # define Arg Group "Properties"
+
+        _args_schema = cls._args_schema
+        _args_schema.new_storage_capacity = AAZFloatArg(
+            options=["--size", "--new-storage-capacity"],
+            arg_group="Properties",
+            help="The new storage capacity in TiB for the AML file system after expansion. This must be a multiple of the Sku step size, and greater than the current storage capacity of the AML file system.",
+        )
+        return cls._args_schema
+
+    def _execute_operations(self):
+        self.pre_operations()
+        yield self.ExpansionJobsCreateOrUpdate(ctx=self.ctx)()
+        self.post_operations()
+
+    @register_callback
+    def pre_operations(self):
+        pass
+
+    @register_callback
+    def post_operations(self):
+        pass
+
+    def _output(self, *args, **kwargs):
+        result = self.deserialize_output(self.ctx.vars.instance, client_flatten=True)
+        return result
+
+    class ExpansionJobsCreateOrUpdate(AAZHttpOperation):
+        CLIENT_TYPE = "MgmtClient"
+
+        def __call__(self, *args, **kwargs):
+            request = self.make_request()
+            session = self.client.send_request(request=request, stream=False, **kwargs)
+            if session.http_response.status_code in [202]:
+                return self.client.build_lro_polling(
+                    self.ctx.args.no_wait,
+                    session,
+                    self.on_200_201,
+                    self.on_error,
+                    lro_options={"final-state-via": "azure-async-operation"},
+                    path_format_arguments=self.url_parameters,
+                )
+            if session.http_response.status_code in [200, 201]:
+                return self.client.build_lro_polling(
+                    self.ctx.args.no_wait,
+                    session,
+                    self.on_200_201,
+                    self.on_error,
+                    lro_options={"final-state-via": "azure-async-operation"},
+                    path_format_arguments=self.url_parameters,
+                )
+
+            return self.on_error(session.http_response)
+
+        @property
+        def url(self):
+            return self.client.format_url(
+                "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}/expansionJobs/{expansionJobName}",
+                **self.url_parameters
+            )
+
+        @property
+        def method(self):
+            return "PUT"
+
+        @property
+        def error_format(self):
+            return "MgmtErrorFormat"
+
+        @property
+        def url_parameters(self):
+            parameters = {
+                **self.serialize_url_param(
+                    "amlFilesystemName", self.ctx.args.aml_filesystem_name,
+                    required=True,
+                ),
+                **self.serialize_url_param(
+                    "expansionJobName", self.ctx.args.expansion_job_name,
+                    required=True,
+                ),
+                **self.serialize_url_param(
+                    "resourceGroupName", self.ctx.args.resource_group,
+                    required=True,
+                ),
+                **self.serialize_url_param(
+                    "subscriptionId", self.ctx.subscription_id,
+                    required=True,
+                ),
+            }
+            return parameters
+
+        @property
+        def query_parameters(self):
+            parameters = {
+                **self.serialize_query_param(
+                    "api-version", "2026-01-01",
+                    required=True,
+                ),
+            }
+            return parameters
+
+        @property
+        def header_parameters(self):
+            parameters = {
+                **self.serialize_header_param(
+                    "Content-Type", "application/json",
+                ),
+                **self.serialize_header_param(
+                    "Accept", "application/json",
+                ),
+            }
+            return parameters
+
+        @property
+        def content(self):
+            _content_value, _builder = self.new_content_builder(
+                self.ctx.args,
+                typ=AAZObjectType,
+                typ_kwargs={"flags": {"required": True, "client_flatten": True}}
+            )
+            _builder.set_prop("location", AAZStrType, ".location", typ_kwargs={"flags": {"required": True}})
+            _builder.set_prop("properties", AAZObjectType, typ_kwargs={"flags": {"client_flatten": True}})
+            _builder.set_prop("tags", AAZDictType, ".tags")
+
+            properties = _builder.get(".properties")
+            if properties is not None:
+                properties.set_prop("newStorageCapacityTiB", AAZFloatType, ".new_storage_capacity")
+
+            tags = _builder.get(".tags")
+            if tags is not None:
+                tags.set_elements(AAZStrType, ".")
+
+            return self.serialize_content(_content_value)
+
+        def on_200_201(self, session):
+            data = self.deserialize_http_content(session)
+            self.ctx.set_var(
+                "instance",
+                data,
+                schema_builder=self._build_schema_on_200_201
+            )
+
+        _schema_on_200_201 = None
+
+        @classmethod
+        def _build_schema_on_200_201(cls):
+            if cls._schema_on_200_201 is not None:
+                return cls._schema_on_200_201
+
+            cls._schema_on_200_201 = AAZObjectType()
+
+            _schema_on_200_201 = cls._schema_on_200_201
+            _schema_on_200_201.id = AAZStrType(
+                flags={"read_only": True},
+            )
+            _schema_on_200_201.location = AAZStrType(
+                flags={"required": True},
+            )
+            _schema_on_200_201.name = AAZStrType(
+                flags={"read_only": True},
+            )
+            _schema_on_200_201.properties = AAZObjectType(
+                flags={"client_flatten": True},
+            )
+            _schema_on_200_201.system_data = AAZObjectType(
+                serialized_name="systemData",
+                flags={"read_only": True},
+            )
+            _schema_on_200_201.tags = AAZDictType()
+            _schema_on_200_201.type = AAZStrType(
+                flags={"read_only": True},
+            )
+
+            properties = cls._schema_on_200_201.properties
+            properties.new_storage_capacity_ti_b = AAZFloatType(
+                serialized_name="newStorageCapacityTiB",
+            )
+            properties.provisioning_state = AAZStrType(
+                serialized_name="provisioningState",
+                flags={"read_only": True},
+            )
+            properties.status = AAZObjectType(
+                flags={"client_flatten": True, "read_only": True},
+            )
+
+            status = cls._schema_on_200_201.properties.status
+            status.completion_time_utc = AAZStrType(
+                serialized_name="completionTimeUTC",
+                flags={"read_only": True},
+            )
+            status.percent_complete = AAZFloatType(
+                serialized_name="percentComplete",
+                flags={"read_only": True},
+            )
+            status.start_time_utc = AAZStrType(
+                serialized_name="startTimeUTC",
+                flags={"read_only": True},
+            )
+            status.state = AAZStrType(
+                flags={"read_only": True},
+            )
+            status.status_code = AAZStrType(
+                serialized_name="statusCode",
+                flags={"read_only": True},
+            )
+            status.status_message = AAZStrType(
+                serialized_name="statusMessage",
+                flags={"read_only": True},
+            )
+
+            system_data = cls._schema_on_200_201.system_data
+            system_data.created_at = AAZStrType(
+                serialized_name="createdAt",
+            )
+            system_data.created_by = AAZStrType(
+                serialized_name="createdBy",
+            )
+            system_data.created_by_type = AAZStrType(
+                serialized_name="createdByType",
+            )
+            system_data.last_modified_at = AAZStrType(
+                serialized_name="lastModifiedAt",
+            )
+            system_data.last_modified_by = AAZStrType(
+                serialized_name="lastModifiedBy",
+            )
+            system_data.last_modified_by_type = AAZStrType(
+                serialized_name="lastModifiedByType",
+            )
+
+            tags = cls._schema_on_200_201.tags
+            tags.Element = AAZStrType()
+
+            return cls._schema_on_200_201
+
+
+class _CreateHelper:
+    """Helper class for Create"""
+
+
+__all__ = ["Create"]