Scheduled Query Rules - Update

Referência

Serviço:: Monitor

Versão da API:: 2021-08-01

Atualizar uma regra de consulta agendada.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.
ruleName	path	True	string	O nome da regra.
subscriptionId	path	True	string	A ID da assinatura de destino.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
properties.actions	Actions	Ações a serem invocadas quando o alerta é acionado.
properties.autoMitigate	boolean	O sinalizador que indica se o alerta deve ser resolvido automaticamente ou não. O padrão é true. Relevante apenas para regras do tipo LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	O sinalizador que indica se essa regra de consulta agendada deve ser armazenada no armazenamento do cliente. O padrão é false. Relevante apenas para regras do tipo LogAlert.
properties.criteria	ScheduledQueryRuleCriteria	Os critérios de regra que definem as condições da regra de consulta agendada.
properties.description	string	A descrição da regra de consulta agendada.
properties.displayName	string	O nome de exibição da regra de alerta
properties.enabled	boolean	O sinalizador que indica se essa regra de consulta agendada está habilitada. O valor deve ser true ou false
properties.evaluationFrequency	string	Com que frequência a regra de consulta agendada é avaliada representada no formato de duração ISO 8601. Relevante e necessário apenas para regras do tipo LogAlert.
properties.muteActionsDuration	string	Ative o mudo das ações para o período de tempo escolhido (no formato de duração ISO 8601) depois que o alerta for acionado. Relevante apenas para regras do tipo LogAlert.
properties.overrideQueryTimeRange	string	Se especificado, então substitui o intervalo de tempo da consulta (o padrão é WindowSize*NumberOfEvaluationPeriods). Relevante apenas para regras do tipo LogAlert.
properties.scopes	string[]	A lista de IDs de recurso para a qual essa regra de consulta agendada está no escopo.
properties.severity	AlertSeverity	Severidade do alerta. Deve ser um inteiro entre [0-4]. O valor de 0 é mais grave. Relevante e necessário apenas para regras do tipo LogAlert.
properties.skipQueryValidation	boolean	O sinalizador que indica se a consulta fornecida deve ser validada ou não. O padrão é false. Relevante apenas para regras do tipo LogAlert.
properties.targetResourceTypes	string[]	Lista do tipo de recurso dos recursos de destino nos quais o alerta é criado/atualizado. Por exemplo, se o escopo for um grupo de recursos e targetResourceTypes for Microsoft.Compute/virtualMachines, um alerta diferente será acionado para cada máquina virtual no grupo de recursos que atenda aos critérios de alerta. Relevante somente para regras do tipo LogAlert
properties.windowSize	string	O período de tempo (no formato de duração ISO 8601) no qual a consulta alerta será executada (tamanho do compartimento). Relevante e necessário apenas para regras do tipo LogAlert.
tags	object	Marcações de recursos

Respostas

Nome	Tipo	Description
200 OK	ScheduledQueryRuleResource	Solicitação bem-sucedida para atualizar uma regra de consulta agendada
Other Status Codes	ErrorContract	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Create or update a scheduled query rule

Solicitação de exemplo

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
  }
}

Resposta de exemplo

Código de status:: 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
  }
}

Definições

Nome	Description
Actions	Ações a serem invocadas quando o alerta é acionado.
AlertSeverity	Severidade do alerta. Deve ser um inteiro entre [0-4]. O valor de 0 é mais grave. Relevante e necessário apenas para regras do tipo LogAlert.
Condition	Uma condição da regra de consulta agendada.
conditionOperator	O operador criteria. Relevante e necessário apenas para regras do tipo LogAlert.
createdByType	O tipo de identidade que criou o recurso.
Dimension	Definição de divisão e filtragem de dimensões
dimensionOperator	Operador para valores de dimensão
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorContract	Descreve o formato da resposta de erro.
ErrorResponse	Resposta de erro
FailingPeriods	O número mínimo de violações necessárias na janela de tempo de pesquisa selecionada necessária para gerar um alerta. Relevante apenas para regras do tipo LogAlert.
Kind	Indica o tipo de regra de consulta agendada. O padrão é LogAlert.
ScheduledQueryRuleCriteria	Os critérios de regra que definem as condições da regra de consulta agendada.
ScheduledQueryRuleResource	O recurso de regra de consulta agendada.
ScheduledQueryRuleResourcePatch	O recurso de regra de consulta agendada para operações de patch.
systemData	Metadados relativos à criação e à última modificação do recurso.
timeAggregation	Tipo de agregação. Relevante e necessário apenas para regras do tipo LogAlert.

Actions

Ações a serem invocadas quando o alerta é acionado.

Nome	Tipo	Description
actionGroups	string[]	IDs de recurso do Grupo de Ações a serem invocadas quando o alerta é acionado.
customProperties	object	As propriedades de um conteúdo de alerta.

AlertSeverity

Severidade do alerta. Deve ser um inteiro entre [0-4]. O valor de 0 é mais grave. Relevante e necessário apenas para regras do tipo LogAlert.

Nome	Tipo	Description
0	Integer
1	Integer
2	Integer
3	Integer
4	Integer

Condition

Uma condição da regra de consulta agendada.

Nome	Tipo	Description
dimensions	Dimension[]	Lista de condições de dimensões
failingPeriods	FailingPeriods	O número mínimo de violações necessárias na janela de tempo de pesquisa selecionada necessária para gerar um alerta. Relevante apenas para regras do tipo LogAlert.
metricMeasureColumn	string	A coluna que contém o número da medida de métrica. Relevante apenas para regras do tipo LogAlert.
metricName	string	O nome da métrica a ser enviada. Relevante e necessário apenas para regras do tipo LogToMetric.
operator	conditionOperator	O operador criteria. Relevante e necessário apenas para regras do tipo LogAlert.
query	string	Alerta de consulta de log
resourceIdColumn	string	A coluna que contém a ID do recurso. O conteúdo da coluna deve ser um URI formatado como id de recurso. Relevante apenas para regras do tipo LogAlert.
threshold	number	o valor de limite de critérios que ativa o alerta. Relevante e necessário apenas para regras do tipo LogAlert.
timeAggregation	timeAggregation	Tipo de agregação. Relevante e necessário apenas para regras do tipo LogAlert.

conditionOperator

O operador criteria. Relevante e necessário apenas para regras do tipo LogAlert.

Nome	Tipo	Description
Equals	string
GreaterThan	string
GreaterThanOrEqual	string
LessThan	string
LessThanOrEqual	string

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Dimension

Definição de divisão e filtragem de dimensões

Nome	Tipo	Description
name	string	Nome da dimensão
operator	dimensionOperator	Operador para valores de dimensão
values	string[]	Lista de valores de dimensão

dimensionOperator

Operador para valores de dimensão

Nome	Tipo	Description
Exclude	string
Include	string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorContract

Descreve o formato da resposta de erro.

Nome	Tipo	Description
error	ErrorResponse	Resposta de erro Os detalhes do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorResponse[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

FailingPeriods

O número mínimo de violações necessárias na janela de tempo de pesquisa selecionada necessária para gerar um alerta. Relevante apenas para regras do tipo LogAlert.

Nome	Tipo	Valor padrão	Description
minFailingPeriodsToAlert	integer	1	O número de violações para disparar um alerta. Deve ser menor ou igual a numberOfEvaluationPeriods. O valor padrão é 1
numberOfEvaluationPeriods	integer	1	O número de pontos de pesquisa agregados. A janela de tempo de pesquisa é calculada com base na granularidade de agregação (windowSize) e no número selecionado de pontos agregados. O valor padrão é 1

Kind

Indica o tipo de regra de consulta agendada. O padrão é LogAlert.

Nome	Tipo	Description
LogAlert	string
LogToMetric	string

ScheduledQueryRuleCriteria

Os critérios de regra que definem as condições da regra de consulta agendada.

Nome	Tipo	Description
allOf	Condition[]	Uma lista de condições a serem avaliadas em relação aos escopos especificados

ScheduledQueryRuleResource

O recurso de regra de consulta agendada.

Nome	Tipo	Description
etag	string	O campo de etag não é necessário. Se for fornecido no corpo da resposta, ele também deverá ser fornecido como um cabeçalho de acordo com a convenção de etag normal. As marcas de entidade são usadas para comparar duas ou mais entidades do mesmo recurso solicitado. HTTP/1.1 usa marcas de entidade nos campos de cabeçalho etag (seção 14.19), If-Match (seção 14.24), If-None-Match (seção 14.26) e If-Range (seção 14.27).
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	Kind	Indica o tipo de regra de consulta agendada. O padrão é LogAlert.
location	string	A localização geográfica em que o recurso reside
name	string	O nome do recurso
properties.actions	Actions	Ações a serem invocadas quando o alerta é acionado.
properties.autoMitigate	boolean	O sinalizador que indica se o alerta deve ser resolvido automaticamente ou não. O padrão é true. Relevante apenas para regras do tipo LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	O sinalizador que indica se essa regra de consulta agendada deve ser armazenada no armazenamento do cliente. O padrão é false. Relevante apenas para regras do tipo LogAlert.
properties.createdWithApiVersion	string	A versão da API usada ao criar essa regra de alerta
properties.criteria	ScheduledQueryRuleCriteria	Os critérios de regra que definem as condições da regra de consulta agendada.
properties.description	string	A descrição da regra de consulta agendada.
properties.displayName	string	O nome de exibição da regra de alerta
properties.enabled	boolean	O sinalizador que indica se essa regra de consulta agendada está habilitada. O valor deve ser true ou false
properties.evaluationFrequency	string	Com que frequência a regra de consulta agendada é avaliada representada no formato de duração ISO 8601. Relevante e necessário apenas para regras do tipo LogAlert.
properties.isLegacyLogAnalyticsRule	boolean	True se a regra de alerta for uma regra herdada do Log Analytic
properties.isWorkspaceAlertsStorageConfigured	boolean	O sinalizador que indica se essa regra de consulta agendada foi configurada para ser armazenada no armazenamento do cliente. O padrão é false.
properties.muteActionsDuration	string	Ative o mudo das ações para o período de tempo escolhido (no formato de duração ISO 8601) depois que o alerta for acionado. Relevante apenas para regras do tipo LogAlert.
properties.overrideQueryTimeRange	string	Se especificado, então substitui o intervalo de tempo da consulta (o padrão é WindowSize*NumberOfEvaluationPeriods). Relevante apenas para regras do tipo LogAlert.
properties.scopes	string[]	A lista de IDs de recurso para a qual essa regra de consulta agendada está no escopo.
properties.severity	AlertSeverity	Severidade do alerta. Deve ser um inteiro entre [0-4]. O valor de 0 é mais grave. Relevante e necessário apenas para regras do tipo LogAlert.
properties.skipQueryValidation	boolean	O sinalizador que indica se a consulta fornecida deve ser validada ou não. O padrão é false. Relevante apenas para regras do tipo LogAlert.
properties.targetResourceTypes	string[]	Lista do tipo de recurso dos recursos de destino nos quais o alerta é criado/atualizado. Por exemplo, se o escopo for um grupo de recursos e targetResourceTypes for Microsoft.Compute/virtualMachines, um alerta diferente será acionado para cada máquina virtual no grupo de recursos que atenda aos critérios de alerta. Relevante somente para regras do tipo LogAlert
properties.windowSize	string	O período de tempo (no formato de duração ISO 8601) no qual a consulta alerta será executada (tamanho do compartimento). Relevante e necessário apenas para regras do tipo LogAlert.
systemData	systemData	SystemData de ScheduledQueryRule.
tags	object	Marcas de recurso.
type	string	Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ScheduledQueryRuleResourcePatch

O recurso de regra de consulta agendada para operações de patch.

Nome	Tipo	Description
properties.actions	Actions	Ações a serem invocadas quando o alerta é acionado.
properties.autoMitigate	boolean	O sinalizador que indica se o alerta deve ser resolvido automaticamente ou não. O padrão é true. Relevante apenas para regras do tipo LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	O sinalizador que indica se essa regra de consulta agendada deve ser armazenada no armazenamento do cliente. O padrão é false. Relevante apenas para regras do tipo LogAlert.
properties.createdWithApiVersion	string	A versão da API usada ao criar essa regra de alerta
properties.criteria	ScheduledQueryRuleCriteria	Os critérios de regra que definem as condições da regra de consulta agendada.
properties.description	string	A descrição da regra de consulta agendada.
properties.displayName	string	O nome de exibição da regra de alerta
properties.enabled	boolean	O sinalizador que indica se essa regra de consulta agendada está habilitada. O valor deve ser true ou false
properties.evaluationFrequency	string	Com que frequência a regra de consulta agendada é avaliada representada no formato de duração ISO 8601. Relevante e necessário apenas para regras do tipo LogAlert.
properties.isLegacyLogAnalyticsRule	boolean	True se a regra de alerta for uma regra herdada do Log Analytic
properties.isWorkspaceAlertsStorageConfigured	boolean	O sinalizador que indica se essa regra de consulta agendada foi configurada para ser armazenada no armazenamento do cliente. O padrão é false.
properties.muteActionsDuration	string	Ative o mudo das ações para o período de tempo escolhido (no formato de duração ISO 8601) depois que o alerta for acionado. Relevante apenas para regras do tipo LogAlert.
properties.overrideQueryTimeRange	string	Se especificado, então substitui o intervalo de tempo da consulta (o padrão é WindowSize*NumberOfEvaluationPeriods). Relevante apenas para regras do tipo LogAlert.
properties.scopes	string[]	A lista de IDs de recurso para a qual essa regra de consulta agendada está no escopo.
properties.severity	AlertSeverity	Severidade do alerta. Deve ser um inteiro entre [0-4]. O valor de 0 é mais grave. Relevante e necessário apenas para regras do tipo LogAlert.
properties.skipQueryValidation	boolean	O sinalizador que indica se a consulta fornecida deve ser validada ou não. O padrão é false. Relevante apenas para regras do tipo LogAlert.
properties.targetResourceTypes	string[]	Lista do tipo de recurso dos recursos de destino nos quais o alerta é criado/atualizado. Por exemplo, se o escopo for um grupo de recursos e targetResourceTypes for Microsoft.Compute/virtualMachines, um alerta diferente será acionado para cada máquina virtual no grupo de recursos que atenda aos critérios de alerta. Relevante somente para regras do tipo LogAlert
properties.windowSize	string	O período de tempo (no formato de duração ISO 8601) no qual a consulta alerta será executada (tamanho do compartimento). Relevante e necessário apenas para regras do tipo LogAlert.
tags	object	Marcações de recursos

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

timeAggregation

Tipo de agregação. Relevante e necessário apenas para regras do tipo LogAlert.

Nome	Tipo	Description
Average	string
Count	string
Maximum	string
Minimum	string
Total	string

Compartilhar via