Alerts - Change State Tenant

Usługa:: Monitor

Wersja interfejsu API:: 2025-05-25-preview

Zmienianie stanu alertu.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
alertId	path	True	string	Unikatowy identyfikator wystąpienia alertu.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
newState	query	True	AlertState	Nowy stan alertu.

Treść żądania

Nazwa	Typ	Opis
comments	string

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Alert	Operacja platformy Azure została zakończona pomyślnie.
Other Status Codes	AlertsManagementErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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

Przykładowa odpowiedź

Kod stanu:: 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"
    }
  }
}

Definicje

Nazwa	Opis
ActionStatus	Stan akcji
Alert	Alert utworzony w usłudze zarządzania alertami.
AlertProperties	Torba z właściwościami alertu
AlertsManagementErrorResponse	Odpowiedź o błędzie z usługi.
AlertState
Comments	Zmienianie przyczyny stanu alertu
ErrorResponseBody	Szczegóły odpowiedzi na błąd.
Essentials	Ten obiekt zawiera spójne pola w różnych usługach monitorowania.
MonitorCondition
MonitorService
Severity
SignalType	Typ sygnału, na podstawie którego jest oparty alert, który może być metrykami, dziennikami lub dziennikami aktywności.

ActionStatus

Objekt

Stan akcji

Nazwa	Typ	Opis
isSuppressed	boolean	Wartość wskazująca, czy alert jest pomijany.

Alert

Objekt

Alert utworzony w usłudze zarządzania alertami.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
name	string	Nazwa zasobu platformy Azure
properties	AlertProperties	Torba z właściwościami alertu
type	string	Typ zasobu platformy Azure

AlertProperties

Objekt

Torba z właściwościami alertu

Nazwa	Typ	Opis
context		Informacje specyficzne dla usługi monitorowania, które zawierają bardziej kontekstowe szczegóły dotyczące alertu.
customProperties	object	Właściwości niestandardowe, które mogą przechowywać dowolne pary klucz-wartość zdefiniowane przez użytkownika
egressConfig		Konfiguracja, która będzie używana do wyświetlania danych w portalu.
essentials	Essentials	Ten obiekt zawiera spójne pola w różnych usługach monitorowania.

AlertsManagementErrorResponse

Objekt

Odpowiedź o błędzie z usługi.

Nazwa	Typ	Opis
error	ErrorResponseBody	Szczegóły odpowiedzi na błąd.

AlertState

Wyliczenie

Wartość	Opis
New	Nowy
Acknowledged	Podziękowane
Closed	Zamknięty

Comments

Objekt

Zmienianie przyczyny stanu alertu

Nazwa	Typ	Opis
comments	string

ErrorResponseBody

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa	Typ	Opis
code	string	Kod błędu, który ma być używany programowo.
details	ErrorResponseBody[]	Lista dodatkowych szczegółów dotyczących błędu.
message	string	Opis błędu, przeznaczony do wyświetlenia w interfejsie użytkownika.
target	string	Cel konkretnego błędu, na przykład nazwa właściwości.

Essentials

Objekt

Ten obiekt zawiera spójne pola w różnych usługach monitorowania.

Nazwa	Typ	Opis
actionStatus	ActionStatus	Stan akcji
alertRule	string	Reguła (monitor), która wyzwoliła wystąpienie alertu. W zależności od usługi monitorowania będzie to identyfikator ARM lub nazwa reguły.
alertState	AlertState	Stan obiektu alertu, który może być modyfikowany przez użytkownika.
description	string	Opis alertu.
lastModifiedDateTime	string (date-time)	Czas ostatniej modyfikacji (format ISO-8601) wystąpienia alertu.
lastModifiedUserName	string	Użytkownik, który jako ostatni zmodyfikował alert, w przypadku aktualizacji usługi monitorowania użytkownikiem będzie "system", w przeciwnym razie nazwa użytkownika.
monitorCondition	MonitorCondition	Może być "Zwolniony" lub "Rozwiązany", co oznacza, czy podstawowe warunki przekroczyły zdefiniowane progi reguły alertu.
monitorConditionResolvedDateTime	string (date-time)	Rozwiązano problem czasu wystąpienia alertu (format ISO-8601). Zostanie to zaktualizowane, gdy usługa monitorowania rozpozna wystąpienie alertu, ponieważ warunek reguły nie jest już spełniony.
monitorService	MonitorService	Usługa monitorowania, w której jest ustawiona reguła (monitor).
severity	Severity	Ważność alertu Sev0 jest najwyższa, a Sev4 jest najniższa.
signalType	SignalType	Typ sygnału, na podstawie którego jest oparty alert, który może być metrykami, dziennikami lub dziennikami aktywności.
smartGroupId	string	Unikatowy identyfikator grupy inteligentnej
smartGroupingReason	string	Pełny powód opisujący powód, dla którego to wystąpienie alertu jest dodawane do grupy inteligentnej
sourceCreatedId	string	Unikatowy identyfikator utworzony przez usługę monitorowania dla każdego wystąpienia alertu. Może to być wykorzystane do śledzenia problemu w usłudze monitorowania, w przypadku Nagios, Zabbix, SCOM itp.
startDateTime	string (date-time)	Czas tworzenia (format ISO-8601) wystąpienia alertu.
targetResource	string	Docelowy zasób usługi ARM, dla którego został utworzony alert.
targetResourceGroup	string	Grupa zasobów docelowego zasobu usługi ARM, dla którego został utworzony alert.
targetResourceName	string	Nazwa docelowego zasobu usługi ARM, na podstawie którego został utworzony alert.
targetResourceType	string	Typ zasobu docelowego zasobu usługi ARM, dla którego został utworzony alert.

MonitorCondition

Wyliczenie

Wartość	Opis
Fired	Zwolniony
Resolved	Rozwiązano

MonitorService

Wyliczenie

Wartość	Opis
Application Insights	Application Insights
ActivityLog Administrative	ActivityLog Administracyjny
ActivityLog Security	Bezpieczeństwo ActivityLog
ActivityLog Recommendation	Rekomendacja ActivityLog
ActivityLog Policy	Polityka ActivityLog
ActivityLog Autoscale	ActivityLog Autoscale
Log Analytics	Analiza dzienników
Nagios	Nagios
Platform	Platforma
SCOM	SCOM
ServiceHealth	ServiceHealth
SmartDetector	SmartDetector
VM Insights	Informacje o VM
Zabbix	Zabbix
Resource Health	Resource Health

Severity

Wyliczenie

Wartość	Opis
Sev0	Sev0
Sev1	Sev1
Sev2	Sev2
Sev3	Sev3
Sev4	Sev4

SignalType

Wyliczenie

Typ sygnału, na podstawie którego jest oparty alert, który może być metrykami, dziennikami lub dziennikami aktywności.

Wartość	Opis
Metric	Wskaźnik
Log	Log
Unknown	Unknown

Udostępnij za pośrednictwem

Alerts - Change State Tenant

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Resolve

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

ActionStatus

Alert

AlertProperties

AlertsManagementErrorResponse

AlertState

Comments

ErrorResponseBody

Essentials

MonitorCondition

MonitorService

Severity

SignalType