Alerts - Change State Tenant

Service:: Monitor

Version d'API:: 2025-05-25-preview

Modifier l’état d’une alerte.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
alertId	path	True	string	ID unique d’une instance d’alerte.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.
newState	query	True	AlertState	Nouvel état d’alerte.

Corps de la demande

Nom	Type	Description
comments	string

Réponses

Nom	Type	Description
200 OK	Alert	L’opération Azure s’est terminée avec succès.
Other Status Codes	AlertsManagementErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

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

Exemple de réponse

Code d’état:: 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"
    }
  }
}

Définitions

Nom	Description
ActionStatus	Statut de l’action
Alert	Alerte créée dans le service de gestion des alertes.
AlertProperties	Alerte sac de propriété
AlertsManagementErrorResponse	Une réponse d’erreur du service.
AlertState
Comments	Modifier la raison de l’état d’alerte
ErrorResponseBody	Détails de la réponse d’erreur.
Essentials	Cet objet contient des champs cohérents entre différents services de surveillance.
MonitorCondition
MonitorService
Severity
SignalType	Type de signal sur lequel l’alerte est basée, il peut s’agir de métriques, de journaux ou de journaux d’activité.

ActionStatus

Objet

Statut de l’action

Nom	Type	Description
isSuppressed	boolean	Valeur indiquant si l’alerte est supprimée.

Alert

Objet

Alerte créée dans le service de gestion des alertes.

Nom	Type	Description
id	string	ID de ressource Azure
name	string	Nom de la ressource Azure
properties	AlertProperties	Alerte sac de propriété
type	string	Type de ressource Azure

AlertProperties

Objet

Alerte sac de propriété

Nom	Type	Description
context		Informations spécifiques au service de surveillance qui fournissent des détails plus contextuels sur l’alerte.
customProperties	object	Propriétés personnalisées pouvant contenir n’importe quelle paire clé-valeur définie par l’utilisateur
egressConfig		Config qui serait utilisé pour afficher les données dans le portail.
essentials	Essentials	Cet objet contient des champs cohérents entre différents services de surveillance.

AlertsManagementErrorResponse

Objet

Une réponse d’erreur du service.

Nom	Type	Description
error	ErrorResponseBody	Détails de la réponse d’erreur.

AlertState

Énumération

Valeur	Description
New	New
Acknowledged	Reconnu
Closed	Fermé

Comments

Objet

Modifier la raison de l’état d’alerte

Nom	Type	Description
comments	string

ErrorResponseBody

Objet

Détails de la réponse d’erreur.

Nom	Type	Description
code	string	Code d’erreur, destiné à être utilisé par programmation.
details	ErrorResponseBody[]	Une liste de détails supplémentaires sur l’erreur.
message	string	Description de l’erreur, destinée à être affichée dans l’interface utilisateur.
target	string	Cible de l’erreur particulière, par exemple le nom de la propriété.

Essentials

Objet

Cet objet contient des champs cohérents entre différents services de surveillance.

Nom	Type	Description
actionStatus	ActionStatus	Statut de l’action
alertRule	string	Rule(monitor) qui a déclenché l’instance d’alerte. Selon le service de surveillance, il s’agit de l’identifiant ARM ou du nom de la règle.
alertState	AlertState	État de l’objet d’alerte, qui peut être modifié par l’utilisateur.
description	string	Description de l’alerte.
lastModifiedDateTime	string (date-time)	Heure de la dernière modification (format ISO-8601) de l’instance d’alerte.
lastModifiedUserName	string	L’utilisateur qui a modifié l’alerte en dernier, en cas de mises à jour du service de surveillance, serait 'système', sinon le nom de l’utilisateur.
monitorCondition	MonitorCondition	Peut être « Déclenché » ou « Résolu », ce qui indique si les conditions sous-jacentes ont dépassé les seuils de règle d’alerte définis.
monitorConditionResolvedDateTime	string (date-time)	Heure résolue (format ISO-8601) de l’instance d’alerte. Celle-ci sera mise à jour lorsque le service de surveillance résoudra l’instance d’alerte, car la condition de règle n’est plus remplie.
monitorService	MonitorService	Service de surveillance sur lequel la règle (monitor) est définie.
severity	Severity	Gravité de l’alerte Sev0 étant la plus élevée et Sev4 étant la plus faible.
signalType	SignalType	Type de signal sur lequel l’alerte est basée, il peut s’agir de métriques, de journaux ou de journaux d’activité.
smartGroupId	string	Identifiant unique du groupe intelligent
smartGroupingReason	string	Raison détaillée décrivant la raison pour laquelle cette instance d’alerte est ajoutée à un groupe intelligent
sourceCreatedId	string	Identifiant unique créé par le service de surveillance pour chaque instance d’alerte. Cela pourrait être utilisé pour suivre le problème au service de surveillance, dans le cas de Nagios, Zabbix, SCOM, etc.
startDateTime	string (date-time)	Heure de création (format ISO-8601) de l’instance d’alerte.
targetResource	string	Ressource ARM cible, sur laquelle l’alerte a été créée.
targetResourceGroup	string	Groupe de ressources de la ressource ARM cible, sur lequel l’alerte a été créée.
targetResourceName	string	Nom de la ressource ARM cible, sur laquelle l’alerte a été créée.
targetResourceType	string	Type de ressource de la ressource ARM cible, sur laquelle l’alerte a été créée.

MonitorCondition

Énumération

Valeur	Description
Fired	Licencié
Resolved	Résolu

MonitorService

Énumération

Valeur	Description
Application Insights	Application Insights
ActivityLog Administrative	Administratif ActivityLog
ActivityLog Security	Sécurité ActivityLog
ActivityLog Recommendation	Recommandation ActivityLog
ActivityLog Policy	Politique ActivityLog
ActivityLog Autoscale	ActivityLog Autoscale
Log Analytics	Log Analytics
Nagios	Nagios
Platform	Platform
SCOM	SCOM
ServiceHealth	ServiceHealth
SmartDetector	SmartDetector
VM Insights	Aperçus sur les machines virtuelles
Zabbix	Zabbix
Resource Health	Resource Health

Severity

Énumération

Valeur	Description
Sev0	Sev0
Sev1	Sev1
Sev2	Sev2
Sev3	Sev3
Sev4	Sev4

SignalType

Énumération

Type de signal sur lequel l’alerte est basée, il peut s’agir de métriques, de journaux ou de journaux d’activité.

Valeur	Description
Metric	Unité de mesure
Log	Log
Unknown	Inconnu

Partager via

Alerts - Change State Tenant

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Resolve

Exemple de requête

Exemple de réponse

Définitions

ActionStatus

Alert

AlertProperties

AlertsManagementErrorResponse

AlertState

Comments

ErrorResponseBody

Essentials

MonitorCondition

MonitorService

Severity

SignalType