Alerts - Change State

Service:

Monitor

API Version:

2023-07-12-preview

Změna stavu výstrahy

POST https://management.azure.com/{scope}/providers/Microsoft.AlertsManagement/alerts/{alertId}/changestate?api-version=2023-07-12-preview&newState={newState}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
alertId	path	True	string	Jedinečné ID instance výstrahy
scope	path	True	string	obor je resourceId, pro který se vytvoří upozornění.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.
newState	query	True	AlertState	Nový stav výstrahy.

Text požadavku

Name	Typ	Description
comments	string

Odpovědi

Name	Typ	Description
200 OK	alert	OK. Stav upozornění byl aktualizován.
Other Status Codes	errorResponse	Chybová odpověď popisující, proč operace selhala.

Příklady

Resolve

Sample Request

HTTP

POST https://management.azure.com/subscriptions/9e261de7-c804-4b9d-9ebf-6f50fe350a9a/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502100/changestate?api-version=2023-07-12-preview&newState=Acknowledged

Sample Response

Status code:

200

{
  "properties": {
    "essentials": {
      "severity": "Sev3",
      "signalType": "Log",
      "alertState": "Acknowledged",
      "monitorCondition": "Fired",
      "monitorService": "Application Insights",
      "targetResource": "/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight",
      "targetResourceName": "servicedeskappinsight",
      "targetResourceGroup": "servicedeskresourcegroup",
      "targetResourceType": "components",
      "sourceCreatedId": "6cd6b2ce-8c54-468f-aff0-9d12aebb7e49",
      "smartGroupId": "23d6b2ce-8c54-468f-aff0-sd32aebb7e56",
      "smartGroupingReason": "Occurred frequently with other alerts",
      "alertRule": "https://servisdfsdfappinsight.portal.mms.microsoft.com/#Workspace/overview/settings/details/Edit Alert Rule/details/index?savedSearchId=&scheduleId=",
      "startDateTime": "2018-09-13T15:51:02Z",
      "lastModifiedDateTime": "2018-09-13T15:51:02Z",
      "lastModifiedUserName": "System",
      "monitorConditionResolvedDateTime": "2018-09-13T15:51:02Z",
      "actionStatus": {
        "isSuppressed": false
      },
      "description": "description of the alert"
    },
    "egressConfig": {},
    "context": {}
  },
  "id": "/subscriptions/9e261de7-c804-4b9d-9ebf-6f50fe350a9a/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502100",
  "type": "Microsoft.AlertsManagement/alerts",
  "name": "cpu alert"
}

Definice

Name	Description
actionStatus	Stav akce
alert	Výstraha vytvořená ve službě správy upozornění.
alertProperties	Kontejner vlastností upozornění
AlertState	Stav objektu výstrahy, který může uživatel změnit.
comments	Změnit důvod stavu upozornění
errorResponse	Chybová odpověď ze služby.
errorResponseBody	Podrobnosti o chybové odpovědi.
essentials	Tento objekt obsahuje konzistentní pole napříč různými službami monitorování.
MonitorCondition	Podmínka pravidla ve službě monitorování. Představuje, jestli podkladové podmínky překročily definované prahové hodnoty pravidla upozornění.
MonitorService	Monitorování služby, pro kterou je nastaveno pravidlo (monitor).
Severity	Závažnost výstrahy Sev0 je nejvyšší a závažnost 4 je nejnižší.
SignalType	Typ signálu, na kterém je upozornění založené, což můžou být metriky, protokoly nebo protokoly aktivit.

actionStatus

Stav akce

Name	Typ	Description
isSuppressed	boolean	Hodnota označující, jestli je upozornění potlačeno.

alert

Výstraha vytvořená ve službě správy upozornění.

Name	Typ	Description
id	string	ID prostředku Azure
name	string	Název prostředku Azure
properties	alertProperties	Kontejner vlastností upozornění
type	string	Typ prostředku Azure

alertProperties

Kontejner vlastností upozornění

Name	Typ	Description
context	object	Informace specifické pro službu monitorování, které poskytují další kontextové podrobnosti o výstraze.
egressConfig	object	Konfigurace, která by se použila k zobrazení dat na portálu.
essentials	essentials	Tento objekt obsahuje konzistentní pole napříč různými službami monitorování.

AlertState

Stav objektu výstrahy, který může uživatel změnit.

Name	Typ	Description
Acknowledged	string
Closed	string
New	string

comments

Změnit důvod stavu upozornění

Name	Typ	Description
comments	string

errorResponse

Chybová odpověď ze služby.

Name	Typ	Description
error	errorResponseBody	Podrobnosti o chybové odpovědi.

errorResponseBody

Podrobnosti o chybové odpovědi.

Name	Typ	Description
code	string	Kód chyby, který má být využíván programově.
details	errorResponseBody[]	Seznam dalších podrobností o chybě
message	string	Popis chyby, který je určený k zobrazení v uživatelském rozhraní.
target	string	Cíl konkrétní chyby, například název vlastnosti.

essentials

Tento objekt obsahuje konzistentní pole napříč různými službami monitorování.

Name	Typ	Description
actionStatus	actionStatus	Stav akce
alertRule	string	Rule(monitor), který aktivoval instanci upozornění. V závislosti na službě monitorování to bude ID ARM nebo název pravidla.
alertState	AlertState	Stav objektu výstrahy, který může uživatel změnit.
description	string	Popis upozornění.
lastModifiedDateTime	string	Čas poslední změny (formát ISO-8601) instance výstrahy.
lastModifiedUserName	string	Uživatel, který výstrahu naposledy změnil, by v případě aktualizací služby monitorování byl uživatelem "system", jinak by se uživatel jmenoval "system".
monitorCondition	MonitorCondition	Podmínka pravidla ve službě monitorování. Představuje, jestli podkladové podmínky překročily definované prahové hodnoty pravidla upozornění.
monitorConditionResolvedDateTime	string	Vyřešený čas (formát ISO-8601) instance upozornění. Tato aktualizace se aktualizuje, když služba monitorování vyřeší instanci upozornění, protože už není splněná podmínka pravidla.
monitorService	MonitorService	Monitorování služby, pro kterou je nastaveno pravidlo (monitor).
severity	Severity	Závažnost výstrahy Sev0 je nejvyšší a závažnost 4 je nejnižší.
signalType	SignalType	Typ signálu, na kterém je upozornění založené, což můžou být metriky, protokoly nebo protokoly aktivit.
smartGroupId	string	Jedinečné ID inteligentní skupiny
smartGroupingReason	string	Podrobný důvod popisující důvod přidání této instance upozornění do inteligentní skupiny
sourceCreatedId	string	Jedinečné ID vytvořené službou monitorování pro každou instanci upozornění To může být použito ke sledování problému v monitorovací službě, v případě Nagios, Zabbix, SCOM atd.
startDateTime	string	Čas vytvoření instance upozornění (formát ISO-8601).
targetResource	string	Cílový prostředek ARM, pro který se vytvořilo upozornění.
targetResourceGroup	string	Skupina prostředků cílového prostředku ARM, pro který se vytvořilo upozornění.
targetResourceName	string	Název cílového prostředku ARM, na kterém se upozornění vytvořilo.
targetResourceType	string	Typ prostředku cílového prostředku ARM, pro který se vytvořilo upozornění.

MonitorCondition

Podmínka pravidla ve službě monitorování. Představuje, jestli podkladové podmínky překročily definované prahové hodnoty pravidla upozornění.

Name	Typ	Description
Fired	string
Resolved	string

MonitorService

Monitorování služby, pro kterou je nastaveno pravidlo (monitor).

Name	Typ	Description
ActivityLog Administrative	string
ActivityLog Autoscale	string
ActivityLog Policy	string
ActivityLog Recommendation	string
ActivityLog Security	string
Application Insights	string
Log Analytics	string
Nagios	string
Platform	string
Resource Health	string
SCOM	string
ServiceHealth	string
SmartDetector	string
VM Insights	string
Zabbix	string

Severity

Závažnost výstrahy Sev0 je nejvyšší a závažnost 4 je nejnižší.

Name	Typ	Description
Sev0	string
Sev1	string
Sev2	string
Sev3	string
Sev4	string

SignalType

Typ signálu, na kterém je upozornění založené, což můžou být metriky, protokoly nebo protokoly aktivit.

Name	Typ	Description
Log	string
Metric	string
Unknown	string