Merge pull request #268899 from AbbyMSFT/alerts-api

Move and rename article about ARG queries

Author: Stacyrch140

articles/azure-monitor/alerts/migrate-from-alerts-summary-api.md

@@ -1,21 +1,21 @@
 ---
-title: Migrate from the Azure Monitor alertsSummary API
-description: Find out how to migrate from the Azure Monitor alertsSummary API, which is being deprecated
+title: Use ARG queries to get a summary of your alerts
+description: Find out how to se ARG queries to migrate from the Azure Monitor alertsSummary API, which is being deprecated.
 ms.topic: how-to
-ms.date: 09/21/2023
+ms.date: 03/13/2024
 ms.author: abbyweisberg
 ms.reviewer: nolavime
 ---
 
-# Migrate from the alertsSummary API to ARG queries
+# Use ARG queries to get a summary of your alerts
 
-The [alertsSummary API](/rest/api/monitor/alertsmanagement/alerts/get-summary) is being deprecated as of September 30,2026. Instead of the alertsSummary API, you can use Azure Resource Graph queries to get the same information.
+Azure Resource Graph queries allow you to query your Azure data and can be used to get information about your Azure monitor alerts.
 
-Azure Resource Graph queries provide flexibility to query your Azure data and can be used for Azure monitor alerts instead of the alertsSummary API.
+The [alertsSummary API](/rest/api/monitor/alertsmanagement/alerts/get-summary) is being deprecated as of September 30,2026. Instead of the alertsSummary API, you can use Azure Resource Graph queries to get the same information.
 
 Azure Resource Graph queries provide more functionality than the alertsSummary API, including: 
 * The ability to add new fields to the query that returns the alert summary.  
-* The ability to be more flexible in the query that returns the alert summary. 
+* More flexibility in the query that returns the alert summary. 
 
 ## Implementation of the current alertsSummary API: 
 
@@ -62,7 +62,7 @@ This is an example of the output from the alertsSummary API:
 }
 ```
 
-## Use the Azure Resource Graph query
+## Use the Azure Resource Graph queries for Azure Monitor alerts
 
 Use these Azure Resource Graph queries instead of the alertsSummary API call to retrieve alert information, or use these queries as a basis for designing your own queries.
 

articles/azure-monitor/toc.yml

@@ -1338,6 +1338,8 @@ items:
           href: alerts/alerts-manage-alert-instances.md
         - name: Update alerts for region moves
           href: alerts/alerts-resource-move.md
+        - name: Query alerts using ARG
+          href: alerts/migrate-from-alerts-summary-api.md
     - name: Tutorials
       items:
       - name: Create a metric alert
@@ -1566,8 +1568,13 @@ items:
     items:
     - name: Azure Monitor REST API index
       href: azure-monitor-rest-api-index.md
-    - name: Migrate from the alertsSummary API
-      href: alerts/migrate-from-alerts-summary-api.md
+    - name: REST API Walkthrough
+      displayName: metrics, analyze
+      href: essentials/rest-api-walkthrough.md
+    - name: Activity log via REST API
+      href: essentials/rest-activity-log.md
+    - name: Migrate to the metrics getBatch API
+      href: essentials/migrate-to-batch-api.md
   - name: Azure alerts management SDK for Python
     href: /python/api/azure-mgmt-monitor/azure.mgmt.monitor.monitormanagementclient
   - name: Resource Manager templates