[Storage-mover]: GA

.github/CODEOWNERS

@@ -274,4 +274,6 @@
 
 /src/voice-service/ @jsntcy
 
-/src/confcom/ @BryceDFisher @SethHollandsworth @hgarvison @stevendongatmsft
+/src/confcom/ @BryceDFisher @SethHollandsworth @hgarvison @stevendongatmsft
+
+/src/storage-mover/ @calvinhzy

src/service_name.json

@@ -708,5 +708,10 @@
     "Command": "az voice-service",
     "AzureServiceName": "Azure VoiceServices",
     "URL": ""
+  },
+  {
+    "Command": "az storage-mover",
+    "AzureServiceName": "Storage Mover",
+    "URL": "https://learn.microsoft.com/en-us/azure/storage-mover/"
   }
 ]

src/storage-mover/HISTORY.rst

@@ -0,0 +1,8 @@
+.. :changelog:
+
+Release History
+===============
+
+0.1.0
+++++++
+* Initial release.

src/storage-mover/README.md

@@ -0,0 +1,36 @@
+# Azure CLI StorageMover Extension #
+This is an extension to Azure CLI to manage StorageMover resources.
+
+## How to use ##
+### Create a top-level Storage Mover resource.
+`az storage-mover create -g {rg} -n {mover_name} -l eastus2 --tags {{key1:value1}} --description ExampleDesc`
+
+### Deploy and register an Agent resource, which references a hybrid compute machine that can run jobs.
+#### Deploy Agent
+https://learn.microsoft.com/en-us/azure/storage-mover/agent-deploy?tabs=xdmshell
+#### Register Agent
+https://learn.microsoft.com/en-us/azure/storage-mover/agent-register
+
+### Create a Project resource, which is a logical grouping of related jobs.
+`az storage-mover project create -g {rg} --storage-mover-name {mover_name} -n {project_name} --description ProjectDesc`
+
+### Create an Endpoint resource for nfs, which represents the data transfer source.
+`az storage-mover endpoint create-for-nfs -g {rg} --storage-mover-name {mover_name} -n {source_endpoint} --description srcendpointDesc --export exportfolder --nfs-version NFSv4 --host {vm_ip}`
+
+### Create an Endpoint resource for storage container, which represents the data transfer destination.
+`az storage-mover endpoint create-for-storage-container -g {rg} --storage-mover-name {mover_name} -n {target_endpoint} --container-name {target_container} --storage-account-id {account_id} --description tgtendpointDesc`
+
+### Create a Job Definition resource, which contains configuration for a single unit of managed data transfer.
+`az storage-mover job-definition create -g {rg} -n {job_definition} --project-name {project_name} --storage-mover-name {mover_name} --copy-mode Additive --source-name {source_endpoint} --target-name {target_endpoint} --agent-name {agent_name} --description JobDefinitionDescription --source-subpath path1 --target-subpath path2`
+
+### Request an Agent to start a new instance of this Job Definition, generating a new Job Run resource.
+`az storage-mover job-definition start-job -g {rg} --job-definition-name {job_definition} --project-name {project_name} --storage-mover-name {mover_name}`
+
+### List all Job Runs in a Job Definition.
+`az storage-mover job-run list -g {rg} --job-definition-name {job_definition} --project-name {project_name} --storage-mover-name {mover_name}`
+
+### Request the Agent of any active instance of this Job Definition to stop.
+`az storage-mover job-definition stop-job -g {rg} --job-definition-name {job_definition} --project-name {project_name} --storage-mover-name {mover_name}`
+
+### Delete a Job Definition resource.
+`az storage-mover job-definition delete -g {rg} -n {job_definition} --project-name {project_name} --storage-mover-name {mover_name}`

src/storage-mover/azext_storage_mover/__init__.py

@@ -0,0 +1,42 @@
+# --------------------------------------------------------------------------------------------
+# 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
+# --------------------------------------------------------------------------------------------
+
+from azure.cli.core import AzCommandsLoader
+from azext_storage_mover._help import helps  # pylint: disable=unused-import
+
+
+class StorageMoverCommandsLoader(AzCommandsLoader):
+
+    def __init__(self, cli_ctx=None):
+        from azure.cli.core.commands import CliCommandType
+        custom_command_type = CliCommandType(
+            operations_tmpl='azext_storage_mover.custom#{}')
+        super().__init__(cli_ctx=cli_ctx,
+                         custom_command_type=custom_command_type)
+
+    def load_command_table(self, args):
+        from azext_storage_mover.commands import load_command_table
+        from azure.cli.core.aaz import load_aaz_command_table
+        try:
+            from . import aaz
+        except ImportError:
+            aaz = None
+        if aaz:
+            load_aaz_command_table(
+                loader=self,
+                aaz_pkg_name=aaz.__name__,
+                args=args
+            )
+        load_command_table(self, args)
+        return self.command_table
+
+    def load_arguments(self, command):
+        from azext_storage_mover._params import load_arguments
+        load_arguments(self, command)
+
+
+COMMAND_LOADER_CLS = StorageMoverCommandsLoader

src/storage-mover/azext_storage_mover/_help.py

@@ -0,0 +1,51 @@
+# --------------------------------------------------------------------------------------------
+# 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: disable=line-too-long
+# pylint: disable=too-many-lines
+
+from knack.help_files import helps  # pylint: disable=unused-import
+
+helps['storage-mover endpoint create-for-storage-container'] = """
+type: command
+short-summary: Creates an Endpoint resource for storage blob container.
+examples:
+    - name: endpoint create-for-storage-container
+      text: >
+        az storage-mover endpoint create-for-storage-container -g {rg} --storage-mover-name {mover_name} -n
+        {endpoint_container} --container-name {container_name} --storage-account-id {account_id} --description endpointDesc
+"""
+
+helps['storage-mover endpoint create-for-nfs'] = """
+type: command
+short-summary: Creates an Endpoint resource for nfs.
+examples:
+    - name: endpoint create-for-nfs
+      text: >
+        az storage-mover endpoint create-for-nfs -g {rg} --storage-mover-name {mover_name} -n {endpoint_nfs}
+        --description endpointDesc --export exportfolder --nfs-version NFSv4 --host {vm_ip}
+"""
+
+helps['storage-mover endpoint update-for-storage-container'] = """
+type: command
+short-summary: Updates an Endpoint resource for storage blob container.
+examples:
+    - name: endpoint update-for-storage-container
+      text: >
+        az storage-mover endpoint update-for-storage-container -g {rg} --storage-mover-name {mover_name} -n
+        {endpoint_container} --description endpointDescUpdate --container-name {container_name} --storage-account-id {account_id}
+"""
+
+helps['storage-mover endpoint update-for-nfs'] = """
+type: command
+short-summary: Updates an Endpoint resource for nfs.
+examples:
+    - name: endpoint update-for-nfs
+      text: >
+        az storage-mover endpoint update-for-nfs -g {rg} --storage-mover-name {mover_name} -n {endpoint_nfs}
+        --description endpointDescUpdate --export exportfolder --nfs-version NFSv4 --host {vm_ip}
+"""

src/storage-mover/azext_storage_mover/_params.py

@@ -0,0 +1,38 @@
+# --------------------------------------------------------------------------------------------
+# 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: disable=too-many-lines
+# pylint: disable=too-many-statements
+from azure.cli.core.commands.parameters import (get_enum_type)
+
+
+def load_arguments(self, _):  # pylint: disable=unused-argument
+
+    for command in ['create-for-storage-container', 'create-for-nfs', 'update-for-storage-container', 'update-for-nfs']:
+        with self.argument_context('storage-mover endpoint ' + command) as c:
+            c.argument('endpoint_name', options_list=('--endpoint-name', '--name', '-n'), required=True,
+                       help='The name of the endpoint resource.')
+            c.argument('resource_group', options_list=('--resource-group', '-g'), required=True,
+                       help='Name of resource group. You can configure the default group using '
+                            '`az configure --defaults group=<name>`.')
+            c.argument('storage_mover_name', options_list=('--storage-mover-name'), required=True,
+                       help='The name of the Storage Mover resource.')
+            c.argument('description', help='A description for the Endpoint.')
+
+    for command in ['create-for-storage-container', 'update-for-storage-container']:
+        with self.argument_context('storage-mover endpoint ' + command) as c:
+            c.argument('blob_container_name', options_list=('--container-name'), required=True,
+                       help='The name of the Storage blob container that is the target destination.')
+            c.argument('storage_account_resource_id', options_list=('--storage-account-id'), required=True,
+                       help=' The Azure Resource ID of the storage account that is the target destination.')
+
+    for command in ['create-for-nfs', 'update-for-nfs']:
+        with self.argument_context('storage-mover endpoint ' + command) as c:
+            c.argument('export', required=True, help='The directory being exported from the server.')
+            c.argument('host', required=True, help='The host name or IP address of the server exporting the file system.')
+            c.argument('nfs_version', arg_type=get_enum_type(['NFSauto', 'NFSv3', 'NFSv4']),
+                       help='The NFS protocol version.')

src/storage-mover/azext_storage_mover/aaz/__init__.py

@@ -0,0 +1,6 @@
+# --------------------------------------------------------------------------------------------
+# 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
+# --------------------------------------------------------------------------------------------

src/storage-mover/azext_storage_mover/aaz/latest/__init__.py

@@ -0,0 +1,6 @@
+# --------------------------------------------------------------------------------------------
+# 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
+# --------------------------------------------------------------------------------------------

src/storage-mover/azext_storage_mover/aaz/latest/storage_mover/__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(
+    "storage-mover",
+)
+class __CMDGroup(AAZCommandGroup):
+    """Manage top-level Storage Mover resource.
+    """
+    pass
+
+
+__all__ = ["__CMDGroup"]

src/storage-mover/azext_storage_mover/aaz/latest/storage_mover/__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 *