Alert Configurations - Update

Servizio:

Authorization

Versione API:

2022-08-01-preview

Aggiornare una configurazione di avviso.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
alertId	path	True	string	Nome della configurazione dell'avviso da aggiornare.
scope	path	True	string	Ambito della configurazione dell'avviso.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.alertConfigurationType	True	string	Tipo di configurazione dell'avviso.
properties.isEnabled		boolean	True se l'avviso è abilitato, false disabilita l'analisi per l'avviso specifico.

Risposte

Nome	Tipo	Descrizione
204 No Content		NoContent: è stato aggiornato correttamente l'avviso.
Other Status Codes	CloudError	Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

UpdateAlertConfiguration

Esempio di richiesta

HTTP

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

{
  "properties": {
    "isEnabled": true,
    "thresholdNumberOfOwners": 2,
    "alertConfigurationType": "TooManyOwnersAssignedToResourceAlertConfiguration"
  }
}

Go

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/UpdateAlertConfiguration.json
func ExampleAlertConfigurationsClient_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.NewAlertConfigurationsClient().Update(ctx, "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f", "TooManyOwnersAssignedToResource", armauthorization.AlertConfiguration{
		Properties: &armauthorization.TooManyOwnersAssignedToResourceAlertConfigurationProperties{
			AlertConfigurationType:  to.Ptr("TooManyOwnersAssignedToResourceAlertConfiguration"),
			IsEnabled:               to.Ptr(true),
			ThresholdNumberOfOwners: to.Ptr[int32](2),
		},
	}, 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

JavaScript

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

/**
 * This sample demonstrates how to Update an alert configuration.
 *
 * @summary Update an alert configuration.
 * x-ms-original-file: specification/authorization/resource-manager/Microsoft.Authorization/preview/2022-08-01-preview/examples/UpdateAlertConfiguration.json
 */
async function updateAlertConfiguration() {
  const scope = "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f";
  const alertId = "TooManyOwnersAssignedToResource";
  const parameters = {
    alertConfigurationType: "TooManyOwnersAssignedToResourceAlertConfiguration",
    isEnabled: true,
  };
  const credential = new DefaultAzureCredential();
  const client = new AuthorizationManagementClient(credential);
  const result = await client.alertConfigurations.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

Risposta di esempio

Codice di stato:

204

Definizioni

Nome	Descrizione
AlertConfiguration	Configurazione degli avvisi.
AlertDefinition	Definizione di avviso
CloudError	Risposta di errore dal servizio.
CloudErrorBody	Risposta di errore dal servizio.
SeverityLevel	Livello di gravità dell'avviso.

AlertConfiguration

Configurazione degli avvisi.

Nome	Tipo	Descrizione
id	string	ID di configurazione dell'avviso.
name	string	Nome di configurazione dell'avviso.
properties.alertConfigurationType	string	Tipo di configurazione dell'avviso.
properties.alertDefinition	AlertDefinition	Definizione di avviso.
properties.alertDefinitionId	string	ID definizione di avviso.
properties.isEnabled	boolean	True se l'avviso è abilitato, false disabilita l'analisi per l'avviso specifico.
properties.scope	string	Ambito di avviso.
type	string	Tipo di configurazione dell'avviso.

AlertDefinition

Definizione di avviso

Nome	Tipo	Descrizione
id	string	ID definizione di avviso.
name	string	Nome della definizione dell'avviso.
properties.description	string	Descrizione dell'avviso.
properties.displayName	string	Nome visualizzato dell'avviso.
properties.howToPrevent	string	I modi per impedire l'avviso.
properties.isConfigurable	boolean	True se la configurazione dell'avviso può essere configurata; false, in caso contrario.
properties.isRemediatable	boolean	True se l'avviso può essere corretto; false, in caso contrario.
properties.mitigationSteps	string	Metodi per attenuare l'avviso.
properties.scope	string	Ambito di avviso.
properties.securityImpact	string	Impatto sulla sicurezza dell'avviso.
properties.severityLevel	SeverityLevel	Livello di gravità dell'avviso.
type	string	Tipo di definizione dell'avviso.

CloudError

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
error	CloudErrorBody	Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice.
message	string	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

SeverityLevel

Livello di gravità dell'avviso.

Nome	Tipo	Descrizione
High	string
Low	string
Medium	string