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 do URI

Name	Em	Necessário	Tipo	Description
alertId	path	True	string	ID exclusivo de uma instância de alerta.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.
newState	query	True	AlertState	Novo estado de alerta.

Corpo do Pedido

Name	Tipo	Description
comments	string

Respostas

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

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 da amostra

Código de estado:: 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

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

ActionStatus

Object

Estado da ação

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

Alert

Object

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

Name	Tipo	Description
id	string	ID do recurso do Azure
name	string	Nome do recurso do Azure
properties	AlertProperties	Saco de propriedade de alerta
type	string	Tipo de recurso do Azure

AlertProperties

Object

Saco de propriedade de alerta

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

AlertsManagementErrorResponse

Object

Uma resposta de erro do serviço.

Name	Tipo	Description
error	ErrorResponseBody	Detalhes da resposta ao erro.

AlertState

Enumeração

Valor	Description
New	Novo
Acknowledged	Confirmado
Closed	Closed

Comments

Object

Alterar o motivo do estado de alerta

Name	Tipo	Description
comments	string

ErrorResponseBody

Object

Detalhes da resposta ao erro.

Name	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 a exibição na interface do usuário.
target	string	Destino do erro específico, por exemplo, nome da propriedade.

Essentials

Object

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

Name	Tipo	Description
actionStatus	ActionStatus	Estado da ação
alertRule	string	Rule(monitor) que disparou a instância de alerta. Dependendo do serviço de monitor, isso seria ID ARM ou nome da regra.
alertState	AlertState	Estado do objeto de alerta, que pode ser modificado pelo usuário.
description	string	Descrição do 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 monitorar atualizações de serviço usuário seria 'sistema', caso contrário, nome do usuário.
monitorCondition	MonitorCondition	Pode ser 'Acionado' ou 'Resolvido', que representa se as condições subjacentes ultrapassaram os limites da regra de alerta definida.
monitorConditionResolvedDateTime	string (date-time)	Tempo resolvido (formato ISO-8601) da instância de alerta. Isso será atualizado quando o serviço monitor resolver a instância de alerta porque a condição da regra não é mais atendida.
monitorService	MonitorService	Serviço de monitoramento no qual a regra (monitor) está definida.
severity	Severity	A gravidade do alerta é a mais elevada e a Sev4 a mais baixa.
signalType	SignalType	O tipo de sinal em que o alerta se baseia, que pode ser métricas, logs ou registros 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 exclusivo criado pelo serviço de monitor para cada instância de alerta. Isso poderia ser usado para rastrear o problema no serviço de monitor, no caso de Nagios, Zabbix, SCOM etc.
startDateTime	string (date-time)	Tempo de criação (formato ISO-8601) da instância de alerta.
targetResource	string	Recurso ARM de destino, no qual o alerta foi criado.
targetResourceGroup	string	Grupo de recursos do recurso ARM de destino, no qual o alerta foi criado.
targetResourceName	string	Nome do nome do recurso ARM de destino, no qual o alerta foi criado.
targetResourceType	string	Tipo de recurso do recurso ARM de destino, no qual o alerta foi criado.

MonitorCondition

Enumeração

Valor	Description
Fired	Despedido
Resolved	Resolvido

MonitorService

Enumeração

Valor	Description
Application Insights	Application Insights
ActivityLog Administrative	Administração do ActivityLog
ActivityLog Security	Segurança do ActivityLog
ActivityLog Recommendation	Recomendação do ActivityLog
ActivityLog Policy	Política ActivityLog
ActivityLog Autoscale	ActivityLog Autoscale
Log Analytics	Análise de Registos
Nagios	Nagios
Platform	Platform
SCOM	SCOM
ServiceHealth	Saúde do Serviço
SmartDetector	SmartDetector
VM Insights	Análises de VMs
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 em que o alerta se baseia, que pode ser métricas, logs ou registros de atividades.

Valor	Description
Metric	Métrico
Log	Log
Unknown	Desconhecido

Partilhar via

Alerts - Change State Tenant

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Resolve

Pedido de amostra

Resposta da amostra

Definições

ActionStatus

Alert

AlertProperties

AlertsManagementErrorResponse

AlertState

Comments

ErrorResponseBody

Essentials

MonitorCondition

MonitorService

Severity

SignalType