Product Settings - Get

Dienst:

Sentinel

API-Version:

2025-04-01-preview

Ruft eine Einstellung ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/settings/{settingsName}?api-version=2025-04-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
settingsName	path	True	string pattern: ^[a-zA-Z][a-zA-Z0-9]*$	Der Einstellungsname. Supports – Anomalien, EyesOn, EntityAnalytics, Ueba
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Der Name des Arbeitsbereichs.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	Settings: Anomalies EyesOn EntityAnalytics Ueba	OKAY
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Get EyesOn settings.

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/settings/EyesOn?api-version=2025-04-01-preview

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/bd794837-4d29-4647-9105-6339bfdb4e6a/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/workspaces/avdvirInt/providers/Microsoft.SecurityInsights/settings/EyesOn",
  "name": "EyesOn",
  "type": "Microsoft.SecurityInsights/settings",
  "kind": "EyesOn",
  "properties": {
    "isEnabled": true
  }
}

Definitionen

Name	Beschreibung
Anomalies	Einstellungen mit einem einzelnen Umschalter.
CloudError	Fehlerantwortstruktur.
CloudErrorBody	Fehlerdetails.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
EntityAnalytics	Einstellungen mit einem einzelnen Umschalter.
EntityProviders	Der Entitätsanbieter, der synchronisiert wird.
EyesOn	Einstellungen mit einem einzelnen Umschalter.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
Ueba	Einstellungen mit einem einzelnen Umschalter.
UebaDataSources	Die Datenquelle, die von ueba erweitert wurde.

Anomalies

Objekt

Einstellungen mit einem einzelnen Umschalter.

Name	Typ	Beschreibung
etag	string	Etag der Azure-Ressource
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: Anomalies	Die Art der Einstellung
name	string	Der Name der Ressource
properties.isEnabled	boolean	Bestimmt, ob die Einstellung aktiviert oder deaktiviert ist.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

CloudError

Objekt

Fehlerantwortstruktur.

Name	Typ	Beschreibung
error	CloudErrorBody	Fehlerdaten

CloudErrorBody

Objekt

Fehlerdetails.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

EntityAnalytics

Objekt

Einstellungen mit einem einzelnen Umschalter.

Name	Typ	Beschreibung
etag	string	Etag der Azure-Ressource
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: EntityAnalytics	Die Art der Einstellung
name	string	Der Name der Ressource
properties.entityProviders	EntityProviders[]	Die relevanten Entitätsanbieter, die synchronisiert werden
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

EntityProviders

Enumeration

Der Entitätsanbieter, der synchronisiert wird.

Wert	Beschreibung
ActiveDirectory
AzureActiveDirectory

EyesOn

Objekt

Einstellungen mit einem einzelnen Umschalter.

Name	Typ	Beschreibung
etag	string	Etag der Azure-Ressource
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: EyesOn	Die Art der Einstellung
name	string	Der Name der Ressource
properties.isEnabled	boolean	Bestimmt, ob die Einstellung aktiviert oder deaktiviert ist.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Ueba

Objekt

Einstellungen mit einem einzelnen Umschalter.

Name	Typ	Beschreibung
etag	string	Etag der Azure-Ressource
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: Ueba	Die Art der Einstellung
name	string	Der Name der Ressource
properties.dataSources	UebaDataSources[]	Die relevanten Datenquellen, die durch ueba bereichert wurden
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

UebaDataSources

Enumeration

Die Datenquelle, die von ueba erweitert wurde.

Wert	Beschreibung
AuditLogs
AzureActivity
SecurityEvent
SigninLogs