Microsoft.Insights (stable:2018-03-01)

2025/03/02 • 5 updated methods

MetricAlerts_ListBySubscription (updated)
Description :  Retrieve alert rule definitions in a subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "MetricAlerts_ListBySubscription",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "scopes",
                "Description": {
                  "new": "the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs.",
                  "old": "the list of resource id's that this metric alert is scoped to."
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Insights/metricAlerts
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: the values for the alert rule resources. ,
Required: False ,
}
[
{
properties:
{
Description: The alert rule properties of the resource. ,
Required: True ,
}
{
description:
{
Description: the description of the metric alert that will be included in the alert email. ,
Required: False ,
}
string ,
severity:
{
Description: Alert severity {0, 1, 2, 3, 4} ,
Format: int32 ,
Required: True ,
}
integer ,
enabled:
{
Description: the flag that indicates whether the metric alert is enabled. ,
Required: True ,
}
boolean ,
scopes:
{
Description: the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs. ,
Required: True ,
}
[
string ,
]
,
evaluationFrequency:
{
Description: how often the metric alert is evaluated represented in ISO 8601 duration format. ,
Format: duration ,
Required: True ,
}
string ,
windowSize:
{
Description: the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. ,
Format: duration ,
Required: True ,
}
string ,
targetResourceType:
{
Description: the resource type of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
targetResourceRegion:
{
Description: the region of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
criteria:
{
Description: defines the specific alert criteria information. ,
Required: True ,
}
{
odata.type:
{
Description: specifies the type of the alert criteria. ,
Enum:
{
Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
autoMitigate:
{
Description: the flag that indicates whether the alert should be auto resolved or not. The default is true. ,
Required: False ,
}
boolean ,
actions:
{
Description: the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. ,
Required: False ,
}
[
{
actionGroupId:
{
Description: the id of the action group to use. ,
Required: False ,
}
string ,
webHookProperties:
{
Description: This field allows specifying custom properties, which would be appended to the alert payload sent as input to the webhook. ,
Required: False ,
}
object ,
}
,
]
,
lastUpdatedTime:
{
Description: Last time the rule was updated in ISO8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
isMigrated:
{
Description: the value indicating whether this alert rule is migrated. ,
Required: False ,
}
boolean ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. If Accept-Language is set in the request, it must be localized to that language. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
MetricAlerts_ListByResourceGroup (updated)
Description :  Retrieve alert rule definitions in a resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "MetricAlerts_ListByResourceGroup",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "scopes",
                "Description": {
                  "new": "the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs.",
                  "old": "the list of resource id's that this metric alert is scoped to."
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/metricAlerts
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: the values for the alert rule resources. ,
Required: False ,
}
[
{
properties:
{
Description: The alert rule properties of the resource. ,
Required: True ,
}
{
description:
{
Description: the description of the metric alert that will be included in the alert email. ,
Required: False ,
}
string ,
severity:
{
Description: Alert severity {0, 1, 2, 3, 4} ,
Format: int32 ,
Required: True ,
}
integer ,
enabled:
{
Description: the flag that indicates whether the metric alert is enabled. ,
Required: True ,
}
boolean ,
scopes:
{
Description: the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs. ,
Required: True ,
}
[
string ,
]
,
evaluationFrequency:
{
Description: how often the metric alert is evaluated represented in ISO 8601 duration format. ,
Format: duration ,
Required: True ,
}
string ,
windowSize:
{
Description: the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. ,
Format: duration ,
Required: True ,
}
string ,
targetResourceType:
{
Description: the resource type of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
targetResourceRegion:
{
Description: the region of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
criteria:
{
Description: defines the specific alert criteria information. ,
Required: True ,
}
{
odata.type:
{
Description: specifies the type of the alert criteria. ,
Enum:
{
Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
autoMitigate:
{
Description: the flag that indicates whether the alert should be auto resolved or not. The default is true. ,
Required: False ,
}
boolean ,
actions:
{
Description: the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. ,
Required: False ,
}
[
{
actionGroupId:
{
Description: the id of the action group to use. ,
Required: False ,
}
string ,
webHookProperties:
{
Description: This field allows specifying custom properties, which would be appended to the alert payload sent as input to the webhook. ,
Required: False ,
}
object ,
}
,
]
,
lastUpdatedTime:
{
Description: Last time the rule was updated in ISO8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
isMigrated:
{
Description: the value indicating whether this alert rule is migrated. ,
Required: False ,
}
boolean ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. If Accept-Language is set in the request, it must be localized to that language. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
MetricAlerts_Get (updated)
Description :  Retrieve an alert rule definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "MetricAlerts_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "scopes",
            "Description": {
              "new": "the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs.",
              "old": "the list of resource id's that this metric alert is scoped to."
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/metricAlerts/{ruleName}
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
ruleName:
{
Description: The name of the rule. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The alert rule properties of the resource. ,
Required: True ,
}
{
description:
{
Description: the description of the metric alert that will be included in the alert email. ,
Required: False ,
}
string ,
severity:
{
Description: Alert severity {0, 1, 2, 3, 4} ,
Format: int32 ,
Required: True ,
}
integer ,
enabled:
{
Description: the flag that indicates whether the metric alert is enabled. ,
Required: True ,
}
boolean ,
scopes:
{
Description: the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs. ,
Required: True ,
}
[
string ,
]
,
evaluationFrequency:
{
Description: how often the metric alert is evaluated represented in ISO 8601 duration format. ,
Format: duration ,
Required: True ,
}
string ,
windowSize:
{
Description: the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. ,
Format: duration ,
Required: True ,
}
string ,
targetResourceType:
{
Description: the resource type of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
targetResourceRegion:
{
Description: the region of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
criteria:
{
Description: defines the specific alert criteria information. ,
Required: True ,
}
{
odata.type:
{
Description: specifies the type of the alert criteria. ,
Enum:
{
Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
autoMitigate:
{
Description: the flag that indicates whether the alert should be auto resolved or not. The default is true. ,
Required: False ,
}
boolean ,
actions:
{
Description: the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. ,
Required: False ,
}
[
{
actionGroupId:
{
Description: the id of the action group to use. ,
Required: False ,
}
string ,
webHookProperties:
{
Description: This field allows specifying custom properties, which would be appended to the alert payload sent as input to the webhook. ,
Required: False ,
}
object ,
}
,
]
,
lastUpdatedTime:
{
Description: Last time the rule was updated in ISO8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
isMigrated:
{
Description: the value indicating whether this alert rule is migrated. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. If Accept-Language is set in the request, it must be localized to that language. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
MetricAlerts_CreateOrUpdate (updated)
Description :  Create or update an metric alert definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "MetricAlerts_CreateOrUpdate",
  "$parameters": {
    "parameters": {
      "$properties": {
        "properties": [
          {
            "#name": "scopes",
            "Description": {
              "new": "the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs.",
              "old": "the list of resource id's that this metric alert is scoped to."
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "scopes",
            "Description": {
              "new": "the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs.",
              "old": "the list of resource id's that this metric alert is scoped to."
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/metricAlerts/{ruleName}
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
ruleName:
{
Description: The name of the rule. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
parameters:
{
Description: The parameters of the rule to create or update. ,
Required: True ,
}
{
properties:
{
Description: The alert rule properties of the resource. ,
Required: True ,
}
{
description:
{
Description: the description of the metric alert that will be included in the alert email. ,
Required: False ,
}
string ,
severity:
{
Description: Alert severity {0, 1, 2, 3, 4} ,
Format: int32 ,
Required: True ,
}
integer ,
enabled:
{
Description: the flag that indicates whether the metric alert is enabled. ,
Required: True ,
}
boolean ,
scopes:
{
Description: the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs. ,
Required: True ,
}
[
string ,
]
,
evaluationFrequency:
{
Description: how often the metric alert is evaluated represented in ISO 8601 duration format. ,
Format: duration ,
Required: True ,
}
string ,
windowSize:
{
Description: the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. ,
Format: duration ,
Required: True ,
}
string ,
targetResourceType:
{
Description: the resource type of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
targetResourceRegion:
{
Description: the region of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
criteria:
{
Description: defines the specific alert criteria information. ,
Required: True ,
}
{
odata.type:
{
Description: specifies the type of the alert criteria. ,
Enum:
{
Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
autoMitigate:
{
Description: the flag that indicates whether the alert should be auto resolved or not. The default is true. ,
Required: False ,
}
boolean ,
actions:
{
Description: the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. ,
Required: False ,
}
[
{
actionGroupId:
{
Description: the id of the action group to use. ,
Required: False ,
}
string ,
webHookProperties:
{
Description: This field allows specifying custom properties, which would be appended to the alert payload sent as input to the webhook. ,
Required: False ,
}
object ,
}
,
]
,
lastUpdatedTime:
{
Description: Last time the rule was updated in ISO8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
isMigrated:
{
Description: the value indicating whether this alert rule is migrated. ,
Required: False ,
}
boolean ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The alert rule properties of the resource. ,
Required: True ,
}
{
description:
{
Description: the description of the metric alert that will be included in the alert email. ,
Required: False ,
}
string ,
severity:
{
Description: Alert severity {0, 1, 2, 3, 4} ,
Format: int32 ,
Required: True ,
}
integer ,
enabled:
{
Description: the flag that indicates whether the metric alert is enabled. ,
Required: True ,
}
boolean ,
scopes:
{
Description: the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs. ,
Required: True ,
}
[
string ,
]
,
evaluationFrequency:
{
Description: how often the metric alert is evaluated represented in ISO 8601 duration format. ,
Format: duration ,
Required: True ,
}
string ,
windowSize:
{
Description: the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. ,
Format: duration ,
Required: True ,
}
string ,
targetResourceType:
{
Description: the resource type of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
targetResourceRegion:
{
Description: the region of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
criteria:
{
Description: defines the specific alert criteria information. ,
Required: True ,
}
{
odata.type:
{
Description: specifies the type of the alert criteria. ,
Enum:
{
Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
autoMitigate:
{
Description: the flag that indicates whether the alert should be auto resolved or not. The default is true. ,
Required: False ,
}
boolean ,
actions:
{
Description: the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. ,
Required: False ,
}
[
{
actionGroupId:
{
Description: the id of the action group to use. ,
Required: False ,
}
string ,
webHookProperties:
{
Description: This field allows specifying custom properties, which would be appended to the alert payload sent as input to the webhook. ,
Required: False ,
}
object ,
}
,
]
,
lastUpdatedTime:
{
Description: Last time the rule was updated in ISO8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
isMigrated:
{
Description: the value indicating whether this alert rule is migrated. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. If Accept-Language is set in the request, it must be localized to that language. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
MetricAlerts_Update (updated)
Description :  Update an metric alert definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "MetricAlerts_Update",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "scopes",
            "Description": {
              "new": "the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs.",
              "old": "the list of resource id's that this metric alert is scoped to."
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/metricAlerts/{ruleName}
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
ruleName:
{
Description: The name of the rule. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
parameters:
{
Description: The parameters of the rule to update. ,
Required: True ,
}
{
tags:
{
Description: Resource tags ,
Required: False ,
}
object ,
properties:
{
Description: The alert rule properties of the resource. ,
Required: False ,
}
{
description:
{
Description: the description of the metric alert that will be included in the alert email. ,
Required: False ,
}
string ,
severity:
{
Description: Alert severity {0, 1, 2, 3, 4} ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: the flag that indicates whether the metric alert is enabled. ,
Required: False ,
}
boolean ,
scopes:
{
Description: the list of resource id's that this metric alert is scoped to. ,
Required: False ,
}
[
string ,
]
,
evaluationFrequency:
{
Description: how often the metric alert is evaluated represented in ISO 8601 duration format. ,
Format: duration ,
Required: False ,
}
string ,
windowSize:
{
Description: the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. ,
Format: duration ,
Required: False ,
}
string ,
targetResourceType:
{
Description: the resource type of the target resource(s) on which the alert is created/updated. Mandatory for MultipleResourceMultipleMetricCriteria. ,
Required: False ,
}
string ,
targetResourceRegion:
{
Description: the region of the target resource(s) on which the alert is created/updated. Mandatory for MultipleResourceMultipleMetricCriteria. ,
Required: False ,
}
string ,
criteria:
{
Description: defines the specific alert criteria information. ,
Required: False ,
}
{
odata.type:
{
Description: specifies the type of the alert criteria. ,
Enum:
{
Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
autoMitigate:
{
Description: the flag that indicates whether the alert should be auto resolved or not. The default is true. ,
Required: False ,
}
boolean ,
actions:
{
Description: the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. ,
Required: False ,
}
[
{
actionGroupId:
{
Description: the id of the action group to use. ,
Required: False ,
}
string ,
webHookProperties:
{
Description: This field allows specifying custom properties, which would be appended to the alert payload sent as input to the webhook. ,
Required: False ,
}
object ,
}
,
]
,
lastUpdatedTime:
{
Description: Last time the rule was updated in ISO8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
isMigrated:
{
Description: the value indicating whether this alert rule is migrated. ,
Required: False ,
}
boolean ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The alert rule properties of the resource. ,
Required: True ,
}
{
description:
{
Description: the description of the metric alert that will be included in the alert email. ,
Required: False ,
}
string ,
severity:
{
Description: Alert severity {0, 1, 2, 3, 4} ,
Format: int32 ,
Required: True ,
}
integer ,
enabled:
{
Description: the flag that indicates whether the metric alert is enabled. ,
Required: True ,
}
boolean ,
scopes:
{
Description: the list of resource id's that this metric alert is scoped to. You cannot change the scope of a metric rule based on logs. ,
Required: True ,
}
[
string ,
]
,
evaluationFrequency:
{
Description: how often the metric alert is evaluated represented in ISO 8601 duration format. ,
Format: duration ,
Required: True ,
}
string ,
windowSize:
{
Description: the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. ,
Format: duration ,
Required: True ,
}
string ,
targetResourceType:
{
Description: the resource type of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
targetResourceRegion:
{
Description: the region of the target resource(s) on which the alert is created/updated. Mandatory if the scope contains a subscription, resource group, or more than one resource. ,
Required: False ,
}
string ,
criteria:
{
Description: defines the specific alert criteria information. ,
Required: True ,
}
{
odata.type:
{
Description: specifies the type of the alert criteria. ,
Enum:
{
Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria: No description available. ,
Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
autoMitigate:
{
Description: the flag that indicates whether the alert should be auto resolved or not. The default is true. ,
Required: False ,
}
boolean ,
actions:
{
Description: the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. ,
Required: False ,
}
[
{
actionGroupId:
{
Description: the id of the action group to use. ,
Required: False ,
}
string ,
webHookProperties:
{
Description: This field allows specifying custom properties, which would be appended to the alert payload sent as input to the webhook. ,
Required: False ,
}
object ,
}
,
]
,
lastUpdatedTime:
{
Description: Last time the rule was updated in ISO8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
isMigrated:
{
Description: the value indicating whether this alert rule is migrated. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. If Accept-Language is set in the request, it must be localized to that language. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
{
code:
{
Description: Unlocalized string which can be used to programmatically identify the error. ,
Required: False ,
}
string ,
message:
{
Description: Describes the error in detail and provides debugging information. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error (for example, the name of the property in error). ,
Required: False ,
}
string ,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: An array of objects with 'type' and 'info' properties. The schema of 'info' is service-specific and dependent on the 'type' string. ,
Required: False ,
}
[
{
type:
{
Description: The type of additional information. ,
Required: False ,
}
string ,
info:
{
Description: The additional information specific to the type. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}