[AMG] Migrate

src/amg/HISTORY.rst

@@ -74,4 +74,8 @@ Release History
 ++++++
 * `az grafana folder show`: remove folder lookup by id due to deprecated API
 * `az grafana folder delete`: remove folder lookup by id due to deprecated API
-* `az grafana dashboard import`: update call from deprecated dashboard import API to dashboard create/update API
+* `az grafana dashboard import`: update call from deprecated dashboard import API to dashboard create/update API
+
+1.4.0
+++++++
+* `az grafana migrate`: support migration from other Grafana instances to AMG

src/amg/azext_amg/_help.py

@@ -55,6 +55,15 @@
            az grafana restore -g MyResourceGroup -n MyGrafana --archive-file backup\\dashboards\\ServiceHealth-202307051036.tar.gz --components dashboards folders --remap-data-sources
 """
 
+helps['grafana migrate'] = """
+    type: command
+    short-summary: Migrate an existing Grafana instance to an Azure Managed Grafana instance.
+    examples:
+       - name: Migrate dashboards and folders from a local Grafana instance to an Azure Managed Grafana instance.
+         text: |
+           az grafana migrate -g MyResourceGroup -n MyGrafana -s http://localhost:3000 -t YourServiceTokenOrAPIKey
+"""
+
 helps['grafana update'] = """
     type: command
     short-summary: Update an Azure Managed Grafana instance.

src/amg/azext_amg/_params.py

@@ -67,6 +67,12 @@ def load_arguments(self, _):
         c.argument("remap_data_sources", options_list=["-r", "--remap-data-sources"], arg_type=get_three_state_flag(),
                    help="during restoration, update dashboards to reference data sources defined at the destination workspace through name matching")
 
+    with self.argument_context("grafana migrate") as c:
+        c.argument("source_grafana_endpoint", options_list=["-s", "--src-endpoint"], help="Grafana instance endpoint to migrate from")
+        c.argument("source_grafana_token_or_api_key", options_list=["-t", "--src-token-or-key"], help="Grafana instance service token (or api key) to get access to migrate from")
+        c.argument("dry_run", options_list=["-d", "--dry-run"], arg_type=get_three_state_flag(), help="Preview changes without committing. Takes priority over --overwrite.")
+        c.argument("overwrite", options_list=["--overwrite"], arg_type=get_three_state_flag(), help="Overwrite previous dashboards, library panels, and folders with the same uid or title")
+
     with self.argument_context("grafana dashboard") as c:
         c.argument("uid", options_list=["--dashboard"], help="dashboard uid")
         c.argument("title", help="title of a dashboard")