Settings - Update

Service:

Defender for Cloud

API Version:

2021-06-01

mise à jour des paramètres relatifs aux différentes configurations dans Microsoft Defender pour le cloud

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
settingName	path	True	string	Nom du paramètre.
subscriptionId	path	True	string	ID d’abonnement Azure Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version	query	True	string	Version de l’API pour l’opération

Corps de la demande

Le corps de la requête peut être l’un des suivants :

Nom	Description
AlertSyncSettings	Représente un paramètre de synchronisation d’alerte
DataExportSettings	Représente un paramètre d’exportation de données

AlertSyncSettings

Représente un paramètre de synchronisation d’alerte

Nom	Obligatoire	Type	Description
kind	True	string: AlertSyncSettings	type de la chaîne de paramètres
properties.enabled	True	boolean	Le paramètre de synchronisation des alertes est-il activé

DataExportSettings

Représente un paramètre d’exportation de données

Nom	Obligatoire	Type	Description
kind	True	string: DataExportSettings	type de la chaîne de paramètres
properties.enabled	True	boolean	Le paramètre d’exportation de données est-il activé

Réponses

Nom	Type	Description
200 OK	Setting: DataExportSettings AlertSyncSettings	Ok
Other Status Codes	CloudError	Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

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

Définitions

Nom	Description
AlertSyncSettings	Représente un paramètre de synchronisation d’alerte
CloudError	Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).
CloudErrorBody	Détail de l’erreur.
DataExportSettings	Représente un paramètre d’exportation de données
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.

AlertSyncSettings

Représente un paramètre de synchronisation d’alerte

Nom	Type	Description
id	string	ID de ressource
kind	string: AlertSyncSettings	type de la chaîne de paramètres
name	string	Nom de la ressource
properties.enabled	boolean	Le paramètre de synchronisation des alertes est-il activé
type	string	Type de ressource

CloudError

Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).

Nom	Type	Description
error.additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
error.code	string	Code d'erreur.
error.details	CloudErrorBody[]	Détails de l’erreur.
error.message	string	Message d’erreur.
error.target	string	Cible d’erreur.

CloudErrorBody

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	CloudErrorBody[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

DataExportSettings

Représente un paramètre d’exportation de données

Nom	Type	Description
id	string	ID de ressource
kind	string: DataExportSettings	type de la chaîne de paramètres
name	string	Nom de la ressource
properties.enabled	boolean	Le paramètre d’exportation de données est-il activé
type	string	Type de ressource

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.