Alerts - Change State Tenant

Servizio:: Monitor

Versione API:: 2025-05-25-preview

Modificare lo stato di un avviso.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
alertId	path	True	string	ID univoco di un'istanza di avviso.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
newState	query	True	AlertState	Nuovo stato dell'avviso.

Corpo della richiesta

Nome	Tipo	Descrizione
comments	string

Risposte

Nome	Tipo	Descrizione
200 OK	Alert	L'operazione di Azure è stata completata correttamente.
Other Status Codes	AlertsManagementErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

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

Risposta di esempio

Codice di stato:: 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"
    }
  }
}

Definizioni

Nome	Descrizione
ActionStatus	Stato dell'azione
Alert	Avviso creato nel servizio di gestione degli avvisi.
AlertProperties	Contenitore delle proprietà di avviso
AlertsManagementErrorResponse	Risposta di errore dal servizio.
AlertState
Comments	Modificare il motivo dello stato di avviso
ErrorResponseBody	Dettagli della risposta all'errore.
Essentials	Questo oggetto contiene campi coerenti tra diversi servizi di monitoraggio.
MonitorCondition
MonitorService
Severity
SignalType	Il tipo di segnale su cui si basa l'avviso, che potrebbe essere metriche, log o log attività.

ActionStatus

Oggetto

Stato dell'azione

Nome	Tipo	Descrizione
isSuppressed	boolean	Valore che indica se l'avviso è stato eliminato.

Alert

Oggetto

Avviso creato nel servizio di gestione degli avvisi.

Nome	Tipo	Descrizione
id	string	ID risorsa di Azure
name	string	Nome risorsa di Azure
properties	AlertProperties	Contenitore delle proprietà di avviso
type	string	Tipo di risorsa di Azure

AlertProperties

Oggetto

Contenitore delle proprietà di avviso

Nome	Tipo	Descrizione
context		Informazioni specifiche del servizio di monitoraggio che forniscono dettagli più contestuali sull'avviso.
customProperties	object	Proprietà personalizzate che possono contenere qualsiasi coppia chiave-valore definita dall'utente
egressConfig		Config che verrebbe utilizzato per visualizzare i dati nel portale.
essentials	Essentials	Questo oggetto contiene campi coerenti tra diversi servizi di monitoraggio.

AlertsManagementErrorResponse

Oggetto

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
error	ErrorResponseBody	Dettagli della risposta all'errore.

AlertState

Enumerazione

Valore	Descrizione
New	Nuovo
Acknowledged	Confermato
Closed	Chiusa

Comments

Oggetto

Modificare il motivo dello stato di avviso

Nome	Tipo	Descrizione
comments	string

ErrorResponseBody

Oggetto

Dettagli della risposta all'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore, destinato a essere utilizzato a livello di codice.
details	ErrorResponseBody[]	Un elenco di dettagli aggiuntivi sull'errore.
message	string	Descrizione dell'errore, destinata alla visualizzazione nell'interfaccia utente.
target	string	Destinazione dell'errore specifico, ad esempio il nome della proprietà.

Essentials

Oggetto

Questo oggetto contiene campi coerenti tra diversi servizi di monitoraggio.

Nome	Tipo	Descrizione
actionStatus	ActionStatus	Stato dell'azione
alertRule	string	Rule(monitor) che ha attivato l'istanza di avviso. A seconda del servizio di monitoraggio, si tratta dell'ID ARM o del nome della regola.
alertState	AlertState	Stato dell'oggetto avviso, che può essere modificato dall'utente.
description	string	Descrizione dell'avviso.
lastModifiedDateTime	string (date-time)	Ora dell'ultima modifica (formato ISO-8601) dell'istanza di avviso.
lastModifiedUserName	string	L'utente che ha modificato per ultimo l'avviso, in caso di monitoraggio degli aggiornamenti del servizio l'utente sarebbe 'system', altrimenti il nome dell'utente.
monitorCondition	MonitorCondition	Può essere "Attivato" o "Risolto", che rappresenta se le condizioni sottostanti hanno superato le soglie definite della regola di avviso.
monitorConditionResolvedDateTime	string (date-time)	Ora risolta (formato ISO-8601) dell'istanza di avviso. Questo verrà aggiornato quando il servizio di monitoraggio risolve l'istanza di avviso perché la condizione della regola non è più soddisfatta.
monitorService	MonitorService	Servizio di monitoraggio su cui è impostata la regola (monitor).
severity	Severity	La gravità dell'avviso Sev0 è il più alto e Sev4 è il più basso.
signalType	SignalType	Il tipo di segnale su cui si basa l'avviso, che potrebbe essere metriche, log o log attività.
smartGroupId	string	ID univoco del gruppo smart
smartGroupingReason	string	Motivo dettagliato che descrive il motivo per cui l'istanza di avviso viene aggiunta a un gruppo smart
sourceCreatedId	string	ID univoco creato dal servizio di monitoraggio per ogni istanza di avviso. Questo potrebbe essere utilizzato per tenere traccia del problema presso il servizio di monitoraggio, nel caso di Nagios, Zabbix, SCOM ecc.
startDateTime	string (date-time)	Ora di creazione (formato ISO-8601) dell'istanza di avviso.
targetResource	string	Risorsa ARM di destinazione, in cui è stato creato l'avviso.
targetResourceGroup	string	Gruppo di risorse della risorsa ARM di destinazione, in cui è stato creato l'avviso.
targetResourceName	string	Nome del nome della risorsa ARM di destinazione, in cui è stato creato l'avviso.
targetResourceType	string	Tipo di risorsa della risorsa ARM di destinazione, in cui è stato creato l'avviso.

MonitorCondition

Enumerazione

Valore	Descrizione
Fired	Licenziato
Resolved	Risolto

MonitorService

Enumerazione

Valore	Descrizione
Application Insights	Approfondimenti sulle Applicazioni
ActivityLog Administrative	Attività Amministrativa
ActivityLog Security	Sicurezza ActivityLog
ActivityLog Recommendation	Raccomandazione ActivityLog
ActivityLog Policy	Politica ActivityLog
ActivityLog Autoscale	Autoscala ActivityLog
Log Analytics	Log Analytics
Nagios	Nagios
Platform	Platform
SCOM	SCOM
ServiceHealth	ServiceHealth
SmartDetector	SmartDetector
VM Insights	Approfondimenti VM
Zabbix	Zabbix
Resource Health	Resource Health

Severity

Enumerazione

Valore	Descrizione
Sev0	Sev0
Sev1	Sev1
Sev2	Sev2
Sev3	Sev3
Sev4	Sev4

SignalType

Enumerazione

Il tipo di segnale su cui si basa l'avviso, che potrebbe essere metriche, log o log attività.

Valore	Descrizione
Metric	Metrica
Log	Log
Unknown	Sconosciuto

Condividi tramite

Alerts - Change State Tenant

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Resolve

Esempio di richiesta

Risposta di esempio

Definizioni

ActionStatus

Alert

AlertProperties

AlertsManagementErrorResponse

AlertState

Comments

ErrorResponseBody

Essentials

MonitorCondition

MonitorService

Severity

SignalType