Alerts - Update

Referência

Serviço:: Authorization

Versão da API:: 2022-08-01-preview

Atualizar um alerta.

PATCH https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleManagementAlerts/{alertId}?api-version=2022-08-01-preview

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
alertId	path	True	string	O nome do alerta a dispensar.
scope	path	True	string	O âmbito do alerta.
api-version	query	True	string	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
properties.isActive	boolean	Falso por predefinição; true se o alerta estiver ativo.

Respostas

Name	Tipo	Description
204 No Content		NoContent – o alerta foi atualizado com êxito.
Other Status Codes	CloudError	Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

DeactivateAlert

Pedido de amostra

PATCH https://management.azure.com/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlerts/TooManyPermanentOwnersAssignedToResource?api-version=2022-08-01-preview

{
  "properties": {
    "isActive": false
  }
}

package armauthorization_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/authorization/armauthorization/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/310a0100f5b020c1900c527a6aa70d21992f078a/specification/authorization/resource-manager/Microsoft.Authorization/preview/2022-08-01-preview/examples/UpdateAlert.json
func ExampleAlertsClient_Update() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armauthorization.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	_, err = clientFactory.NewAlertsClient().Update(ctx, "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f", "TooManyPermanentOwnersAssignedToResource", armauthorization.Alert{
		Properties: &armauthorization.AlertProperties{
			IsActive: to.Ptr(false),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { AuthorizationManagementClient } = require("@azure/arm-authorization");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Update an alert.
 *
 * @summary Update an alert.
 * x-ms-original-file: specification/authorization/resource-manager/Microsoft.Authorization/preview/2022-08-01-preview/examples/UpdateAlert.json
 */
async function deactivateAlert() {
  const scope = "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f";
  const alertId = "TooManyPermanentOwnersAssignedToResource";
  const parameters = { isActive: false };
  const credential = new DefaultAzureCredential();
  const client = new AuthorizationManagementClient(credential);
  const result = await client.alerts.update(scope, alertId, parameters);
  console.log(result);
}

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:: 204

Definições

Name	Description
Alert	O alerta.
AlertConfiguration	Configuração de alertas.
AlertDefinition	Definição de alerta
AlertIncident	Incidente de alerta
CloudError	Uma resposta de erro do serviço.
CloudErrorBody	Uma resposta de erro do serviço.
SeverityLevel	Nível de gravidade do alerta.

Alert

O alerta.

Name	Tipo	Description
id	string	O ID do alerta.
name	string	O nome do alerta.
properties.alertConfiguration	AlertConfiguration	A configuração do alerta.
properties.alertDefinition	AlertDefinition	A definição de alerta.
properties.alertIncidents	AlertIncident[]	Os incidentes de alerta.
properties.incidentCount	integer	O número de incidentes gerados do alerta.
properties.isActive	boolean	Falso por predefinição; true se o alerta estiver ativo.
properties.lastModifiedDateTime	string	A data em que a configuração do alerta foi atualizada ou foram gerados novos incidentes.
properties.lastScannedDateTime	string	A data em que o alerta foi analisado pela última vez.
properties.scope	string	O âmbito do alerta.
type	string	O tipo de alerta.

AlertConfiguration

Configuração de alertas.

Name	Tipo	Description
id	string	O ID de configuração do alerta.
name	string	O nome da configuração do alerta.
properties.alertConfigurationType	string	O tipo de configuração de alerta.
properties.alertDefinition	AlertDefinition	A definição de alerta.
properties.alertDefinitionId	string	O ID de definição de alerta.
properties.isEnabled	boolean	Verdadeiro se o alerta estiver ativado, falso desativará a análise do alerta específico.
properties.scope	string	O âmbito do alerta.
type	string	O tipo de configuração de alerta.

AlertDefinition

Definição de alerta

Name	Tipo	Description
id	string	O ID de definição de alerta.
name	string	O nome da definição de alerta.
properties.description	string	A descrição do alerta.
properties.displayName	string	O nome a apresentar do alerta.
properties.howToPrevent	string	As formas de impedir o alerta.
properties.isConfigurable	boolean	Verdadeiro se a configuração do alerta puder ser configurada; falso, caso contrário.
properties.isRemediatable	boolean	Verdadeiro se o alerta puder ser remediado; falso, caso contrário.
properties.mitigationSteps	string	Os métodos para mitigar o alerta.
properties.scope	string	O âmbito do alerta.
properties.securityImpact	string	Impacto de segurança do alerta.
properties.severityLevel	SeverityLevel	Nível de gravidade do alerta.
type	string	O tipo de definição de alerta.

AlertIncident

Incidente de alerta

Name	Tipo	Description
id	string	O ID do incidente do alerta.
name	string	O nome do incidente de alerta.
properties.alertIncidentType	string	O tipo de incidente de alerta.
type	string	O tipo de incidente de alerta.

CloudError

Uma resposta de erro do serviço.

Name	Tipo	Description
error	CloudErrorBody	Uma resposta de erro do serviço.

CloudErrorBody