Product Settings - Update

Služba:
Sentinel
Verze rozhraní API:
2025-07-01-preview

Nastavení aktualizací.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
settingsName
 path True

string

pattern: ^[a-zA-Z][a-zA-Z0-9]*$

Název nastavení. Podporuje – anomálie, EyesOn, EntityAnalytics, Ueba
subscriptionId
 path True

string (uuid)

ID cílového předplatného. Hodnota musí být UUID.
workspaceName
 path True

string

minLength: 1
maxLength: 90
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Název pracovního prostoru.
api-version
 query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Text žádosti může tvořit:

Name Description
Anomalies

Nastavení s jedním přepínačem
EntityAnalytics

Nastavení s jedním přepínačem
EyesOn

Nastavení s jedním přepínačem
Ueba

Nastavení s jedním přepínačem

Anomalies

Nastavení s jedním přepínačem

Name Vyžadováno Typ Description
kind True string:

Anomalies

Metadata používaná portálem, nástroji atd. k vykreslení různých prostředí uživatelského prostředí pro prostředky stejného typu; Například ApiApps jsou druhem typu Microsoft.Web/sites. V případě podpory musí poskytovatel prostředků tuto hodnotu ověřit a zachovat.
etag

string

Označení prostředku Azure

EntityAnalytics

Nastavení s jedním přepínačem

Name Vyžadováno Typ Description
kind True string:

EntityAnalytics

Metadata používaná portálem, nástroji atd. k vykreslení různých prostředí uživatelského prostředí pro prostředky stejného typu; Například ApiApps jsou druhem typu Microsoft.Web/sites. V případě podpory musí poskytovatel prostředků tuto hodnotu ověřit a zachovat.
etag

string

Označení prostředku Azure
properties.entityProviders

EntityProviders[]

Relevantní poskytovatelé entit, kteří jsou synchronizovaní

EyesOn

Nastavení s jedním přepínačem

Name Vyžadováno Typ Description
kind True string:

EyesOn

Metadata používaná portálem, nástroji atd. k vykreslení různých prostředí uživatelského prostředí pro prostředky stejného typu; Například ApiApps jsou druhem typu Microsoft.Web/sites. V případě podpory musí poskytovatel prostředků tuto hodnotu ověřit a zachovat.
etag

string

Označení prostředku Azure

Ueba

Nastavení s jedním přepínačem

Name Vyžadováno Typ Description
kind True string:

Ueba

Metadata používaná portálem, nástroji atd. k vykreslení různých prostředí uživatelského prostředí pro prostředky stejného typu; Například ApiApps jsou druhem typu Microsoft.Web/sites. V případě podpory musí poskytovatel prostředků tuto hodnotu ověřit a zachovat.
etag

string

Označení prostředku Azure
properties.dataSources

UebaDataSources[]

Relevantní zdroje dat, které jsou rozšířeny nástrojem ueba

Odpovědi

Name Typ Description
200 OK Settings:

Aktualizace resource 'Settings' byla úspěšná
201 Created Settings:

Operace vytvoření "Nastavení" zdroje uspěla
Other Status Codes

CloudError

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Update EyesOn settings.

Ukázkový požadavek

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-07-01-preview

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

Ukázková odpověď

Stavový kód:
200 
{
  "name": "EyesOn",
  "type": "Microsoft.SecurityInsights/settings",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "id": "/subscriptions/bd794837-4d29-4647-9105-6339bfdb4e6a/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/workspaces/avdvirInt/providers/Microsoft.SecurityInsights/settings/EyesOn",
  "kind": "EyesOn",
  "properties": {
    "isEnabled": true
  }
}
Stavový kód:
201 
{
  "name": "EyesOn",
  "type": "Microsoft.SecurityInsights/settings",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "id": "/subscriptions/bd794837-4d29-4647-9105-6339bfdb4e6a/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/workspaces/avdvirInt/providers/Microsoft.SecurityInsights/settings/EyesOn",
  "kind": "EyesOn",
  "properties": {
    "isEnabled": true
  }
}

Definice

Name Description
Anomalies

Nastavení s jedním přepínačem
CloudError

Struktura odpovědi na chybu
CloudErrorBody

Podrobnosti o chybě
createdByType

Typ identity, která prostředek vytvořila.
EntityAnalytics

Nastavení s jedním přepínačem
EntityProviders

Zprostředkovatel entity, který je synchronizovaný.
EyesOn

Nastavení s jedním přepínačem
SettingKind

Druh nastavení
systemData

Metadata týkající se vytvoření a poslední změny prostředku.
Ueba

Nastavení s jedním přepínačem
UebaDataSources

Zdroj dat, který je rozšířen uživatelem ueba.

Anomalies

Objekt

Nastavení s jedním přepínačem

Name Typ Description
etag

string

Označení prostředku Azure
id

string (arm-id)

Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind string:

Anomalies

Metadata používaná portálem, nástroji atd. k vykreslení různých prostředí uživatelského prostředí pro prostředky stejného typu; Například ApiApps jsou druhem typu Microsoft.Web/sites. V případě podpory musí poskytovatel prostředků tuto hodnotu ověřit a zachovat.
name

string

Název prostředku
properties.isEnabled

boolean

Určuje, zda je nastavení povolené nebo zakázané.
systemData

systemData

Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

CloudError

Objekt

Struktura odpovědi na chybu

Name Typ Description
error

CloudErrorBody

Údaje o chybě

CloudErrorBody

Objekt

Podrobnosti o chybě

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message

string

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota Description
User
Application
ManagedIdentity
Key

EntityAnalytics

Objekt

Nastavení s jedním přepínačem

Name Typ Description
etag

string

Označení prostředku Azure
id

string (arm-id)

Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind string:

EntityAnalytics

Metadata používaná portálem, nástroji atd. k vykreslení různých prostředí uživatelského prostředí pro prostředky stejného typu; Například ApiApps jsou druhem typu Microsoft.Web/sites. V případě podpory musí poskytovatel prostředků tuto hodnotu ověřit a zachovat.
name

string

Název prostředku
properties.entityProviders

EntityProviders[]

Relevantní poskytovatelé entit, kteří jsou synchronizovaní
systemData

systemData

Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

EntityProviders

Výčet

Zprostředkovatel entity, který je synchronizovaný.

Hodnota Description
ActiveDirectory

Active Directory
AzureActiveDirectory

AzureActiveDirectory

EyesOn

Objekt

Nastavení s jedním přepínačem

Name Typ Description
etag

string

Označení prostředku Azure
id

string (arm-id)

Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind string:

EyesOn

Metadata používaná portálem, nástroji atd. k vykreslení různých prostředí uživatelského prostředí pro prostředky stejného typu; Například ApiApps jsou druhem typu Microsoft.Web/sites. V případě podpory musí poskytovatel prostředků tuto hodnotu ověřit a zachovat.
name

string

Název prostředku
properties.isEnabled

boolean

Určuje, zda je nastavení povolené nebo zakázané.
systemData

systemData

Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

SettingKind

Výčet

Druh nastavení

Hodnota Description
Anomalies

Anomalies
EyesOn

Oči na
EntityAnalytics

EntityAnalytics
Ueba

Ueba

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string (date-time)

Časové razítko vytvoření prostředku (UTC).
createdBy

string

Identita, která prostředek vytvořila.
createdByType

createdByType

Typ identity, která prostředek vytvořila.
lastModifiedAt

string (date-time)

Časové razítko poslední změny zdroje (UTC)
lastModifiedBy

string

Identita, která naposledy změnila prostředek.
lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.

Ueba

Objekt

Nastavení s jedním přepínačem

Name Typ Description
etag

string

Označení prostředku Azure
id

string (arm-id)

Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind string:

Ueba

Metadata používaná portálem, nástroji atd. k vykreslení různých prostředí uživatelského prostředí pro prostředky stejného typu; Například ApiApps jsou druhem typu Microsoft.Web/sites. V případě podpory musí poskytovatel prostředků tuto hodnotu ověřit a zachovat.
name

string

Název prostředku
properties.dataSources

UebaDataSources[]

Relevantní zdroje dat, které jsou rozšířeny nástrojem ueba
systemData

systemData

Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

UebaDataSources

Výčet

Zdroj dat, který je rozšířen uživatelem ueba.

Hodnota Description
AuditLogs

AuditLogs
AzureActivity

AzureActivity
SecurityEvent

SecurityEvent
SigninLogs

SigninLogs