Verouderde REST API voor Log Analytics-waarschuwingen

In dit artikel wordt beschreven hoe u waarschuwingsregels beheert met behulp van de verouderde API.

Belangrijk

Zoals aangekondigd, wordt de Log Analytics-waarschuwings-API op 1 oktober 2025 buiten gebruik gesteld. U moet overstappen op het gebruik van de API voor geplande queryregels voor logboekzoekwaarschuwingen op die datum. Log Analytics-werkruimten die zijn gemaakt na 1 juni 2019 gebruiken de scheduledQueryRules-API om waarschuwingsregels te beheren. Schakel over naar de huidige API in oudere werkruimten om te profiteren van de voordelen van Azure Monitor scheduledQueryRules.

Met de REST API voor Log Analytics-waarschuwingen kunt u waarschuwingen maken en beheren in Log Analytics. Dit artikel bevat informatie over de API en verschillende voorbeelden voor het uitvoeren van verschillende bewerkingen.

De REST API van Log Analytics Search is RESTful en kan worden geopend via de Azure Resource Manager REST API. In dit artikel vindt u voorbeelden waar de API wordt geopend vanaf een PowerShell-opdrachtregel met behulp van ARMClient. Dit opensource-opdrachtregelprogramma vereenvoudigt het aanroepen van de Azure Resource Manager-API.

Het gebruik van ARMClient en PowerShell is een van de vele opties die u kunt gebruiken voor toegang tot de Log Analytics Search-API. Met deze hulpprogramma's kunt u de RESTful Azure Resource Manager-API gebruiken om aanroepen te doen naar Log Analytics-werkruimten en zoekopdrachten in deze werkruimten uit te voeren. De API voert zoekresultaten uit in JSON-indeling, zodat u de zoekresultaten op veel verschillende manieren programmatisch kunt gebruiken.

Vereiste voorwaarden

Momenteel kunnen waarschuwingen alleen worden gemaakt met een opgeslagen zoekopdracht in Log Analytics. Zie de REST API voor zoeken in logboeken voor meer informatie.

Planningen

Een opgeslagen zoekopdracht kan een of meer planningen hebben. De planning bepaalt hoe vaak de zoekopdracht wordt uitgevoerd en het tijdsinterval waarvoor de criteria worden geïdentificeerd. Planningen hebben de eigenschappen die worden beschreven in de volgende tabel:

Vastgoed	Beschrijving
`Interval`	Hoe vaak de zoekopdracht wordt uitgevoerd. Gemeten in minuten.
`QueryTimeSpan`	Het tijdsinterval waarin de criteria worden geëvalueerd. Moet gelijk zijn aan of groter zijn dan `Interval`. Gemeten in minuten.
`Version`	De API-versie die wordt gebruikt. Op dit moment moet deze instelling altijd zijn `1`.

Denk bijvoorbeeld aan een gebeurtenisquery met een Interval van 15 minuten en een Timespan van 30 minuten. In dit geval wordt de query elke 15 minuten uitgevoerd. Er zou een waarschuwing worden geactiveerd als de criteria gedurende een periode van 30 minuten blijven voldoen aan true.

Schema's ophalen

Gebruik de methode Get om alle planningen voor een opgeslagen zoekopdracht op te halen.

armclient get /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search  ID}/schedules?api-version=2015-03-20

Gebruik de methode Ophalen met een plannings-id om een bepaald schema op te halen voor een opgeslagen zoekopdracht.

armclient get /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Subscription ID}/schedules/{Schedule ID}?api-version=2015-03-20

Het volgende voorbeeldantwoord is bedoeld voor een schema:

{
   "value": [{
      "id": "subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/sampleRG/providers/Microsoft.OperationalInsights/workspaces/MyWorkspace/savedSearches/0f0f4853-17f8-4ed1-9a03-8e888b0d16ec/schedules/a17b53ef-bd70-4ca4-9ead-83b00f2024a8",
      "etag": "W/\"datetime'2016-02-25T20%3A54%3A49.8074679Z'\"",
      "properties": {
         "Interval": 15,
         "QueryTimeSpan": 15,
         "Enabled": true,
      }
   }]
}

Een planning maken

Gebruik de Put-methode met een unieke plannings-id om een nieuw schema te maken. Twee planningen kunnen niet dezelfde id hebben, zelfs niet als ze zijn gekoppeld aan verschillende opgeslagen zoekopdrachten. Wanneer u een planning maakt in de Log Analytics-console, wordt er een GUID gemaakt voor de plannings-id.

Opmerking

De naam voor alle opgeslagen zoekopdrachten, planningen en acties die zijn gemaakt met de Log Analytics-API, moet in kleine letters staan.

$scheduleJson = "{'properties': { 'Interval': 15, 'QueryTimeSpan':15, 'Enabled':'true' } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/mynewschedule?api-version=2015-03-20 $scheduleJson

Een planning bewerken

Gebruik de Put-methode met een bestaande plannings-id voor dezelfde opgeslagen zoekopdracht om die planning te wijzigen. In het volgende voorbeeld is het schema uitgeschakeld. De hoofdtekst van de aanvraag moet de etag van de planning bevatten.

$scheduleJson = "{'etag': 'W/\"datetime'2016-02-25T20%3A54%3A49.8074679Z'\""','properties': { 'Interval': 15, 'QueryTimeSpan':15, 'Enabled':'false' } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/mynewschedule?api-version=2015-03-20 $scheduleJson

Schema's verwijderen

Gebruik de methode Verwijderen met een plannings-id om een schema te verwijderen.

armclient delete /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Subscription ID}/schedules/{Schedule ID}?api-version=2015-03-20

Acties

Een planning kan meerdere acties hebben. Een actie kan een of meer processen definiëren die moeten worden uitgevoerd, zoals het verzenden van een e-mail of het starten van een runbook. Een actie kan ook een drempelwaarde definiëren die bepaalt wanneer de resultaten van een zoekopdracht aan bepaalde criteria voldoen. Sommige acties definiëren beide, zodat de processen worden uitgevoerd wanneer aan de drempelwaarde wordt voldaan.

Alle acties hebben de eigenschappen die in de volgende tabel worden beschreven. Verschillende typen waarschuwingen hebben andere verschillende eigenschappen, die worden beschreven in de volgende tabel:

Vastgoed	Beschrijving
`Type`	Type van de actie. Momenteel zijn de mogelijke waarden `Alert` en `Webhook`.
`Name`	Weergavenaam voor de melding.
`Version`	De API-versie die wordt gebruikt. Op dit moment moet deze instelling altijd zijn `1`.

Acties ophalen

Gebruik de functie Ophalen om alle acties voor een schema op te halen.

armclient get /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search  ID}/schedules/{Schedule ID}/actions?api-version=2015-03-20

Gebruik de 'Get'-methode met de actie-id om een bepaalde actie voor een planning op te halen.

armclient get /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Subscription ID}/schedules/{Schedule ID}/actions/{Action ID}?api-version=2015-03-20

Acties maken of bewerken

Gebruik de methode Put met een actie-id die uniek is voor het schema om een nieuwe actie te maken. Wanneer u een actie maakt in de Log Analytics-console, is een GUID voor de actie-id.

Opmerking

De naam voor alle opgeslagen zoekopdrachten, planningen en acties die zijn gemaakt met de Log Analytics-API, moet in kleine letters staan.

Gebruik de methode Put met een bestaande actie-id voor dezelfde opgeslagen zoekopdracht om die planning te wijzigen. De hoofdtekst van het verzoek moet de etag van het schema bevatten.

De aanvraagindeling voor het maken van een nieuwe actie verschilt per actietype, dus deze voorbeelden worden weergegeven in de volgende secties.

Acties verwijderen

Gebruik de methode Verwijderen met de actie-id om een actie te verwijderen.

armclient delete /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Subscription ID}/schedules/{Schedule ID}/Actions/{Action ID}?api-version=2015-03-20

Waarschuwingsacties

Een planning moet één en slechts één waarschuwingsactie hebben. Waarschuwingsacties hebben een of meer van de secties die in de volgende tabel worden beschreven:

Afdeling	Beschrijving	Gebruik
Drempel	Criteria voor wanneer de actie wordt uitgevoerd.	Vereist voor elke waarschuwing, vóór of nadat deze zijn uitgebreid naar Azure.
Ernstigheid	Label dat wordt gebruikt om de waarschuwing te classificeren wanneer deze wordt geactiveerd.	Vereist voor elke waarschuwing, vóór of nadat deze zijn uitgebreid naar Azure.
Onderdrukken	Optie om meldingen van waarschuwingen te stoppen.	Optioneel voor elke waarschuwing, vóór of nadat deze zijn uitgebreid naar Azure.
Actiegroepen	Id's van Azure `ActionGroup` waar vereiste acties worden opgegeven, zoals e-mailberichten, SMSs, spraakoproepen, webhooks, automation-runbooks en ITSM-connectors.	Vereist nadat meldingen zijn overgebracht naar Azure.
Acties aanpassen	Wijzig de standaarduitvoer voor geselecteerde acties uit `ActionGroup`.	Optioneel voor elke waarschuwing en kan worden gebruikt nadat waarschuwingen zijn uitgebreid naar Azure.

Drempelwaarden

Een waarschuwingsactie moet één en slechts één drempelwaarde hebben. Wanneer de resultaten van een opgeslagen zoekopdracht overeenkomen met de drempelwaarde in een actie die aan die zoekopdracht is gekoppeld, worden alle andere processen in die actie uitgevoerd. Een actie kan ook alleen een drempelwaarde bevatten, zodat deze kan worden gebruikt met acties van andere typen die geen drempelwaarden bevatten.

Drempelwaarden hebben de eigenschappen die worden beschreven in de volgende tabel:

Vastgoed	Beschrijving
`Operator`	Operator voor de drempelwaardevergelijking. gt = Groter dan lt = Kleiner dan
`Value`	Waarde voor de drempelwaarde.

Denk bijvoorbeeld aan een gebeurtenisquery met een Interval van 15 minuten, een Timespan van 30 minuten en een Threshold van meer dan 10. In dit geval wordt de query elke 15 minuten uitgevoerd. Er wordt een waarschuwing geactiveerd als er tien gebeurtenissen zijn geretourneerd die zijn gemaakt gedurende een periode van 30 minuten.

Het volgende voorbeeldantwoord is voor een actie met slechts een Threshold:

"etag": "W/\"datetime'2016-02-25T20%3A54%3A20.1302566Z'\"",
"properties": {
   "Type": "Alert",
   "Name": "My threshold action",
   "Threshold": {
      "Operator": "gt",
      "Value": 10
   },
   "Version": 1
}

Gebruik de Put-methode met een unieke actie-ID om een nieuwe drempelactie voor een schema te maken.

$thresholdJson = "{'properties': { 'Name': 'My Threshold', 'Version':'1', 'Type':'Alert', 'Threshold': { 'Operator': 'gt', 'Value': 10 } } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/mythreshold?api-version=2015-03-20 $thresholdJson

Gebruik de methode Put met een bestaande actie-id om een drempelwaarde voor een planning te wijzigen. De inhoud van de aanvraag moet de etag van de actie bevatten.

$thresholdJson = "{'etag': 'W/\"datetime'2016-02-25T20%3A54%3A20.1302566Z'\"','properties': { 'Name': 'My Threshold', 'Version':'1', 'Type':'Alert', 'Threshold': { 'Operator': 'gt', 'Value': 10 } } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/mythreshold?api-version=2015-03-20 $thresholdJson

Ernstigheid

Met Log Analytics kunt u uw waarschuwingen classificeren in categorieën voor eenvoudiger beheer en triage. De ernstniveaus Waarschuwingen zijn informational, warningen critical. Deze categorieën worden toegewezen aan de genormaliseerde ernstschaal van Azure-waarschuwingen, zoals wordt weergegeven in de volgende tabel:

Ernstniveau van Log Analytics	Ernstniveau Azure-waarschuwingen
`critical`	Sev 0
`warning`	Sev 1
`informational`	Sev 2

Het volgende voorbeeldantwoord is bedoeld voor een actie met alleen Threshold en Severity:

"etag": "W/\"datetime'2016-02-25T20%3A54%3A20.1302566Z'\"",
"properties": {
   "Type": "Alert",
   "Name": "My threshold action",
   "Threshold": {
      "Operator": "gt",
      "Value": 10
   },
   "Severity": "critical",
   "Version": 1
}

Gebruik de Put-methode met een unieke actie-id om een nieuwe actie te maken voor een schema met Severity.

$thresholdWithSevJson = "{'properties': { 'Name': 'My Threshold', 'Version':'1','Severity': 'critical', 'Type':'Alert', 'Threshold': { 'Operator': 'gt', 'Value': 10 } } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/mythreshold?api-version=2015-03-20 $thresholdWithSevJson

Gebruik de methode Put met een bestaande actie-id om een ernstactie voor een planning te wijzigen. De hoofdtekst van de aanvraag moet de etag van de actie bevatten.

$thresholdWithSevJson = "{'etag': 'W/\"datetime'2016-02-25T20%3A54%3A20.1302566Z'\"','properties': { 'Name': 'My Threshold', 'Version':'1','Severity': 'critical', 'Type':'Alert', 'Threshold': { 'Operator': 'gt', 'Value': 10 } } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/mythreshold?api-version=2015-03-20 $thresholdWithSevJson

Onderdrukken

Querywaarschuwingen op basis van Log Analytics worden geactiveerd telkens wanneer aan de drempelwaarde wordt voldaan of overschreden. Op basis van de logica die in de query wordt geïmpliceerd, kan een waarschuwing worden geactiveerd voor een reeks intervallen. Het resultaat is dat meldingen voortdurend worden verzonden. Als u een dergelijk scenario wilt voorkomen, kunt u de Suppress optie instellen waarmee Log Analytics wordt geïnstrueerd om te wachten op een bepaalde hoeveelheid tijd voordat de melding de tweede keer voor de waarschuwingsregel wordt geactiveerd.

Als Suppress de waarschuwing bijvoorbeeld 30 minuten is ingesteld, wordt de eerste keer geactiveerd en worden meldingen verzonden die zijn geconfigureerd. Vervolgens wordt 30 minuten gewacht voordat de waarschuwingsregel opnieuw wordt gebruikt. In de tussentijd blijft de waarschuwingsregel actief. Alleen meldingen worden onderdrukt door Log Analytics gedurende een opgegeven tijd, ongeacht hoe vaak de waarschuwingsregel in deze periode is geactiveerd.

De Suppress eigenschap van een waarschuwingsregel voor zoeken in logboeken wordt opgegeven met behulp van de Throttling waarde. De onderdrukkingsperiode wordt opgegeven met behulp van de DurationInMinutes waarde.

Het volgende voorbeeldantwoord is bedoeld voor een actie met alleen Threshold, Severityen Suppress eigenschappen.

"etag": "W/\"datetime'2016-02-25T20%3A54%3A20.1302566Z'\"",
"properties": {
   "Type": "Alert",
   "Name": "My threshold action",
   "Threshold": {
      "Operator": "gt",
      "Value": 10
   },
   "Throttling": {
   "DurationInMinutes": 30
   },
   "Severity": "critical",
   "Version": 1
}

Gebruik de methode Put met een unieke actie-id om een nieuwe actie te maken voor een schema.Severity

$AlertSuppressJson = "{'properties': { 'Name': 'My Threshold', 'Version':'1','Severity': 'critical', 'Type':'Alert', 'Throttling': { 'DurationInMinutes': 30 },'Threshold': { 'Operator': 'gt', 'Value': 10 } } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/myalert?api-version=2015-03-20 $AlertSuppressJson

Gebruik de Put-methode met een bestaande actie-id om een ernstactie voor een planning te wijzigen. De hoofdtekst van de aanvraag moet de etag van de actie bevatten.

$AlertSuppressJson = "{'etag': 'W/\"datetime'2016-02-25T20%3A54%3A20.1302566Z'\"','properties': { 'Name': 'My Threshold', 'Version':'1','Severity': 'critical', 'Type':'Alert', 'Throttling': { 'DurationInMinutes': 30 },'Threshold': { 'Operator': 'gt', 'Value': 10 } } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/myalert?api-version=2015-03-20 $AlertSuppressJson

Actiegroepen

Alle waarschuwingen in Azure gebruiken actiegroep als het standaardmechanisme voor het afhandelen van acties. Met een actiegroep kunt u uw acties eenmaal opgeven en vervolgens de actiegroep aan meerdere waarschuwingen in Azure koppelen zonder dat u dezelfde acties herhaaldelijk hoeft te declareren. Actiegroepen ondersteunen meerdere acties, zoals e-mail, sms, spraakoproep, ITSM-verbinding, automation-runbook en webhook-URI.

Voor gebruikers die hun waarschuwingen hebben uitgebreid in Azure, moet een planning nu details van de actiegroep hebben doorgegeven om Threshold een waarschuwing te kunnen maken. E-maildetails, webhook-URL's, details van runbookautomatisering en andere acties moeten eerst in een actiegroep worden gedefinieerd voordat u een waarschuwing maakt. U kunt een actiegroep maken vanuit Azure Monitor in Azure Portal of de API van de actiegroep gebruiken.

Als u een actiegroep aan een waarschuwing wilt koppelen, geeft u de unieke Azure Resource Manager-id van de actiegroep op in de waarschuwingsdefinitie. In het volgende voorbeeld ziet u het gebruik:

"etag": "W/\"datetime'2017-12-13T10%3A52%3A21.1697364Z'\"",
"properties": {
   "Type": "Alert",
   "Name": "test-alert",
   "Description": "I need to put a description here",
   "Threshold": {
      "Operator": "gt",
      "Value": 12
   },
   "AzNsNotification": {
      "GroupIds": [
         "/subscriptions/1234a45-123d-4321-12aa-123b12a5678/resourcegroups/my-resource-group/providers/microsoft.insights/actiongroups/test-actiongroup"
      ]
   },
   "Severity": "critical",
   "Version": 1
}

Gebruik de methode Put met een unieke actie-id om een al bestaande actiegroep voor een planning te koppelen. In het volgende voorbeeld ziet u het gebruik:

$AzNsJson = "{'properties': { 'Name': 'test-alert', 'Version':'1', 'Type':'Alert', 'Threshold': { 'Operator': 'gt', 'Value': 12 },'Severity': 'critical', 'AzNsNotification': {'GroupIds': ['subscriptions/1234a45-123d-4321-12aa-123b12a5678/resourcegroups/my-resource-group/providers/microsoft.insights/actiongroups/test-actiongroup']} } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/myAzNsaction?api-version=2015-03-20 $AzNsJson

Gebruik de methode Put met een bestaande actie-id om een actiegroep te wijzigen die is gekoppeld aan een planning. De inhoud van de aanvraag moet de etag van de actie bevatten.

$AzNsJson = "{'etag': 'datetime'2017-12-13T10%3A52%3A21.1697364Z'\"', 'properties': { 'Name': 'test-alert', 'Version':'1', 'Type':'Alert', 'Threshold': { 'Operator': 'gt', 'Value': 12 },'Severity': 'critical', 'AzNsNotification': { 'GroupIds': ['subscriptions/1234a45-123d-4321-12aa-123b12a5678/resourcegroups/my-resource-group/providers/microsoft.insights/actiongroups/test-actiongroup'] } } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/myAzNsaction?api-version=2015-03-20 $AzNsJson

Acties aanpassen

Standaard volgen acties de standaardsjablonen en indeling voor meldingen. Maar u kunt bepaalde acties aanpassen, zelfs als ze worden beheerd door actiegroepen. Op dit moment is aanpassing mogelijk voor EmailSubject en WebhookPayload.

EmailSubject aanpassen voor een actiegroep

Het e-mailonderwerp voor waarschuwingen is standaard Waarschuwingsmelding <AlertName> voor <WorkspaceName>. Maar het onderwerp kan worden aangepast zodat u woorden of tags kunt opgeven, om het mogelijk te maken dat u eenvoudig filterregels in uw Postvak IN kunt toepassen. De details van de aangepaste e-mailheader moeten samen met ActionGroup details worden verzonden, zoals in het volgende voorbeeld:

"etag": "W/\"datetime'2017-12-13T10%3A52%3A21.1697364Z'\"",
"properties": {
   "Type": "Alert",
   "Name": "test-alert",
   "Description": "I need to put a description here",
   "Threshold": {
      "Operator": "gt",
      "Value": 12
   },
   "AzNsNotification": {
      "GroupIds": [
         "/subscriptions/1234a45-123d-4321-12aa-123b12a5678/resourcegroups/my-resource-group/providers/microsoft.insights/actiongroups/test-actiongroup"
      ],
      "CustomEmailSubject": "Azure Alert fired"
   },
   "Severity": "critical",
   "Version": 1
}

Gebruik de methode Put met een unieke actie-id om een bestaande actiegroep te koppelen aan aanpassing voor een planning. In het volgende voorbeeld ziet u het gebruik:

$AzNsJson = "{'properties': { 'Name': 'test-alert', 'Version':'1', 'Type':'Alert', 'Threshold': { 'Operator': 'gt', 'Value': 12 },'Severity': 'critical', 'AzNsNotification': {'GroupIds': ['subscriptions/1234a45-123d-4321-12aa-123b12a5678/resourcegroups/my-resource-group/providers/microsoft.insights/actiongroups/test-actiongroup'], 'CustomEmailSubject': 'Azure Alert fired'} } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/myAzNsaction?api-version=2015-03-20 $AzNsJson

Gebruik de methode Put met een bestaande actie-id om een actiegroep te wijzigen die is gekoppeld aan een planning. De hoofdtekst van de aanvraag moet de etag van de actie bevatten.

$AzNsJson = "{'etag': 'datetime'2017-12-13T10%3A52%3A21.1697364Z'\"', 'properties': { 'Name': 'test-alert', 'Version':'1', 'Type':'Alert', 'Threshold': { 'Operator': 'gt', 'Value': 12 },'Severity': 'critical', 'AzNsNotification': {'GroupIds': ['subscriptions/1234a45-123d-4321-12aa-123b12a5678/resourcegroups/my-resource-group/providers/microsoft.insights/actiongroups/test-actiongroup']}, 'CustomEmailSubject': 'Azure Alert fired' } }"
armclient put /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/Microsoft.OperationalInsights/workspaces/{Workspace Name}/savedSearches/{Search ID}/schedules/{Schedule ID}/actions/myAzNsaction?api-version=2015-03-20 $AzNsJson

WebhookPayload aanpassen voor een actiegroep

De webhook die via een actiegroep voor Log Analytics wordt verzonden, heeft standaard een vaste structuur. Maar u kunt de JSON-nettolading aanpassen met behulp van specifieke variabelen die worden ondersteund om te voldoen aan de vereisten van het webhookeindpunt. Zie de webhookactie voor waarschuwingsregels voor zoeken in logboeken voor meer informatie.

De aangepaste webhookdetails moeten samen met ActionGroup details worden verzonden. Ze worden toegepast op alle webhook-URI's die zijn opgegeven in de actiegroep. In het volgende voorbeeld ziet u het gebruik:

"etag": "W/\"datetime'2017-12-13T10%3A52%3A21.1697364Z'\"",
"properties": {
   "Type": "Alert",
   "Name": "test-alert",
   "Description": "I need to put a description here",
   "Threshold": {
      "Operator": "gt",
      "Value": 12
   },
   "AzNsNotification": {
      "GroupIds": [
         "/subscriptions/1234a45-123d-4321-12aa-123b12a5678/resourcegroups/my-resource-group/providers/microsoft.insights/actiongroups/test-actiongroup"
      ],
   "CustomWebhookPayload": "{\"field1\":\"value1\",\"field2\":\"value2\"}",
   "CustomEmailSubject": "Azure Alert fired"
   },
   "Severity": "critical",
   "Version": 1
},