Azure · welovej · Dec 5, 2025 · Dec 5, 2025 · Dec 5, 2025 · Dec 5, 2025
diff --git a/...n/alertsmanagement/resource-manager/Microsoft.AlertsManagement/AlertsManagement/Alert.tsp b/...n/alertsmanagement/resource-manager/Microsoft.AlertsManagement/AlertsManagement/Alert.tsp
diff --git a/...nagement/resource-manager/Microsoft.AlertsManagement/AlertsManagement/back-compatible.tsp b/...nagement/resource-manager/Microsoft.AlertsManagement/AlertsManagement/back-compatible.tsp
@@ -0,0 +1,16 @@
+import "@azure-tools/typespec-client-generator-core";
+
+using Azure.ClientGenerator.Core;
+using Microsoft.AlertsManagement;
+
+@@clientName(Alerts.changeStateTenant::parameters.body, "comment");
+@@clientLocation(AlertOperationGroup.getById, Alerts);
+@@clientLocation(AlertOperationGroup.getAll, Alerts);
+@@clientLocation(AlertOperationGroup.changeState, Alerts);
+@@clientName(AlertOperationGroup.changeState::parameters.body, "comment");
+@@clientLocation(AlertOperationGroup.getHistory, Alerts);
+@@clientLocation(AlertOperationGroup.getEnrichments, Alerts);
+
+@@clientLocation(AlertsOperationGroup.metaData, Alerts);
+@@clientLocation(AlertsOperationGroup.getSummary, Alerts);
+@@clientLocation(AlertGetAllTenantOperation.getAllTenant, Alerts);
diff --git a/.../alertsmanagement/resource-manager/Microsoft.AlertsManagement/AlertsManagement/client.tsp b/.../alertsmanagement/resource-manager/Microsoft.AlertsManagement/AlertsManagement/client.tsp
@@ -0,0 +1,16 @@
+import "@azure-tools/typespec-client-generator-core";
+import "./main.tsp";
+
+using Azure.ClientGenerator.Core;
+
+#suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+model AlertsClientOptions {
+  #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  scope: string;
+}
+
+@@Azure.ClientGenerator.Core.clientInitialization(Microsoft.AlertsManagement,
+  {
+    parameters: AlertsClientOptions,
+  }
+);
diff --git a/...anagement/AlertsManagement/examples/2025-05-25-preview/AlertsMetaData_MonitorService.json b/...anagement/AlertsManagement/examples/2025-05-25-preview/AlertsMetaData_MonitorService.json
@@ -0,0 +1,91 @@
+{
+  "parameters": {
+    "api-version": "2025-05-25-preview",
+    "identifier": "MonitorServiceList"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "data": [
+            {
+              "name": "ActivityLog Administrative",
+              "displayName": "Activity Log - Administrative"
+            },
+            {
+              "name": "ActivityLog Autoscale",
+              "displayName": "Activity Log - Autoscale"
+            },
+            {
+              "name": "ActivityLog Policy",
+              "displayName": "Activity Log - Policy"
+            },
+            {
+              "name": "ActivityLog Recommendation",
+              "displayName": "Activity Log - Recommendation"
+            },
+            {
+              "name": "ActivityLog Security",
+              "displayName": "Activity Log - Security"
+            },
+            {
+              "name": "Application Insights",
+              "displayName": "Application Insights"
+            },
+            {
+              "name": "Azure Backup",
+              "displayName": "Azure Backup"
+            },
+            {
+              "name": "Custom",
+              "displayName": "Custom"
+            },
+            {
+              "name": "Data Box Edge",
+              "displayName": "Data Box Edge"
+            },
+            {
+              "name": "VM Insights",
+              "displayName": "VM Insights"
+            },
+            {
+              "name": "Log Analytics",
+              "displayName": "Log Analytics"
+            },
+            {
+              "name": "Nagios",
+              "displayName": "NAGIOS"
+            },
+            {
+              "name": "Platform",
+              "displayName": "Platform"
+            },
+            {
+              "name": "Resource Health",
+              "displayName": "Resource Health"
+            },
+            {
+              "name": "SCOM",
+              "displayName": "SCOM"
+            },
+            {
+              "name": "ServiceHealth",
+              "displayName": "Service Health"
+            },
+            {
+              "name": "Smart Detector",
+              "displayName": "SmartDetector"
+            },
+            {
+              "name": "Zabbix",
+              "displayName": "ZABBIX"
+            }
+          ],
+          "metadataIdentifier": "MonitorServiceList"
+        }
+      }
+    }
+  },
+  "operationId": "Alerts_MetaData",
+  "title": "MonService"
+}
diff --git a/...oft.AlertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_ChangeState.json b/...oft.AlertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_ChangeState.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "alertId": "66114d64-d9d9-478b-95c9-b789d6502100",
+    "api-version": "2025-05-25-preview",
+    "body": {
+      "comment": "Acknowledging alert"
+    },
+    "newState": "Acknowledged",
+    "scope": "subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "cpu alert",
+        "type": "Microsoft.AlertsManagement/alerts",
+        "id": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502100",
+        "properties": {
+          "context": {},
+          "egressConfig": {},
+          "essentials": {
+            "description": "description of the alert",
+            "actionStatus": {
+              "isSuppressed": false
+            },
+            "alertRule": "https://servisdfsdfappinsight.portal.mms.microsoft.com/#Workspace/overview/settings/details/Edit Alert Rule/details/index?savedSearchId=&scheduleId=",
+            "alertState": "Acknowledged",
+            "lastModifiedDateTime": "2018-09-13T15:51:02Z",
+            "lastModifiedUserName": "System",
+            "monitorCondition": "Fired",
+            "monitorConditionResolvedDateTime": "2018-09-13T15:51:02Z",
+            "monitorService": "Application Insights",
+            "severity": "Sev3",
+            "signalType": "Log",
+            "smartGroupId": "23d6b2ce-8c54-468f-aff0-sd32aebb7e56",
+            "smartGroupingReason": "Occurred frequently with other alerts",
+            "sourceCreatedId": "6cd6b2ce-8c54-468f-aff0-9d12aebb7e49",
+            "startDateTime": "2018-09-13T15:51:02Z",
+            "targetResource": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight",
+            "targetResourceGroup": "servicedeskresourcegroup",
+            "targetResourceName": "servicedeskappinsight",
+            "targetResourceType": "components"
+          }
+        }
+      }
+    }
+  },
+  "operationId": "Alerts_ChangeState",
+  "title": "Resolve"
+}
diff --git a/...ertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_ChangeStateTenant.json b/...ertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_ChangeStateTenant.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "alertId": "66114d64-d9d9-478b-95c9-b789d6502100",
+    "api-version": "2025-05-25-preview",
+    "body": {
+      "comment": "Acknowledging alert"
+    },
+    "newState": "Acknowledged",
+    "scope": "subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "cpu alert",
+        "type": "Microsoft.AlertsManagement/alerts",
+        "id": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502100",
+        "properties": {
+          "context": {},
+          "egressConfig": {},
+          "essentials": {
+            "description": "description of the alert",
+            "actionStatus": {
+              "isSuppressed": false
+            },
+            "alertRule": "https://servisdfsdfappinsight.portal.mms.microsoft.com/#Workspace/overview/settings/details/Edit Alert Rule/details/index?savedSearchId=&scheduleId=",
+            "alertState": "Acknowledged",
+            "lastModifiedDateTime": "2018-09-13T15:51:02Z",
+            "lastModifiedUserName": "System",
+            "monitorCondition": "Fired",
+            "monitorConditionResolvedDateTime": "2018-09-13T15:51:02Z",
+            "monitorService": "Application Insights",
+            "severity": "Sev3",
+            "signalType": "Log",
+            "smartGroupId": "23d6b2ce-8c54-468f-aff0-sd32aebb7e56",
+            "smartGroupingReason": "Occurred frequently with other alerts",
+            "sourceCreatedId": "6cd6b2ce-8c54-468f-aff0-9d12aebb7e49",
+            "startDateTime": "2018-09-13T15:51:02Z",
+            "targetResource": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight",
+            "targetResourceGroup": "servicedeskresourcegroup",
+            "targetResourceName": "servicedeskappinsight",
+            "targetResourceType": "components"
+          }
+        }
+      }
+    }
+  },
+  "operationId": "Alerts_ChangeStateTenant",
+  "title": "Resolve"
+}
diff --git a/...crosoft.AlertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_GetById.json b/...crosoft.AlertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_GetById.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "alertId": "66114d64-d9d9-478b-95c9-b789d6502100",
+    "api-version": "2025-05-25-preview",
+    "scope": "subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "cpu alert",
+        "type": "Microsoft.AlertsManagement/alerts",
+        "id": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502100",
+        "properties": {
+          "context": {},
+          "customProperties": {
+            "key1": "value1",
+            "key2": "value2"
+          },
+          "egressConfig": {},
+          "essentials": {
+            "description": "description of the alert",
+            "actionStatus": {
+              "isSuppressed": false
+            },
+            "alertRule": "https://sersdfsdfinsight.portal.mms.microsoft.com/#Workspace/overview/settings/details/Edit Alert Rule/details/index?savedSearchId=&scheduleId=",
+            "alertState": "Acknowledged",
+            "lastModifiedDateTime": "2018-09-13T15:51:02Z",
+            "lastModifiedUserName": "System",
+            "monitorCondition": "Fired",
+            "monitorConditionResolvedDateTime": "2018-09-13T15:51:02Z",
+            "monitorService": "Application Insights",
+            "severity": "Sev3",
+            "signalType": "Log",
+            "smartGroupId": "23d6b2ce-8c54-468f-aff0-sd32aebb7e56",
+            "smartGroupingReason": "Occurred frequently with other alerts",
+            "sourceCreatedId": "6cd6b2ce-8c54-468f-aff0-9d12aebb7e49",
+            "startDateTime": "2018-09-13T15:51:02Z",
+            "targetResource": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight",
+            "targetResourceGroup": "servicedeskresourcegroup",
+            "targetResourceName": "servicedeskappinsight",
+            "targetResourceType": "components"
+          }
+        }
+      }
+    }
+  },
+  "operationId": "Alerts_GetById",
+  "title": "GetById"
+}
diff --git a/...t.AlertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_GetByIdTenant.json b/...t.AlertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_GetByIdTenant.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "alertId": "66114d64-d9d9-478b-95c9-b789d6502100",
+    "api-version": "2025-05-25-preview",
+    "scope": "subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "cpu alert",
+        "type": "Microsoft.AlertsManagement/alerts",
+        "id": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502100",
+        "properties": {
+          "context": {},
+          "customProperties": {
+            "key1": "value1",
+            "key2": "value2"
+          },
+          "egressConfig": {},
+          "essentials": {
+            "description": "description of the alert",
+            "actionStatus": {
+              "isSuppressed": false
+            },
+            "alertRule": "https://sersdfsdfinsight.portal.mms.microsoft.com/#Workspace/overview/settings/details/Edit Alert Rule/details/index?savedSearchId=&scheduleId=",
+            "alertState": "Acknowledged",
+            "lastModifiedDateTime": "2018-09-13T15:51:02Z",
+            "lastModifiedUserName": "System",
+            "monitorCondition": "Fired",
+            "monitorConditionResolvedDateTime": "2018-09-13T15:51:02Z",
+            "monitorService": "Application Insights",
+            "severity": "Sev3",
+            "signalType": "Log",
+            "smartGroupId": "23d6b2ce-8c54-468f-aff0-sd32aebb7e56",
+            "smartGroupingReason": "Occurred frequently with other alerts",
+            "sourceCreatedId": "6cd6b2ce-8c54-468f-aff0-9d12aebb7e49",
+            "startDateTime": "2018-09-13T15:51:02Z",
+            "targetResource": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight",
+            "targetResourceGroup": "servicedeskresourcegroup",
+            "targetResourceName": "servicedeskappinsight",
+            "targetResourceType": "components"
+          }
+        }
+      }
+    }
+  },
+  "operationId": "Alerts_GetByIdTenant",
+  "title": "GetById"
+}
diff --git a/....AlertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_GetEnrichments.json b/....AlertsManagement/AlertsManagement/examples/2025-05-25-preview/Alerts_GetEnrichments.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "alertId": "66114d64-d9d9-478b-95c9-b789d6502101",
+    "api-version": "2025-05-25-preview",
+    "scope": "subscriptions/72fa99ef-9c84-4a7c-b343-ec62da107d81"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "default",
+            "type": "Microsoft.AlertsManagement/alerts/enrichments",
+            "id": "/subscriptions/9e261de7-c804-4b9d-9ebf-6f50fe350a9a/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502101/enrichments/default",
+            "properties": {
+              "alertId": "66114d64-d9d9-478b-95c9-b789d6502101",
+              "enrichments": [
+                {
+                  "type": "PrometheusInstantQuery",
+                  "description": "Enrichment description",
+                  "datasources": [
+                    "/subscriptions/72fa99ef-9c84-4a7c-b343-ec62da107d81/resourceGroups/SyntheticRules/providers/microsoft.monitor/accounts/canaryamw"
+                  ],
+                  "grafanaExplorePath": "/explore?left=%7B%22datasource%22...",
+                  "linkToApi": "https://test-3sxl.eastus.prometheus.monitor.azure.com/api/v1/query_range?...",
+                  "query": "sum by (cluster,container,replicaset,namespace)(label_replace( kube_pod_container_status_last_terminated_reason{reason='OOMKilled', cluster='cluster1', namespace='namespace1'}'}, 'replicaset', '$1', 'pod', '(.*)(-[a-z0-9]{5})$')) > 0",
+                  "status": "Succeeded",
+                  "time": "2015-07-01T20:10:51.781Z",
+                  "title": "Number of OOM killed events by container"
+                },
+                {
+                  "type": "PrometheusRangeQuery",
+                  "description": "Enrichment description",
+                  "datasources": [
+                    "/subscriptions/72fa99ef-9c84-4a7c-b343-ec62da107d81/resourceGroups/SyntheticRules/providers/microsoft.monitor/accounts/canaryamw"
+                  ],
+                  "end": "2015-07-01T20:20:51.781Z",
+                  "grafanaExplorePath": "/explore?left=%7B%22datasource%22...",
+                  "linkToApi": "https://test-3sxl.eastus.prometheus.monitor.azure.com/api/v1/query_range?...",
+                  "query": "sum by (cluster,container,replicaset,namespace)(label_replace( kube_pod_container_status_last_terminated_reason{reason='OOMKilled', cluster='cluster1', namespace='namespace'}'}, 'replicaset', '$1', 'pod', '(.*)(-[a-z0-9]{5})$')) > 0",
+                  "start": "2015-07-01T20:10:51.781Z",
+                  "status": "Succeeded",
+                  "step": "PT15S",
+                  "title": "Number of OOM killed events by container"
+                },
+                {
+                  "type": "PrometheusRangeQuery",
+                  "description": "Enrichment description",
+                  "datasources": [
+                    "/subscriptions/72fa99ef-9c84-4a7c-b343-ec62da107d81/resourceGroups/SyntheticRules/providers/microsoft.monitor/accounts/canaryamw"
+                  ],
+                  "end": "2015-07-01T20:20:51.781Z",
+                  "errorMessage": "Calling Prometheus query API failed",
+                  "grafanaExplorePath": "/explore?left=%7B%22datasource%22...",
+                  "linkToApi": "https://test-3sxl.eastus.prometheus.monitor.azure.com/api/v1/query_range?...",
+                  "query": "sum by (cluster,container,replicaset,namespace)(label_replace( kube_pod_container_status_last_terminated_reason{reason='OOMKilled', cluster='cluster1', namespace='namespace'}'}, 'replicaset', '$1', 'pod', '(.*)(-[a-z0-9]{5})$')) > 0",
+                  "start": "2015-07-01T20:10:51.781Z",
+                  "status": "Failed",
+                  "step": "PT15S",
+                  "title": "Number of OOM killed events by container"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  },
+  "operationId": "Alerts_GetEnrichments",
+  "title": "Resolve"
+}