Alerts - Change State Tenant

Služba:: Monitor

Verze rozhraní API:: 2025-05-25-preview

Změňte stav výstrahy.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
alertId	path	True	string	Jedinečné ID instance upozornění.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
newState	query	True	AlertState	Nový stav výstrahy.

Text požadavku

Name	Typ	Description
comments	string

Odpovědi

Name	Typ	Description
200 OK	Alert	Operace Azure byla úspěšně dokončena.
Other Status Codes	AlertsManagementErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

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

Ukázková odpověď

Stavový kód:: 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"
    }
  }
}

Definice

Name	Description
ActionStatus	Stav akce
Alert	Výstraha vytvořená ve službě správy výstrah.
AlertProperties	Výstražná taška s nemovitostmi
AlertsManagementErrorResponse	Chybová odpověď ze služby.
AlertState
Comments	Změna důvodu stavu výstrahy
ErrorResponseBody	Podrobnosti o chybové odpovědi.
Essentials	Tento objekt obsahuje konzistentní pole napříč různými službami monitorování.
MonitorCondition
MonitorService
Severity
SignalType	Typ signálu, na kterém je výstraha založená, což mohou být metriky, protokoly nebo protokoly aktivit.

ActionStatus

Objekt

Stav akce

Name	Typ	Description
isSuppressed	boolean	Hodnota označující, zda je výstraha potlačena.

Alert

Objekt

Výstraha vytvořená ve službě správy výstrah.

Name	Typ	Description
id	string	ID prostředku Azure
name	string	Název prostředku Azure
properties	AlertProperties	Výstražná taška s nemovitostmi
type	string	Typ prostředku Azure

AlertProperties

Objekt

Výstražná taška s nemovitostmi

Name	Typ	Description
context		Informace specifické pro službu monitorování, které poskytují více kontextových podrobností o výstraze.
customProperties	object	Vlastní vlastnosti, které mohou obsahovat libovolné uživatelem definované páry klíč-hodnota
egressConfig		Konfigurace, která by byla použita pro zobrazení dat v portálu.
essentials	Essentials	Tento objekt obsahuje konzistentní pole napříč různými službami monitorování.

AlertsManagementErrorResponse

Objekt

Chybová odpověď ze služby.

Name	Typ	Description
error	ErrorResponseBody	Podrobnosti o chybové odpovědi.

AlertState

Výčet

Hodnota	Description
New	Nové
Acknowledged	Uznáno
Closed	Zavřeno

Comments

Objekt

Změna důvodu stavu výstrahy

Name	Typ	Description
comments	string

ErrorResponseBody

Objekt

Podrobnosti o chybové odpovědi.

Name	Typ	Description
code	string	Kód chyby, který je určen k programovému využití.
details	ErrorResponseBody[]	Seznam dalších podrobností o chybě.
message	string	Popis chyby, určený pro zobrazení v uživatelském rozhraní.
target	string	Cíl konkrétní chyby, například název vlastnosti.

Essentials

Objekt

Tento objekt obsahuje konzistentní pole napříč různými službami monitorování.

Name	Typ	Description
actionStatus	ActionStatus	Stav akce
alertRule	string	Pravidlo (monitor), které spustilo instanci upozornění. V závislosti na službě monitorování by to bylo ID ARM nebo název pravidla.
alertState	AlertState	Stav objektu výstrahy, který může uživatel upravit.
description	string	Popis upozornění.
lastModifiedDateTime	string (date-time)	Čas poslední změny (formát ISO-8601) instance výstrahy.
lastModifiedUserName	string	Uživatel, který naposledy upravil upozornění, v případě aktualizace služby sledování by byl uživatelem 'system', jinak jméno uživatele.
monitorCondition	MonitorCondition	Může být aktivována nebo vyřešena, což znamená, zda základní podmínky překročily definované prahové hodnoty pravidel upozornění.
monitorConditionResolvedDateTime	string (date-time)	Čas vyřešení (formát ISO-8601) instance výstrahy. To se aktualizuje, když služba monitorování vyřeší instanci výstrahy, protože podmínka pravidla již není splněna.
monitorService	MonitorService	Monitor služby, na které je nastaveno pravidlo (monitor).
severity	Severity	Závažnost výstrahy Sev0 je nejvyšší a Sev4 je nejnižší.
signalType	SignalType	Typ signálu, na kterém je výstraha založená, což mohou být metriky, protokoly nebo protokoly aktivit.
smartGroupId	string	Jedinečné ID smart skupiny
smartGroupingReason	string	Podrobný důvod popisující důvod, proč je tato instance výstrahy přidána do smart skupiny
sourceCreatedId	string	Jedinečné ID vytvořené službou monitorování pro každou instanci upozornění. To by mohlo být použito ke sledování problému v monitorovacím servisu, v případě Nagiosu, Zabbixu, SCOM atd.
startDateTime	string (date-time)	Čas vytvoření (formát ISO-8601) instance výstrahy.
targetResource	string	Cílový prostředek ARM, na kterém byla vytvořena výstraha.
targetResourceGroup	string	Skupina prostředků cílového ARM zdroje, na kterém byla výstraha vytvořena.
targetResourceName	string	Název cílového ARM zdroje, na kterém byla výstraha vytvořena.
targetResourceType	string	Typ zdroje cílového ARM zdroje, na kterém byla výstraha vytvořena.

MonitorCondition

Výčet

Hodnota	Description
Fired	Propuštěn
Resolved	Vyřešeno

MonitorService

Výčet

Hodnota	Description
Application Insights	Application Insights
ActivityLog Administrative	Správa ActivityLog
ActivityLog Security	ActivityLog Security
ActivityLog Recommendation	Doporučení ActivityLog
ActivityLog Policy	Politika ActivityLog
ActivityLog Autoscale	ActivityLog Autoscale
Log Analytics	Analýza protokolů
Nagios	Nagios
Platform	Platforma
SCOM	SCOM
ServiceHealth	ServiceHealth
SmartDetector	SmartDetector
VM Insights	Analýza virtuálních počítačů
Zabbix	Zabbix
Resource Health	Resource Health

Severity

Výčet

Hodnota	Description
Sev0	Sev0
Sev1	Sev1
Sev2	Sev2
Sev3	Sev3
Sev4	Sev4

SignalType

Výčet

Typ signálu, na kterém je výstraha založená, což mohou být metriky, protokoly nebo protokoly aktivit.

Hodnota	Description
Metric	Ukazatel
Log	Log
Unknown	Neznámý

Sdílet prostřednictvím

Alerts - Change State Tenant

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Resolve

Ukázkový požadavek

Ukázková odpověď

Definice

ActionStatus

Alert

AlertProperties

AlertsManagementErrorResponse

AlertState

Comments

ErrorResponseBody

Essentials

MonitorCondition

MonitorService

Severity

SignalType