Alerts - Change State Tenant

Layanan:: Monitor

Versi API:: 2025-05-25-preview

Ubah status peringatan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
alertId	path	True	string	ID unik dari instans pemberitahuan.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
newState	query	True	AlertState	Status peringatan baru.

Isi Permintaan

Nama	Jenis	Deskripsi
comments	string

Respons

Nama	Jenis	Deskripsi
200 OK	Alert	Operasi Azure berhasil diselesaikan.
Other Status Codes	AlertsManagementErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

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

Respon sampel

Kode status:: 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"
    }
  }
}

Definisi

Nama	Deskripsi
ActionStatus	Status tindakan
Alert	Pemberitahuan yang dibuat di layanan manajemen pemberitahuan.
AlertProperties	Tas properti peringatan
AlertsManagementErrorResponse	Respons kesalahan dari layanan.
AlertState
Comments	Mengubah alasan status peringatan
ErrorResponseBody	Detail respons kesalahan.
Essentials	Objek ini berisi bidang yang konsisten di berbagai layanan monitor.
MonitorCondition
MonitorService
Severity
SignalType	Jenis sinyal yang menjadi dasar peringatan, yang bisa berupa metrik, log, atau log aktivitas.

ActionStatus

Objek

Status tindakan

Nama	Jenis	Deskripsi
isSuppressed	boolean	Nilai yang menunjukkan apakah pemberitahuan ditekan.

Alert

Objek

Pemberitahuan yang dibuat di layanan manajemen pemberitahuan.

Nama	Jenis	Deskripsi
id	string	ID sumber daya Azure
name	string	Nama sumber daya Azure
properties	AlertProperties	Tas properti peringatan
type	string	Jenis sumber daya Azure

AlertProperties

Objek

Tas properti peringatan

Nama	Jenis	Deskripsi
context		Informasi khusus untuk layanan monitor yang memberikan detail kontekstual lainnya tentang pemberitahuan.
customProperties	object	Properti kustom yang dapat menampung pasangan kunci-nilai yang ditentukan pengguna
egressConfig		Konfigurasi yang akan digunakan untuk menampilkan data di portal.
essentials	Essentials	Objek ini berisi bidang yang konsisten di berbagai layanan monitor.

AlertsManagementErrorResponse

Objek

Respons kesalahan dari layanan.

Nama	Jenis	Deskripsi
error	ErrorResponseBody	Detail respons kesalahan.

AlertState

Enumerasi

Nilai	Deskripsi
New	Baru
Acknowledged	Diakui
Closed	Tertutup

Comments

Objek

Mengubah alasan status peringatan

Nama	Jenis	Deskripsi
comments	string

ErrorResponseBody

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan, dimaksudkan untuk digunakan secara terprogram.
details	ErrorResponseBody[]	Daftar detail tambahan tentang kesalahan.
message	string	Deskripsi kesalahan, dimaksudkan untuk ditampilkan di antarmuka pengguna.
target	string	Target kesalahan tertentu, misalnya nama properti.

Essentials

Objek

Objek ini berisi bidang yang konsisten di berbagai layanan monitor.

Nama	Jenis	Deskripsi
actionStatus	ActionStatus	Status tindakan
alertRule	string	Rule(monitor) yang memicu instance peringatan. Tergantung pada layanan monitor, ini akan menjadi id ARM atau nama aturan.
alertState	AlertState	Status objek peringatan, yang dapat dimodifikasi oleh pengguna.
description	string	Deskripsi peringatan.
lastModifiedDateTime	string (date-time)	Waktu modifikasi terakhir (format ISO-8601) dari instans peringatan.
lastModifiedUserName	string	Pengguna yang terakhir memodifikasi peringatan, dalam hal memantau pembaruan layanan pengguna akan menjadi 'sistem', jika tidak, nama pengguna.
monitorCondition	MonitorCondition	Dapat berupa 'Dipecat' atau 'Diselesaikan', yang mewakili apakah kondisi yang mendasarinya telah melewati ambang batas aturan pemberitahuan yang ditentukan.
monitorConditionResolvedDateTime	string (date-time)	Waktu yang diselesaikan (format ISO-8601) instans peringatan. Ini akan diperbarui saat layanan monitor menyelesaikan instans pemberitahuan karena kondisi aturan tidak lagi terpenuhi.
monitorService	MonitorService	Memantau layanan tempat aturan(monitor) ditetapkan.
severity	Severity	Tingkat keparahan peringatan Sev0 tertinggi dan Sev4 terendah.
signalType	SignalType	Jenis sinyal yang menjadi dasar peringatan, yang bisa berupa metrik, log, atau log aktivitas.
smartGroupId	string	ID unik grup pintar
smartGroupingReason	string	Alasan bertele-tele yang menjelaskan alasan mengapa instans pemberitahuan ini ditambahkan ke grup pintar
sourceCreatedId	string	Id unik yang dibuat oleh layanan monitor untuk setiap instans pemberitahuan. Ini dapat digunakan untuk melacak masalah di layanan monitor, dalam kasus Nagios, Zabbix, SCOM dll.
startDateTime	string (date-time)	Waktu pembuatan (format ISO-8601) instans peringatan.
targetResource	string	Target sumber daya ARM, di mana pemberitahuan dibuat.
targetResourceGroup	string	Grup sumber daya sumber daya ARM target, di mana pemberitahuan dibuat.
targetResourceName	string	Nama nama sumber daya ARM target, tempat pemberitahuan dibuat.
targetResourceType	string	Jenis sumber daya sumber daya ARM target, di mana pemberitahuan dibuat.

MonitorCondition

Enumerasi

Nilai	Deskripsi
Fired	Dipecat
Resolved	Diselesaikan

MonitorService

Enumerasi

Nilai	Deskripsi
Application Insights	Application Insights
ActivityLog Administrative	Administratif ActivityLog
ActivityLog Security	Keamanan ActivityLog
ActivityLog Recommendation	Rekomendasi ActivityLog
ActivityLog Policy	Kebijakan ActivityLog
ActivityLog Autoscale	Skala Otomatis ActivityLog
Log Analytics	Log Analytics
Nagios	Nagios
Platform	Platform
SCOM	SCOM
ServiceHealth	ServiceHealth
SmartDetector	Detektor Cerdas
VM Insights	Wawasan VM
Zabbix	Zabbix
Resource Health	Resource Health

Severity

Enumerasi

Nilai	Deskripsi
Sev0	Sev0
Sev1	Sev1
Sev2	Sev2
Sev3	Sev3
Sev4	Sev4

SignalType

Enumerasi

Jenis sinyal yang menjadi dasar peringatan, yang bisa berupa metrik, log, atau log aktivitas.

Nilai	Deskripsi
Metric	Ukuran
Log	Log
Unknown	Unknown

Bagikan melalui

Alerts - Change State Tenant

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

Resolve

Permintaan sampel

Respon sampel

Definisi

ActionStatus

Alert

AlertProperties

AlertsManagementErrorResponse

AlertState

Comments

ErrorResponseBody

Essentials

MonitorCondition

MonitorService

Severity

SignalType