Product Settings - Update

Usługa:: Sentinel

Wersja interfejsu API:: 2025-04-01-preview

Ustawienie Aktualizacji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
settingsName	path	True	string pattern: ^[a-zA-Z][a-zA-Z0-9]*$	Nazwa ustawienia. Obsługa — anomalie, EyesOn, EntityAnalytics, Ueba
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nazwa obszaru roboczego.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Treść żądania może być jedną z następujących:

Nazwa	Opis
Anomalies	Ustawienia z jednym przełącznikiem.
EntityAnalytics	Ustawienia z jednym przełącznikiem.
EyesOn	Ustawienia z jednym przełącznikiem.
Ueba	Ustawienia z jednym przełącznikiem.

Anomalies

Ustawienia z jednym przełącznikiem.

Nazwa	Wymagane	Typ	Opis
kind	True	string: Anomalies	Rodzaj ustawienia
etag		string	Etag zasobu platformy Azure

EntityAnalytics

Ustawienia z jednym przełącznikiem.

Nazwa	Wymagane	Typ	Opis
kind	True	string: EntityAnalytics	Rodzaj ustawienia
etag		string	Etag zasobu platformy Azure
properties.entityProviders		EntityProviders[]	Zsynchronizowani dostawcy jednostki

EyesOn

Ustawienia z jednym przełącznikiem.

Nazwa	Wymagane	Typ	Opis
kind	True	string: EyesOn	Rodzaj ustawienia
etag		string	Etag zasobu platformy Azure

Ueba

Ustawienia z jednym przełącznikiem.

Nazwa	Wymagane	Typ	Opis
kind	True	string: Ueba	Rodzaj ustawienia
etag		string	Etag zasobu platformy Azure
properties.dataSources		UebaDataSources[]	Odpowiednie źródła danych wzbogacone przez ueba

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Settings: Anomalies EyesOn EntityAnalytics Ueba	OK
201 Created	Settings: Anomalies EyesOn EntityAnalytics Ueba	Utworzono
Other Status Codes	CloudError	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Update EyesOn settings.

Przykładowe żądanie

HTTP

PUT 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

{
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "kind": "EyesOn",
  "properties": {}
}

Przykładowa odpowiedź

Kod stanu:: 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",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "kind": "EyesOn",
  "properties": {
    "isEnabled": true
  }
}

Kod stanu:: 201

{
  "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",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "kind": "EyesOn",
  "properties": {
    "isEnabled": true
  }
}

Definicje

Nazwa	Opis
Anomalies	Ustawienia z jednym przełącznikiem.
CloudError	Struktura odpowiedzi na błędy.
CloudErrorBody	Szczegóły błędu.
createdByType	Typ tożsamości, która utworzyła zasób.
EntityAnalytics	Ustawienia z jednym przełącznikiem.
EntityProviders	Dostawca jednostki, który jest synchronizowany.
EyesOn	Ustawienia z jednym przełącznikiem.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Ueba	Ustawienia z jednym przełącznikiem.
UebaDataSources	Źródło danych wzbogacone przez ueba.

Anomalies

Objekt

Ustawienia z jednym przełącznikiem.

Nazwa	Typ	Opis
etag	string	Etag zasobu platformy Azure
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: Anomalies	Rodzaj ustawienia
name	string	Nazwa zasobu
properties.isEnabled	boolean	Określa, czy ustawienie jest włączone, czy wyłączone.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

CloudError

Objekt

Struktura odpowiedzi na błędy.

Nazwa	Typ	Opis
error	CloudErrorBody	Dane o błędach

CloudErrorBody

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	string	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

createdByType

Wyliczanie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

EntityAnalytics

Objekt

Ustawienia z jednym przełącznikiem.

Nazwa	Typ	Opis
etag	string	Etag zasobu platformy Azure
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: EntityAnalytics	Rodzaj ustawienia
name	string	Nazwa zasobu
properties.entityProviders	EntityProviders[]	Zsynchronizowani dostawcy jednostki
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

EntityProviders

Wyliczanie

Dostawca jednostki, który jest synchronizowany.

Wartość	Opis
ActiveDirectory
AzureActiveDirectory

EyesOn

Objekt

Ustawienia z jednym przełącznikiem.

Nazwa	Typ	Opis
etag	string	Etag zasobu platformy Azure
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: EyesOn	Rodzaj ustawienia
name	string	Nazwa zasobu
properties.isEnabled	boolean	Określa, czy ustawienie jest włączone, czy wyłączone.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Ueba

Objekt

Ustawienia z jednym przełącznikiem.

Nazwa	Typ	Opis
etag	string	Etag zasobu platformy Azure
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: Ueba	Rodzaj ustawienia
name	string	Nazwa zasobu
properties.dataSources	UebaDataSources[]	Odpowiednie źródła danych wzbogacone przez ueba
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

UebaDataSources

Wyliczanie

Źródło danych wzbogacone przez ueba.

Wartość	Opis
AuditLogs
AzureActivity
SecurityEvent
SigninLogs

Udostępnij za pośrednictwem

Product Settings - Update

Parametry identyfikatora URI

Treść żądania

Anomalies

EntityAnalytics

EyesOn

Ueba

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Update EyesOn settings.

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

Anomalies

CloudError

CloudErrorBody

createdByType

EntityAnalytics

EntityProviders

EyesOn

systemData

Ueba

UebaDataSources