Alerts - Change State

Referens

Service:: Monitor

API Version:: 2023-07-12-preview

Ändra tillståndet för en avisering.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
alertId	path	True	string	Unikt ID för en aviseringsinstans.
scope	path	True	string	scope här är resourceId som aviseringen skapas för.
api-version	query	True	string	Den API-version som ska användas för den här åtgärden.
newState	query	True	AlertState	Nytt tillstånd för aviseringen.

Begärandetext

Name	Typ	Description
comments	string

Svar

Name	Typ	Description
200 OK	alert	OK. Aviseringstillståndet har uppdaterats.
Other Status Codes	errorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Exempel

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

Definitioner

Name	Description
actionStatus	Åtgärdsstatus
alert	En avisering som skapats i aviseringshanteringstjänsten.
alertProperties	Aviseringsegenskapsuppsättning
AlertState	Aviseringsobjekttillstånd, som kan ändras av användaren.
comments	Ändra orsak till aviseringstillstånd
errorResponse	Ett felsvar från tjänsten.
errorResponseBody	Information om felsvar.
essentials	Det här objektet innehåller konsekventa fält i olika övervakningstjänster.
MonitorCondition	Villkor för regeln i övervakningstjänsten. Den representerar om de underliggande villkoren har passerat de definierade tröskelvärdena för aviseringsregeln.
MonitorService	Övervaka den tjänst där regeln (övervakaren) har angetts.
Severity	Allvarlighetsgraden för aviseringSev0 är högst och Sev4 är lägst.
SignalType	Den typ av signal som aviseringen baseras på, vilket kan vara mått, loggar eller aktivitetsloggar.

actionStatus

Åtgärdsstatus

Name	Typ	Description
isSuppressed	boolean	Värde som anger om aviseringen ignoreras.

alert

En avisering som skapats i aviseringshanteringstjänsten.

Name	Typ	Description
id	string	Resurs-ID för Azure
name	string	Azure-resursnamn
properties	alertProperties	Aviseringsegenskapsuppsättning
type	string	Azure-resurstyp

alertProperties

Aviseringsegenskapsuppsättning

Name	Typ	Description
context	object	Information som är specifik för övervakningstjänsten som ger mer sammanhangsberoende information om aviseringen.
egressConfig	object	Konfiguration som skulle användas för att visa data i portalen.
essentials	essentials	Det här objektet innehåller konsekventa fält i olika övervakningstjänster.

AlertState

Aviseringsobjekttillstånd, som kan ändras av användaren.

Name	Typ	Description
Acknowledged	string
Closed	string
New	string

comments

Ändra orsak till aviseringstillstånd

Name	Typ	Description
comments	string

errorResponse

Ett felsvar från tjänsten.

Name	Typ	Description
error	errorResponseBody	Information om felsvar.

errorResponseBody

Information om felsvar.

Name	Typ	Description
code	string	Felkod, avsedd att användas programmatiskt.
details	errorResponseBody[]	En lista med ytterligare information om felet.
message	string	Beskrivning av felet, som är avsett att visas i användargränssnittet.
target	string	Målet för det specifika felet, till exempel namnet på egenskapen.

essentials

Det här objektet innehåller konsekventa fält i olika övervakningstjänster.

Name	Typ	Description
actionStatus	actionStatus	Åtgärdsstatus
alertRule	string	Regel (övervakare) som utlöste aviseringsinstansen. Beroende på övervakningstjänsten är detta ARM-ID eller namnet på regeln.
alertState	AlertState	Aviseringsobjekttillstånd, som kan ändras av användaren.
description	string	Aviseringsbeskrivning.
lastModifiedDateTime	string	Senaste ändringstid (ISO-8601-format) för aviseringsinstansen.
lastModifiedUserName	string	Användare som senast ändrade aviseringen, om övervakaren tjänstuppdateringar användare skulle vara "system", annars namnet på användaren.
monitorCondition	MonitorCondition	Villkor för regeln i övervakningstjänsten. Den representerar om de underliggande villkoren har passerat de definierade tröskelvärdena för aviseringsregeln.
monitorConditionResolvedDateTime	string	Löst tid (ISO-8601-format) för aviseringsinstansen. Detta uppdateras när övervakningstjänsten löser aviseringsinstansen eftersom regelvillkoret inte längre uppfylls.
monitorService	MonitorService	Övervaka den tjänst där regeln (övervakaren) har angetts.
severity	Severity	Allvarlighetsgraden för aviseringSev0 är högst och Sev4 är lägst.
signalType	SignalType	Den typ av signal som aviseringen baseras på, vilket kan vara mått, loggar eller aktivitetsloggar.
smartGroupId	string	Unikt ID för den smarta gruppen
smartGroupingReason	string	Utförlig orsak som beskriver orsaken till att den här aviseringsinstansen läggs till i en smart grupp
sourceCreatedId	string	Unikt ID som skapats av övervakningstjänsten för varje aviseringsinstans. Detta kan användas för att spåra problemet vid övervakningstjänsten, i händelse av Nagios, Zabbix, SCOM osv.
startDateTime	string	Skapandetid (ISO-8601-format) för aviseringsinstansen.
targetResource	string	ARM-målresurs, där aviseringen skapades.
targetResourceGroup	string	Resursgrupp för ARM-målresursen, där aviseringen skapades.
targetResourceName	string	Namnet på målets ARM-resursnamn, där aviseringen skapades.
targetResourceType	string	Resurstyp för arm-målresursen, där aviseringen skapades.

MonitorCondition

Villkor för regeln i övervakningstjänsten. Den representerar om de underliggande villkoren har passerat de definierade tröskelvärdena för aviseringsregeln.

Name	Typ	Description
Fired	string
Resolved	string

MonitorService

Övervaka den tjänst där regeln (övervakaren) har angetts.

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

Allvarlighetsgraden för aviseringSev0 är högst och Sev4 är lägst.

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

SignalType

Den typ av signal som aviseringen baseras på, vilket kan vara mått, loggar eller aktivitetsloggar.

Name	Typ	Description
Log	string
Metric	string
Unknown	string

Share via