Alerts - Change State Tenant

Serviço:: Monitor

Versão da API:: 2025-05-25-preview

Altere o estado de um alerta.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
alertId	path	True	string	ID exclusiva de uma instância de alerta.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.
newState	query	True	AlertState	Novo estado do alerta.

Corpo da solicitação

Nome	Tipo	Description
comments	string

Respostas

Nome	Tipo	Description
200 OK	Alert	A operação do Azure foi concluída com êxito.
Other Status Codes	AlertsManagementErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Resposta de exemplo

Código de 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"
    }
  }
}

Definições

Nome	Description
ActionStatus	Status da ação
Alert	Um alerta criado no serviço de gerenciamento de alertas.
AlertProperties	Recipiente de propriedades de alerta
AlertsManagementErrorResponse	Uma resposta de erro do serviço.
AlertState
Comments	Alterar o motivo do estado de alerta
ErrorResponseBody	Detalhes da resposta de erro.
Essentials	Esse objeto contém campos consistentes em diferentes serviços de monitor.
MonitorCondition
MonitorService
Severity
SignalType	O tipo de sinal no qual o alerta se baseia, que pode ser métricas, logs ou logs de atividades.

ActionStatus

Objeto

Status da ação

Nome	Tipo	Description
isSuppressed	boolean	Valor que indica se o alerta foi suprimido.

Alert

Objeto

Um alerta criado no serviço de gerenciamento de alertas.

Nome	Tipo	Description
id	string	ID de recurso do Azure
name	string	Nome do recurso do Azure
properties	AlertProperties	Recipiente de propriedades de alerta
type	string	Tipo de recurso do Azure

AlertProperties

Objeto

Recipiente de propriedades de alerta

Nome	Tipo	Description
context		Informações específicas do serviço de monitor que fornecem mais detalhes contextuais sobre o alerta.
customProperties	object	Propriedades personalizadas que podem conter qualquer par de valores-chave definido pelo usuário
egressConfig		Configuração que seria usada para exibir os dados no portal.
essentials	Essentials	Esse objeto contém campos consistentes em diferentes serviços de monitor.

AlertsManagementErrorResponse

Objeto

Uma resposta de erro do serviço.

Nome	Tipo	Description
error	ErrorResponseBody	Detalhes da resposta de erro.

AlertState

Enumeração

Valor	Description
New	New
Acknowledged	Entendido
Closed	Fechado

Comments

Objeto

Alterar o motivo do estado de alerta

Nome	Tipo	Description
comments	string

ErrorResponseBody

Objeto

Detalhes da resposta de erro.

Nome	Tipo	Description
code	string	Código de erro, destinado a ser consumido programaticamente.
details	ErrorResponseBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Descrição do erro, destinado à exibição na interface do usuário.
target	string	Destino do erro específico, por exemplo, nome da propriedade.

Essentials

Objeto

Esse objeto contém campos consistentes em diferentes serviços de monitor.

Nome	Tipo	Description
actionStatus	ActionStatus	Status da ação
alertRule	string	Regra (monitor) que disparou a instância de alerta. Dependendo do serviço do monitor, isso seria a ID do ARM ou o nome da regra.
alertState	AlertState	Estado do objeto de alerta, que pode ser modificado pelo usuário.
description	string	Descrição de alerta.
lastModifiedDateTime	string (date-time)	Hora da última modificação (formato ISO-8601) da instância de alerta.
lastModifiedUserName	string	Usuário que modificou o alerta pela última vez, no caso de atualizações do serviço de monitoramento, o usuário seria 'sistema', caso contrário, nome do usuário.
monitorCondition	MonitorCondition	Pode ser 'Disparado' ou 'Resolvido', o que representa se as condições subjacentes ultrapassaram os limites de regra de alerta definidos.
monitorConditionResolvedDateTime	string (date-time)	Tempo resolvido (formato ISO-8601) da instância de alerta. Isso será atualizado quando o serviço de monitor resolver a instância de alerta porque a condição da regra não é mais atendida.
monitorService	MonitorService	Serviço de monitor no qual a regra (monitor) está definida.
severity	Severity	A gravidade do alerta Sev0 é a mais alta e a Sev4 é a mais baixa.
signalType	SignalType	O tipo de sinal no qual o alerta se baseia, que pode ser métricas, logs ou logs de atividades.
smartGroupId	string	ID exclusivo do grupo inteligente
smartGroupingReason	string	Motivo detalhado que descreve o motivo pelo qual essa instância de alerta é adicionada a um grupo inteligente
sourceCreatedId	string	ID exclusiva criada pelo serviço de monitor para cada instância de alerta. Isso pode ser usado para rastrear o problema no serviço de monitoramento, no caso de Nagios, Zabbix, SCOM etc.
startDateTime	string (date-time)	Hora de criação (formato ISO-8601) da instância de alerta.
targetResource	string	Recurso do ARM de destino, no qual o alerta foi criado.
targetResourceGroup	string	Grupo de recursos do recurso do ARM de destino, no qual o alerta foi criado.
targetResourceName	string	Nome do nome do recurso do ARM de destino, no qual o alerta foi criado.
targetResourceType	string	Tipo de recurso do recurso do ARM de destino, no qual o alerta foi criado.

MonitorCondition

Enumeração

Valor	Description
Fired	Demitido
Resolved	Resolvido

MonitorService

Enumeração

Valor	Description
Application Insights	Application Insights
ActivityLog Administrative	ActivityLog Administrativo
ActivityLog Security	Segurança do ActivityLog
ActivityLog Recommendation	Recomendação do ActivityLog
ActivityLog Policy	Política do ActivityLog
ActivityLog Autoscale	Autoescala do ActivityLog
Log Analytics	Análise de Logs
Nagios	Nagios
Platform	Platform
SCOM	SCOM
ServiceHealth	ServiceHealth
SmartDetector	SmartDetector
VM Insights	VM Insights
Zabbix	Zabbix
Resource Health	Resource Health

Severity

Enumeração

Valor	Description
Sev0	Sev0
Sev1	Sev1
Sev2	Sev2
Sev3	Sev3
Sev4	Sev4

SignalType

Enumeração

O tipo de sinal no qual o alerta se baseia, que pode ser métricas, logs ou logs de atividades.

Valor	Description
Metric	Métrica
Log	Log
Unknown	Unknown

Compartilhar via

Alerts - Change State Tenant

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Resolve

Solicitação de exemplo

Resposta de exemplo

Definições

ActionStatus

Alert

AlertProperties

AlertsManagementErrorResponse

AlertState

Comments

ErrorResponseBody

Essentials

MonitorCondition

MonitorService

Severity

SignalType