Scheduled Query Rules - Update

Ссылка

Служба:: Monitor

Версия API:: 2021-08-01

Обновление правила запланированного запроса.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}?api-version=2021-08-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string	Имя группы ресурсов. Регистр букв в имени не учитывается.
ruleName	path	True	string	Имя правила.
subscriptionId	path	True	string	Идентификатор целевой подписки.
api-version	query	True	string	Версия API, используемая для данной операции.

Текст запроса

Имя	Тип	Описание
properties.actions	Actions	Действия для вызова при срабатывании оповещения.
properties.autoMitigate	boolean	Флаг, указывающий, следует ли автоматически разрешать оповещение. Значение по умолчанию — true. Применимо только для правил типа LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	Флаг, указывающий, должно ли это запланированное правило запроса храниться в хранилище клиента. Значение по умолчанию — false. Применимо только для правил типа LogAlert.
properties.criteria	ScheduledQueryRuleCriteria	Критерии правила, определяющие условия правила запланированного запроса.
properties.description	string	Описание правила запланированного запроса.
properties.displayName	string	Отображаемое имя правила генерации оповещений
properties.enabled	boolean	Флаг, указывающий, включено ли это запланированное правило запроса. Значение должно быть true или false
properties.evaluationFrequency	string	Частота оценки правила запланированного запроса в формате длительности ISO 8601. Применимо и требуется только для правил типа LogAlert.
properties.muteActionsDuration	string	Отключение звука для выбранного периода времени (в формате длительности ISO 8601) после срабатывания оповещения. Применимо только для правил типа LogAlert.
properties.overrideQueryTimeRange	string	Если указано, переопределяет диапазон времени запроса (по умолчанию — WindowSize*NumberOfEvaluationPeriods). Применимо только для правил типа LogAlert.
properties.scopes	string[]	Список идентификаторов ресурсов, на которые распространяется это запланированное правило запроса.
properties.severity	AlertSeverity	Серьезность оповещения. Должно быть целым числом в диапазоне от [0 до 4]. Значение 0 является самым серьезным. Применимо и требуется только для правил типа LogAlert.
properties.skipQueryValidation	boolean	Флаг, указывающий, следует ли проверять предоставленный запрос. Значение по умолчанию — false. Применимо только для правил типа LogAlert.
properties.targetResourceTypes	string[]	Список типов ресурсов целевых ресурсов, для которых создается или обновляется оповещение. Например, если область является группой ресурсов, а targetResourceTypes — Microsoft.Compute/virtualMachines, то для каждой виртуальной машины в группе ресурсов будет срабатывает другое оповещение, соответствующее критериям оповещения. Относится только к правилам типа LogAlert
properties.windowSize	string	Период времени (в формате длительности ISO 8601), в течение которого будет выполняться запрос оповещения (размер ячейки). Применимо и требуется только для правил типа LogAlert.
tags	object	Теги ресурсов

Ответы

Имя	Тип	Описание
200 OK	ScheduledQueryRuleResource	Успешный запрос на обновление правила запланированного запроса
Other Status Codes	ErrorContract	Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Create or update a scheduled query rule

Образец запроса

HTTP

PATCH https://management.azure.com/subscriptions/dd4bfc94-a096-412b-9c43-4bd13e35afbc/resourceGroups/QueryResourceGroupName/providers/Microsoft.Insights/scheduledQueryRules/heartbeat?api-version=2021-08-01

{
  "properties": {
    "enabled": false
  }
}

Пример ответа

Код состояния:: 200

{
  "id": "/subscriptions/dd4bfc94-a096-412b-9c43-4bd13e35afbc/resourcegroups/QueryResourceGroupName/providers/microsoft.insights/scheduledqueryrules/heartbeat",
  "name": "heartbeat",
  "type": "microsoft.insights/scheduledqueryrules",
  "location": "eastus",
  "tags": {},
  "properties": {
    "description": "Health check rule",
    "severity": 4,
    "enabled": false,
    "evaluationFrequency": "PT5M",
    "scopes": [
      "/subscriptions/aaf177ed-1330-a9f2-80ea-fd3d7783b147"
    ],
    "targetResourceTypes": [
      "Microsoft.Compute/virtualMachines"
    ],
    "windowSize": "PT10M",
    "criteria": {
      "allOf": [
        {
          "query": "Heartbeat",
          "timeAggregation": "Count",
          "dimensions": [],
          "operator": "GreaterThan",
          "threshold": 360,
          "failingPeriods": {
            "numberOfEvaluationPeriods": 1,
            "minFailingPeriodsToAlert": 1
          }
        }
      ]
    },
    "muteActionsDuration": "PT30M",
    "actions": {
      "actionGroups": [
        "/subscriptions/1cf177ed-1330-4692-80ea-fd3d7783b147/resourcegroups/sqrapi/providers/microsoft.insights/actiongroups/myactiongroup"
      ],
      "customProperties": {
        "key11": "value11",
        "key12": "value12"
      }
    },
    "autoMitigate": true,
    "isWorkspaceAlertsStorageConfigured": true,
    "checkWorkspaceAlertsStorageConfigured": true,
    "skipQueryValidation": true
  }
}

Определения

Имя	Описание
Actions	Действия для вызова при срабатывании оповещения.
AlertSeverity	Серьезность оповещения. Должно быть целым числом в диапазоне от [0 до 4]. Значение 0 является самым серьезным. Применимо и требуется только для правил типа LogAlert.
Condition	Условие правила запланированного запроса.
conditionOperator	Оператор условия. Применимо и требуется только для правил типа LogAlert.
createdByType	Тип удостоверения, создавшего ресурс.
Dimension	Определение разделения и фильтрации измерений
dimensionOperator	Оператор для значений измерений
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorContract	Описывает формат ответа об ошибке.
ErrorResponse	Сообщение об ошибке
FailingPeriods	Минимальное количество нарушений, необходимых в течение выбранного периода времени обратного просмотра, необходимого для создания оповещения. Применимо только для правил типа LogAlert.
Kind	Указывает тип правила запланированного запроса. Значение по умолчанию — LogAlert.
ScheduledQueryRuleCriteria	Критерии правила, определяющие условия правила запланированного запроса.
ScheduledQueryRuleResource	Ресурс правила запроса по расписанию.
ScheduledQueryRuleResourcePatch	Запланированный ресурс правила запроса для операций исправления.
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.
timeAggregation	Тип агрегирования. Применимо и требуется только для правил типа LogAlert.

Actions

Действия для вызова при срабатывании оповещения.

Имя	Тип	Описание
actionGroups	string[]	Идентификаторы ресурсов группы действий для вызова при срабатывании оповещения.
customProperties	object	Свойства полезных данных оповещения.

AlertSeverity

Серьезность оповещения. Должно быть целым числом в диапазоне от [0 до 4]. Значение 0 является самым серьезным. Применимо и требуется только для правил типа LogAlert.

Имя	Тип	Описание
0	Integer
1	Integer
2	Integer
3	Integer
4	Integer

Condition

Условие правила запланированного запроса.

Имя	Тип	Описание
dimensions	Dimension[]	Список условий измерений
failingPeriods	FailingPeriods	Минимальное количество нарушений, необходимых в течение выбранного периода времени обратного просмотра, необходимого для создания оповещения. Применимо только для правил типа LogAlert.
metricMeasureColumn	string	Столбец, содержащий номер метрики. Применимо только для правил типа LogAlert.
metricName	string	Имя отправляемой метрики. Применимо и требуется только для правил типа LogToMetric.
operator	conditionOperator	Оператор условия. Применимо и требуется только для правил типа LogAlert.
query	string	Оповещение о запросе к журналу
resourceIdColumn	string	Столбец, содержащий идентификатор ресурса. Содержимое столбца должно быть URI в формате идентификатора ресурса. Применимо только для правил типа LogAlert.
threshold	number	пороговое значение условия, которое активирует оповещение. Применимо и требуется только для правил типа LogAlert.
timeAggregation	timeAggregation	Тип агрегирования. Применимо и требуется только для правил типа LogAlert.

conditionOperator

Оператор условия. Применимо и требуется только для правил типа LogAlert.

Имя	Тип	Описание
Equals	string
GreaterThan	string
GreaterThanOrEqual	string
LessThan	string
LessThanOrEqual	string

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

Dimension

Определение разделения и фильтрации измерений

Имя	Тип	Описание
name	string	Имя измерения
operator	dimensionOperator	Оператор для значений измерений
values	string[]	Список значений измерений

dimensionOperator

Оператор для значений измерений

Имя	Тип	Описание
Exclude	string
Include	string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorContract

Описывает формат ответа об ошибке.

Имя	Тип	Описание
error	ErrorResponse	Сообщение об ошибке Сведения об ошибке.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorResponse[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

FailingPeriods

Минимальное количество нарушений, необходимых в течение выбранного периода времени обратного просмотра, необходимого для создания оповещения. Применимо только для правил типа LogAlert.

Имя	Тип	Default value	Описание
minFailingPeriodsToAlert	integer	1	Количество нарушений, которые активируют оповещение. Значение должно быть меньше или равно numberOfEvaluationPeriods. Значение по умолчанию — 1.
numberOfEvaluationPeriods	integer	1	Количество агрегированных точек обратного просмотра. Период времени просмотра рассчитывается на основе степени детализации агрегирования (windowSize) и выбранного количества агрегированных точек. Значение по умолчанию — 1.

Kind

Указывает тип правила запланированного запроса. Значение по умолчанию — LogAlert.

Имя	Тип	Описание
LogAlert	string
LogToMetric	string

ScheduledQueryRuleCriteria

Критерии правила, определяющие условия правила запланированного запроса.

Имя	Тип	Описание
allOf	Condition[]	Список условий для оценки в указанных областях

ScheduledQueryRuleResource

Ресурс правила запроса по расписанию.

Имя	Тип	Описание
etag	string	Поле etag не является обязательным. Если он указан в тексте ответа, он также должен быть указан в виде заголовка в соответствии с обычным соглашением etag. Теги сущностей используются для сравнения двух или более сущностей из одного запрошенного ресурса. HTTP/1.1 использует теги сущностей в полях заголовков etag (раздел 14.19), If-Match (раздел 14.24), If-None-Match (раздел 14.26) и If-Range (раздел 14.27).
id	string	Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	Kind	Указывает тип правила запланированного запроса. Значение по умолчанию — LogAlert.
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса.
properties.actions	Actions	Действия для вызова при срабатывании оповещения.
properties.autoMitigate	boolean	Флаг, указывающий, следует ли автоматически разрешать оповещение. Значение по умолчанию — true. Относится только к правилам типа LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	Флаг, указывающий, должно ли это запланированное правило запроса храниться в хранилище клиента. Значение по умолчанию — false. Относится только к правилам типа LogAlert.
properties.createdWithApiVersion	string	Версия API, используемая при создании этого правила генерации оповещений
properties.criteria	ScheduledQueryRuleCriteria	Критерии правила, определяющие условия правила запланированного запроса.
properties.description	string	Описание правила запланированного запроса.
properties.displayName	string	Отображаемое имя правила генерации оповещений
properties.enabled	boolean	Флаг, указывающий, включено ли это запланированное правило запроса. Значение должно быть true или false
properties.evaluationFrequency	string	Как часто правило запланированного запроса оценивается в формате длительности ISO 8601. Применимо и требуется только для правил типа LogAlert.
properties.isLegacyLogAnalyticsRule	boolean	True, если правило генерации оповещений является устаревшим правилом Log Analytic
properties.isWorkspaceAlertsStorageConfigured	boolean	Флаг, указывающий, настроено ли это запланированное правило запроса для хранения в хранилище клиента. Значение по умолчанию — false.
properties.muteActionsDuration	string	Отключение звука действий в течение выбранного периода времени (в формате длительности ISO 8601) после срабатывания оповещения. Относится только к правилам типа LogAlert.
properties.overrideQueryTimeRange	string	Если этот параметр указан, переопределяет диапазон времени запроса (по умолчанию — WindowSize*NumberOfEvaluationPeriods). Относится только к правилам типа LogAlert.
properties.scopes	string[]	Список идентификаторов ресурса, к которым применяется это запланированное правило запроса.
properties.severity	AlertSeverity	Серьезность оповещения. Должно быть целым числом от [0 до 4]. Значение 0 является самым строгим. Применимо и требуется только для правил типа LogAlert.
properties.skipQueryValidation	boolean	Флаг, указывающий, следует ли проверять предоставленный запрос. Значение по умолчанию — false. Относится только к правилам типа LogAlert.
properties.targetResourceTypes	string[]	Список типов ресурсов целевых ресурсов, для которых создается или обновляется оповещение. Например, если область является группой ресурсов, а targetResourceTypes — Microsoft.Compute/virtualMachines, то для каждой виртуальной машины в группе ресурсов, удовлетворяющей условиям оповещения, будет срабано другое оповещение. Относится только к правилам типа LogAlert
properties.windowSize	string	Период времени (в формате длительности ISO 8601), в течение которого будет выполняться запрос оповещения (размер ячейки). Применимо и требуется только для правил типа LogAlert.
systemData	systemData	SystemData объекта ScheduledQueryRule.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ScheduledQueryRuleResourcePatch

Запланированный ресурс правила запроса для операций исправления.

Имя	Тип	Описание
properties.actions	Actions	Действия для вызова при срабатывании оповещения.
properties.autoMitigate	boolean	Флаг, указывающий, следует ли автоматически разрешать оповещение. Значение по умолчанию — true. Относится только к правилам типа LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	Флаг, указывающий, должно ли это запланированное правило запроса храниться в хранилище клиента. Значение по умолчанию — false. Относится только к правилам типа LogAlert.
properties.createdWithApiVersion	string	Версия API, используемая при создании этого правила генерации оповещений
properties.criteria	ScheduledQueryRuleCriteria	Критерии правила, определяющие условия правила запланированного запроса.
properties.description	string	Описание правила запланированного запроса.
properties.displayName	string	Отображаемое имя правила генерации оповещений
properties.enabled	boolean	Флаг, указывающий, включено ли это запланированное правило запроса. Значение должно быть true или false
properties.evaluationFrequency	string	Как часто правило запланированного запроса оценивается в формате длительности ISO 8601. Применимо и требуется только для правил типа LogAlert.
properties.isLegacyLogAnalyticsRule	boolean	True, если правило генерации оповещений является устаревшим правилом Log Analytic
properties.isWorkspaceAlertsStorageConfigured	boolean	Флаг, указывающий, настроено ли это запланированное правило запроса для хранения в хранилище клиента. Значение по умолчанию — false.
properties.muteActionsDuration	string	Отключение звука действий в течение выбранного периода времени (в формате длительности ISO 8601) после срабатывания оповещения. Относится только к правилам типа LogAlert.
properties.overrideQueryTimeRange	string	Если этот параметр указан, переопределяет диапазон времени запроса (по умолчанию — WindowSize*NumberOfEvaluationPeriods). Относится только к правилам типа LogAlert.
properties.scopes	string[]	Список идентификаторов ресурса, к которым применяется это запланированное правило запроса.
properties.severity	AlertSeverity	Серьезность оповещения. Должно быть целым числом от [0 до 4]. Значение 0 является самым строгим. Применимо и требуется только для правил типа LogAlert.
properties.skipQueryValidation	boolean	Флаг, указывающий, следует ли проверять предоставленный запрос. Значение по умолчанию — false. Относится только к правилам типа LogAlert.
properties.targetResourceTypes	string[]	Список типов ресурсов целевых ресурсов, для которых создается или обновляется оповещение. Например, если область является группой ресурсов, а targetResourceTypes — Microsoft.Compute/virtualMachines, то для каждой виртуальной машины в группе ресурсов, удовлетворяющей условиям оповещения, будет срабано другое оповещение. Относится только к правилам типа LogAlert
properties.windowSize	string	Период времени (в формате длительности ISO 8601), в течение которого будет выполняться запрос оповещения (размер ячейки). Применимо и требуется только для правил типа LogAlert.
tags	object	Теги ресурсов

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Удостоверение, которое последним изменял ресурс.
lastModifiedByType	createdByType	Тип удостоверения, которое последним изменял ресурс.

timeAggregation

Тип агрегирования. Применимо и требуется только для правил типа LogAlert.

Имя	Тип	Описание
Average	string
Count	string
Maximum	string
Minimum	string
Total	string

Поделиться через