Product Settings - Update

Serviço:

Sentinel

Versão da API:

2025-07-01-preview

Configuração de atualizações.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
settingsName	path	True	string pattern: ^[a-zA-Z][a-zA-Z0-9]*$	O nome da configuração. Suportes – Anomalias, EyesOn, EntityAnalytics, Ueba
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	O nome do espaço de trabalho.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

O corpo da solicitação pode ser um dos seguintes:

Nome	Description
Anomalies	Configurações com alternância única.
EntityAnalytics	Configurações com alternância única.
EyesOn	Configurações com alternância única.
Ueba	Configurações com alternância única.

Anomalies

Configurações com alternância única.

Nome	Obrigatório	Tipo	Description
kind	True	string: Anomalies	Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo; Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.
etag		string	Etag do recurso do azure

EntityAnalytics

Configurações com alternância única.

Nome	Obrigatório	Tipo	Description
kind	True	string: EntityAnalytics	Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo; Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.
etag		string	Etag do recurso do azure
properties.entityProviders		EntityProviders[]	Os provedores de entidade relevantes sincronizados

EyesOn

Configurações com alternância única.

Nome	Obrigatório	Tipo	Description
kind	True	string: EyesOn	Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo; Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.
etag		string	Etag do recurso do azure

Ueba

Configurações com alternância única.

Nome	Obrigatório	Tipo	Description
kind	True	string: Ueba	Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo; Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.
etag		string	Etag do recurso do azure
properties.dataSources		UebaDataSources[]	As fontes de dados relevantes que enriqueceram por ueba

Respostas

Nome	Tipo	Description
200 OK	Settings: Anomalies EntityAnalytics EyesOn Ueba	Operação de atualização de 'Configurações' de recursos bem-sucedida
201 Created	Settings: Anomalies EntityAnalytics EyesOn Ueba	Resource 'Settings' criar operação bem-sucedida
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Update EyesOn settings.

Solicitação de exemplo

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

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

Resposta de exemplo

Código de status:

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
  }
}

Código de status:

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
  }
}

Definições

Nome	Description
Anomalies	Configurações com alternância única.
CloudError	Estrutura de resposta de erro.
CloudErrorBody	Detalhes do erro.
createdByType	O tipo de identidade que criou o recurso.
EntityAnalytics	Configurações com alternância única.
EntityProviders	O provedor de entidade sincronizado.
EyesOn	Configurações com alternância única.
SettingKind	O tipo de configuração
systemData	Metadados relativos à criação e última modificação do recurso.
Ueba	Configurações com alternância única.
UebaDataSources	A fonte de dados que foi enriquecida pela ueba.

Anomalies

Objeto

Configurações com alternância única.

Nome	Tipo	Description
etag	string	Etag do recurso do azure
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: Anomalies	Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo; Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.
name	string	O nome do recurso
properties.isEnabled	boolean	Determina se a configuração está habilitada ou desabilitada.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

CloudError

Objeto

Estrutura de resposta de erro.

Nome	Tipo	Description
error	CloudErrorBody	Dados de erro

CloudErrorBody

Objeto

Detalhes do erro.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

EntityAnalytics

Objeto

Configurações com alternância única.

Nome	Tipo	Description
etag	string	Etag do recurso do azure
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: EntityAnalytics	Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo; Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.
name	string	O nome do recurso
properties.entityProviders	EntityProviders[]	Os provedores de entidade relevantes sincronizados
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

EntityProviders

Enumeração

O provedor de entidade sincronizado.

Valor	Description
ActiveDirectory	Active Directory
AzureActiveDirectory	AzureActiveDirectory

EyesOn

Objeto

Configurações com alternância única.

Nome	Tipo	Description
etag	string	Etag do recurso do azure
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: EyesOn	Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo; Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.
name	string	O nome do recurso
properties.isEnabled	boolean	Determina se a configuração está habilitada ou desabilitada.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SettingKind

Enumeração

O tipo de configuração

Valor	Description
Anomalies	Anomalies
EyesOn	Olhos
EntityAnalytics	Análise de entidade
Ueba	Ueba

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Ueba

Objeto

Configurações com alternância única.

Nome	Tipo	Description
etag	string	Etag do recurso do azure
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: Ueba	Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo; Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.
name	string	O nome do recurso
properties.dataSources	UebaDataSources[]	As fontes de dados relevantes que enriqueceram por ueba
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

UebaDataSources

Enumeração

A fonte de dados que foi enriquecida pela ueba.

Valor	Description
AuditLogs	AuditLogs
AzureActivity	AzureActivity
SecurityEvent	SecurityEvent
SigninLogs	SigninLogs