Settings - Update

Service:

Defender for Cloud

API Version:

2021-06-01

Aktualisieren von Einstellungen zu verschiedenen Konfigurationen in Microsoft Defender für Cloud

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/settings/{settingName}?api-version=2021-06-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
settingName	path	True	string	Der Name der Einstellung.
subscriptionId	path	True	string	Azure-Abonnement-ID Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version	query	True	string	API-Version für den Vorgang

Anforderungstext

Beim Anforderungstext kann es sich um eines der folgenden Elemente handeln:

Name	Beschreibung
AlertSyncSettings	Stellt eine Warnungssynchronisierungseinstellung dar.
DataExportSettings	Stellt eine Datenexporteinstellung dar.

AlertSyncSettings

Stellt eine Warnungssynchronisierungseinstellung dar.

Name	Erforderlich	Typ	Beschreibung
kind	True	string: AlertSyncSettings	die Art der Einstellungszeichenfolge
properties.enabled	True	boolean	Ist die Warnungssynchronisierungseinstellung aktiviert?

DataExportSettings

Stellt eine Datenexporteinstellung dar.

Name	Erforderlich	Typ	Beschreibung
kind	True	string: DataExportSettings	die Art der Einstellungszeichenfolge
properties.enabled	True	boolean	Ist die Datenexporteinstellung aktiviert?

Antworten

Name	Typ	Beschreibung
200 OK	Setting: DataExportSettings AlertSyncSettings	OK
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Update a setting for subscription

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/settings/WDATP?api-version=2021-06-01

{
  "kind": "DataExportSettings",
  "properties": {
    "enabled": true
  }
}

Sample Response

Status code:

200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/settings/WDATP",
  "name": "WDATP",
  "kind": "DataExportSettings",
  "type": "Microsoft.Security/settings",
  "properties": {
    "enabled": true
  }
}

Definitionen

Name	Beschreibung
AlertSyncSettings	Stellt eine Warnungssynchronisierungseinstellung dar.
CloudError	Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.).
CloudErrorBody	Die Fehlerdetails.
DataExportSettings	Stellt eine Datenexporteinstellung dar.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

AlertSyncSettings

Stellt eine Warnungssynchronisierungseinstellung dar.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
kind	string: AlertSyncSettings	die Art der Einstellungszeichenfolge
name	string	Ressourcenname
properties.enabled	boolean	Ist die Warnungssynchronisierungseinstellung aktiviert?
type	string	Ressourcentyp

CloudError

Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.).

Name	Typ	Beschreibung
error.additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
error.code	string	Der Fehlercode.
error.details	CloudErrorBody[]	Die Fehlerdetails.
error.message	string	Die Fehlermeldung.
error.target	string	Das Fehlerziel.

CloudErrorBody

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	CloudErrorBody[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

DataExportSettings

Stellt eine Datenexporteinstellung dar.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
kind	string: DataExportSettings	die Art der Einstellungszeichenfolge
name	string	Ressourcenname
properties.enabled	boolean	Ist die Datenexporteinstellung aktiviert?
type	string	Ressourcentyp

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.