Settings - Update

Service:

Defender for Cloud

API Version:

2021-06-01

aggiornamento delle impostazioni relative a configurazioni diverse in Microsoft Defender per Cloud

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
settingName	path	True	string	Nome dell'impostazione
subscriptionId	path	True	string	ID sottoscrizione di Azure Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version	query	True	string	Versione DELL'API per l'operazione

Corpo della richiesta

Il corpo della richiesta può essere uno dei seguenti:

Nome	Descrizione
AlertSyncSettings	Rappresenta un'impostazione di sincronizzazione degli avvisi
DataExportSettings	Rappresenta un'impostazione di esportazione dei dati

AlertSyncSettings

Rappresenta un'impostazione di sincronizzazione degli avvisi

Nome	Necessario	Tipo	Descrizione
kind	True	string: AlertSyncSettings	tipo di stringa di impostazioni
properties.enabled	True	boolean	Impostazione di sincronizzazione degli avvisi abilitata

DataExportSettings

Rappresenta un'impostazione di esportazione dei dati

Nome	Necessario	Tipo	Descrizione
kind	True	string: DataExportSettings	tipo di stringa di impostazioni
properties.enabled	True	boolean	Impostazione di esportazione dei dati abilitata

Risposte

Nome	Tipo	Descrizione
200 OK	Setting: DataExportSettings AlertSyncSettings	OK
Other Status Codes	CloudError	Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

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

Definizioni

Nome	Descrizione
AlertSyncSettings	Rappresenta un'impostazione di sincronizzazione degli avvisi
CloudError	Risposta di errore comune per tutte le API di Resource Manager di Azure per restituire i dettagli degli errori per le operazioni non riuscite. Questo segue anche il formato di risposta dell'errore OData.
CloudErrorBody	Dettagli dell'errore.
DataExportSettings	Rappresenta un'impostazione di esportazione dei dati
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.

AlertSyncSettings

Rappresenta un'impostazione di sincronizzazione degli avvisi

Nome	Tipo	Descrizione
id	string	ID risorsa
kind	string: AlertSyncSettings	tipo di stringa di impostazioni
name	string	Nome risorsa
properties.enabled	boolean	Impostazione di sincronizzazione degli avvisi abilitata
type	string	Tipo di risorsa

CloudError

Risposta di errore comune per tutte le API di Resource Manager di Azure per restituire i dettagli degli errori per le operazioni non riuscite. Questo segue anche il formato di risposta dell'errore OData.

Nome	Tipo	Descrizione
error.additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
error.code	string	Codice di errore.
error.details	CloudErrorBody[]	Dettagli dell'errore.
error.message	string	Messaggio di errore.
error.target	string	Destinazione dell'errore.

CloudErrorBody

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	CloudErrorBody[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

DataExportSettings

Rappresenta un'impostazione di esportazione dei dati

Nome	Tipo	Descrizione
id	string	ID risorsa
kind	string: DataExportSettings	tipo di stringa di impostazioni
name	string	Nome risorsa
properties.enabled	boolean	Impostazione di esportazione dei dati abilitata
type	string	Tipo di risorsa

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.