Settings - Update

Service:

Defender for Cloud

API Version:

2021-06-01

instellingen bijwerken over verschillende configuraties in Microsoft Defender for Cloud

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

URI-parameters

Name	In	Vereist	Type	Description
settingName	path	True	string	De naam van de instelling
subscriptionId	path	True	string	Azure-abonnements-id Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version	query	True	string	API-versie voor de bewerking

Aanvraagbody

De aanvraagtekst kan een van de volgende zijn:

Name	Description
AlertSyncSettings	Vertegenwoordigt een instelling voor waarschuwingssynchronisatie
DataExportSettings	Vertegenwoordigt een instelling voor het exporteren van gegevens

AlertSyncSettings

Vertegenwoordigt een instelling voor waarschuwingssynchronisatie

Name	Vereist	Type	Description
kind	True	string: AlertSyncSettings	het soort instellingentekenreeks
properties.enabled	True	boolean	Is de instelling voor synchronisatie van waarschuwingen ingeschakeld?

DataExportSettings

Vertegenwoordigt een instelling voor het exporteren van gegevens

Name	Vereist	Type	Description
kind	True	string: DataExportSettings	het soort instellingentekenreeks
properties.enabled	True	boolean	Is de instelling voor gegevensexport ingeschakeld?

Antwoorden

Name	Type	Description
200 OK	Setting: DataExportSettings AlertSyncSettings	OK
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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

Scopes

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

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

Definities

Name	Description
AlertSyncSettings	Vertegenwoordigt een instelling voor waarschuwingssynchronisatie
CloudError	Algemene foutreactie voor alle Azure Resource Manager-API's om foutdetails voor mislukte bewerkingen te retourneren. (Dit volgt ook de indeling van de OData-foutreactie.)
CloudErrorBody	De foutdetails.
DataExportSettings	Vertegenwoordigt een instelling voor het exporteren van gegevens
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.

AlertSyncSettings

Vertegenwoordigt een instelling voor waarschuwingssynchronisatie

Name	Type	Description
id	string	Resource-id
kind	string: AlertSyncSettings	het soort instellingentekenreeks
name	string	Resourcenaam
properties.enabled	boolean	Is de instelling voor synchronisatie van waarschuwingen ingeschakeld?
type	string	Resourcetype

CloudError

Algemene foutreactie voor alle Azure Resource Manager-API's om foutdetails voor mislukte bewerkingen te retourneren. (Dit volgt ook de indeling van de OData-foutreactie.)

Name	Type	Description
error.additionalInfo	ErrorAdditionalInfo[]	De fout aanvullende informatie.
error.code	string	De foutcode.
error.details	CloudErrorBody[]	De foutdetails.
error.message	string	Het foutbericht.
error.target	string	Het foutdoel.

CloudErrorBody

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout aanvullende informatie.
code	string	De foutcode.
details	CloudErrorBody[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

DataExportSettings

Vertegenwoordigt een instelling voor het exporteren van gegevens

Name	Type	Description
id	string	Resource-id
kind	string: DataExportSettings	het soort instellingentekenreeks
name	string	Resourcenaam
properties.enabled	boolean	Is de instelling voor gegevensexport ingeschakeld?
type	string	Resourcetype

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.