Alerts - Update

Referenz

Dienst:: Authorization

API-Version:: 2022-08-01-preview

Aktualisieren sie eine Warnung.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
alertId	path	True	string	Der Name der zu schließenden Warnung.
scope	path	True	string	Der Bereich der Warnung.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Typ	Beschreibung
properties.isActive	boolean	Standardmäßig false; true, wenn die Warnung aktiv ist.

Antworten

Name	Typ	Beschreibung
204 No Content		NoContent: Die Warnung wurde erfolgreich aktualisiert.
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

DeactivateAlert

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 204

Definitionen

Name	Beschreibung
Alert	Die Warnung.
AlertConfiguration	Warnungskonfiguration.
AlertDefinition	Warnungsdefinition
AlertIncident	Warnungsvorfall
CloudError	Eine Fehlerantwort vom Dienst.
CloudErrorBody	Eine Fehlerantwort vom Dienst.
SeverityLevel	Schweregrad der Warnung.

Alert

Die Warnung.

Name	Typ	Beschreibung
id	string	Die Warnungs-ID
name	string	Der Name der Warnung.
properties.alertConfiguration	AlertConfiguration	Die Warnungskonfiguration.
properties.alertDefinition	AlertDefinition	Die Warnungsdefinition.
properties.alertIncidents	AlertIncident[]	Die Warnungsvorfälle.
properties.incidentCount	integer	Die Anzahl der generierten Incidents der Warnung.
properties.isActive	boolean	Standardmäßig false; true, wenn die Warnung aktiv ist.
properties.lastModifiedDateTime	string	Das Datum, zu dem die Warnungskonfiguration aktualisiert oder neue Incidents generiert wurden.
properties.lastScannedDateTime	string	Das Datum, zu dem die Warnung zuletzt gescannt wurde.
properties.scope	string	Der Warnungsbereich.
type	string	Der Warnungstyp.

AlertConfiguration

Warnungskonfiguration.

Name	Typ	Beschreibung
id	string	Die Warnungskonfigurations-ID.
name	string	Der Name der Warnungskonfiguration.
properties.alertConfigurationType	string	Der Warnungskonfigurationstyp.
properties.alertDefinition	AlertDefinition	Die Warnungsdefinition.
properties.alertDefinitionId	string	Die Warnungsdefinitions-ID.
properties.isEnabled	boolean	True, wenn die Warnung aktiviert ist, deaktiviert false die Überprüfung für die spezifische Warnung.
properties.scope	string	Der Warnungsbereich.
type	string	Der Warnungskonfigurationstyp.

AlertDefinition

Warnungsdefinition

Name	Typ	Beschreibung
id	string	Die Warnungsdefinitions-ID.
name	string	Der Name der Warnungsdefinition.
properties.description	string	Die Beschreibung der Warnung
properties.displayName	string	Der Name der Warnungsanzeige.
properties.howToPrevent	string	Die Möglichkeiten, die Warnung zu verhindern.
properties.isConfigurable	boolean	True, wenn die Warnungskonfiguration konfiguriert werden kann; false, andernfalls.
properties.isRemediatable	boolean	True, wenn die Warnung behoben werden kann; false, andernfalls.
properties.mitigationSteps	string	Die Methoden zum Minimieren der Warnung.
properties.scope	string	Der Warnungsbereich.
properties.securityImpact	string	Auswirkungen der Warnung auf die Sicherheit.
properties.severityLevel	SeverityLevel	Schweregrad der Warnung.
type	string	Der Warnungsdefinitionstyp.

AlertIncident

Warnungsvorfall

Name	Typ	Beschreibung
id	string	Die Id des Warnungsvorfalls.
name	string	Der Name des Warnungsvorfalls.
properties.alertIncidentType	string	Der Warnungsvorfalltyp.
type	string	Der Warnungsvorfalltyp.

CloudError

Eine Fehlerantwort vom Dienst.

Name	Typ	Beschreibung
error	CloudErrorBody	Eine Fehlerantwort vom Dienst.

CloudErrorBody