Alerts - Change State Tenant

Service:: Monitor

API-versie:: 2025-05-25-preview

Wijzig de status van een waarschuwing.

POST https://management.azure.com/providers/Microsoft.AlertsManagement/alerts/{alertId}/changestate?api-version=2025-05-25-preview&newState={newState}

URI-parameters

Name	In	Vereist	Type	Description
alertId	path	True	string	Unieke id van een waarschuwingsexemplaar.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
newState	query	True	AlertState	Nieuwe status van de waarschuwing.

Aanvraagbody

Name	Type	Description
comments	string

Antwoorden

Name	Type	Description
200 OK	Alert	Azure-bewerking is voltooid.
Other Status Codes	AlertsManagementErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Resolve

POST https://management.azure.com/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502100/changestate?api-version=2025-05-25-preview&newState=Acknowledged

package armalertsmanagement_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/alertsmanagement/armalertsmanagement"
)

// Generated from example definition: 2025-05-25-preview/Alerts_ChangeStateTenant.json
func ExampleAlertsClient_ChangeStateTenant() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armalertsmanagement.NewClientFactory("<scope>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAlertsClient().ChangeStateTenant(ctx, "66114d64-d9d9-478b-95c9-b789d6502100", armalertsmanagement.AlertStateAcknowledged, &armalertsmanagement.AlertsClientChangeStateTenantOptions{
		Comment: &armalertsmanagement.Comments{}})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armalertsmanagement.AlertsClientChangeStateTenantResponse{
	// 	Alert: &armalertsmanagement.Alert{
	// 		Name: to.Ptr("cpu alert"),
	// 		Type: to.Ptr("Microsoft.AlertsManagement/alerts"),
	// 		ID: to.Ptr("/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight/providers/Microsoft.AlertsManagement/alerts/66114d64-d9d9-478b-95c9-b789d6502100"),
	// 		Properties: &armalertsmanagement.AlertProperties{
	// 			Context: map[string]any{
	// 			},
	// 			EgressConfig: map[string]any{
	// 			},
	// 			Essentials: &armalertsmanagement.Essentials{
	// 				Description: to.Ptr("description of the alert"),
	// 				ActionStatus: &armalertsmanagement.ActionStatus{
	// 					IsSuppressed: to.Ptr(false),
	// 				},
	// 				AlertRule: to.Ptr("https://servisdfsdfappinsight.portal.mms.microsoft.com/#Workspace/overview/settings/details/Edit Alert Rule/details/index?savedSearchId=&scheduleId="),
	// 				AlertState: to.Ptr(armalertsmanagement.AlertStateAcknowledged),
	// 				LastModifiedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-09-13T15:51:02Z"); return t}()),
	// 				LastModifiedUserName: to.Ptr("System"),
	// 				MonitorCondition: to.Ptr(armalertsmanagement.MonitorConditionFired),
	// 				MonitorConditionResolvedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-09-13T15:51:02Z"); return t}()),
	// 				MonitorService: to.Ptr(armalertsmanagement.MonitorServiceApplicationInsights),
	// 				Severity: to.Ptr(armalertsmanagement.SeveritySev3),
	// 				SignalType: to.Ptr(armalertsmanagement.SignalTypeLog),
	// 				SmartGroupID: to.Ptr("23d6b2ce-8c54-468f-aff0-sd32aebb7e56"),
	// 				SmartGroupingReason: to.Ptr("Occurred frequently with other alerts"),
	// 				SourceCreatedID: to.Ptr("6cd6b2ce-8c54-468f-aff0-9d12aebb7e49"),
	// 				StartDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-09-13T15:51:02Z"); return t}()),
	// 				TargetResource: to.Ptr("/subscriptions/3b540246-808d-4331-99aa-917b808a9166/resourcegroups/servicedeskresourcegroup/providers/microsoft.insights/components/servicedeskappinsight"),
	// 				TargetResourceGroup: to.Ptr("servicedeskresourcegroup"),
	// 				TargetResourceName: to.Ptr("servicedeskappinsight"),
	// 				TargetResourceType: to.Ptr("components"),
	// 			},
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:: 200

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

Definities

Name	Description
ActionStatus	Actiestatus
Alert	Een waarschuwing die is gemaakt in de service voor waarschuwingsbeheer.
AlertProperties	Alert eigendomstas
AlertsManagementErrorResponse	Een foutreactie van de service.
AlertState
Comments	Reden voor wijzigingsstatus
ErrorResponseBody	Details van de reactie op de fout.
Essentials	Dit object bevat consistente velden in verschillende monitorservices.
MonitorCondition
MonitorService
Severity
SignalType	Het type signaal waarop de waarschuwing is gebaseerd, dit kunnen statistieken, logboeken of activiteitenlogboeken zijn.

ActionStatus

Object

Actiestatus

Name	Type	Description
isSuppressed	boolean	Waarde die aangeeft of de waarschuwing is onderdrukt.

Alert

Object

Een waarschuwing die is gemaakt in de service voor waarschuwingsbeheer.

Name	Type	Description
id	string	Azure-resource-id
name	string	Azure-resourcenaam
properties	AlertProperties	Alert eigendomstas
type	string	Type Azure-resource

AlertProperties

Object

Alert eigendomstas

Name	Type	Description
context		Informatie die specifiek is voor de monitorservice en die meer contextuele details over de waarschuwing geeft.
customProperties	object	Aangepaste eigenschappen die alle door de gebruiker gedefinieerde sleutel-waardeparen kunnen bevatten
egressConfig		Configuratie die zou worden gebruikt voor het weergeven van de gegevens in het portaal.
essentials	Essentials	Dit object bevat consistente velden in verschillende monitorservices.

AlertsManagementErrorResponse

Object

Een foutreactie van de service.

Name	Type	Description
error	ErrorResponseBody	Details van de reactie op de fout.

AlertState

Opsomming

Waarde	Description
New	Nieuw
Acknowledged	Bevestigd
Closed	Closed

Comments

Object

Reden voor wijzigingsstatus

Name	Type	Description
comments	string

ErrorResponseBody

Object

Details van de reactie op de fout.

Name	Type	Description
code	string	Foutcode, bedoeld om programmatisch te worden verbruikt.
details	ErrorResponseBody[]	Een lijst met aanvullende details over de fout.
message	string	Beschrijving van de fout, bedoeld voor weergave in de gebruikersinterface.
target	string	Doel van de specifieke fout, bijvoorbeeld de naam van de eigenschap.

Essentials

Object

Dit object bevat consistente velden in verschillende monitorservices.

Name	Type	Description
actionStatus	ActionStatus	Actiestatus
alertRule	string	Regel (monitor) die een alarminstantie heeft geactiveerd. Afhankelijk van de monitorservice is dit de ARM-id of de naam van de regel.
alertState	AlertState	Status van waarschuwingsobject, die door de gebruiker kan worden gewijzigd.
description	string	Beschrijving van waarschuwing.
lastModifiedDateTime	string (date-time)	Laatste wijzigingstijd (ISO-8601-indeling) van de waarschuwingsinstantie.
lastModifiedUserName	string	Gebruiker die de waarschuwing voor het laatst heeft gewijzigd, in het geval van updates van de monitorservice is de gebruiker 'systeem', anders de naam van de gebruiker.
monitorCondition	MonitorCondition	Kan 'Afgevuurd' of 'Opgelost' zijn, wat aangeeft of de onderliggende voorwaarden de gedefinieerde drempels van de waarschuwingsregel hebben overschreden.
monitorConditionResolvedDateTime	string (date-time)	Opgeloste tijd (ISO-8601-indeling) van waarschuwingsinstantie. Dit wordt bijgewerkt wanneer de monitorservice het waarschuwingsexemplaar oplost omdat niet meer aan de regelvoorwaarde wordt voldaan.
monitorService	MonitorService	Monitorservice waarop de regel (monitor) is ingesteld.
severity	Severity	De ernst van de waarschuwing is Sev0 het hoogst en Sev4 het laagst.
signalType	SignalType	Het type signaal waarop de waarschuwing is gebaseerd, dit kunnen statistieken, logboeken of activiteitenlogboeken zijn.
smartGroupId	string	Unieke ID van de smart group
smartGroupingReason	string	Uitgebreide reden die de reden beschrijft waarom dit waarschuwingsexemplaar wordt toegevoegd aan een slimme groep
sourceCreatedId	string	Unieke id die door de monitorservice is gemaakt voor elk waarschuwingsexemplaar. Dit kan worden gebruikt om het probleem op te sporen bij de monitorservice, in het geval van Nagios, Zabbix, SCOM enz.
startDateTime	string (date-time)	Aanmaaktijd (ISO-8601-indeling) van de waarschuwingsinstantie.
targetResource	string	Doel ARM-resource, waarop een waarschuwing is gemaakt.
targetResourceGroup	string	Resourcegroep van de doel-ARM-resource, waarop een waarschuwing is gemaakt.
targetResourceName	string	Naam van de naam van de doel-ARM-resource, waarop de waarschuwing is gemaakt.
targetResourceType	string	Brontype van doel-ARM-resource, waarvoor een waarschuwing is gemaakt.

MonitorCondition

Opsomming

Waarde	Description
Fired	Ontslagen
Resolved	Opgelost

MonitorService

Opsomming

Waarde	Description
Application Insights	Analyses van toepassingen
ActivityLog Administrative	ActivityLog Administratief
ActivityLog Security	ActivityLog Beveiliging
ActivityLog Recommendation	ActivityLog-aanbeveling
ActivityLog Policy	ActivityLog-beleid
ActivityLog Autoscale	ActivityLog Autoscale
Log Analytics	Log Analytics
Nagios	Nagios
Platform	Platform
SCOM	SCOM
ServiceHealth	ServiceHealth
SmartDetector	SmartDetector
VM Insights	VM-Inzichten
Zabbix	Zabbix
Resource Health	Resource Health

Severity

Opsomming

Waarde	Description
Sev0	Sev0
Sev1	Sev1
Sev2	Sev2
Sev3	Sev3
Sev4	Sev4

SignalType

Opsomming

Het type signaal waarop de waarschuwing is gebaseerd, dit kunnen statistieken, logboeken of activiteitenlogboeken zijn.

Waarde	Description
Metric	Metrische gegevens
Log	Log
Unknown	Onbekend

Delen via

Alerts - Change State Tenant

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Resolve

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ActionStatus

Alert

AlertProperties

AlertsManagementErrorResponse

AlertState

Comments

ErrorResponseBody

Essentials

MonitorCondition

MonitorService

Severity

SignalType