Defender For Storage - Create
Crée ou met à jour les paramètres Defender pour stockage sur un compte de stockage spécifié.
PUT https://management.azure.com/{resourceId}/providers/Microsoft.Security/defenderForStorageSettings/current?api-version=2025-06-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Identificateur de la ressource. |
|
setting
|
path | True | pattern: ^[a-z][a-z0-9]*$ |
Nom du paramètre Defender pour stockage. |
|
api-version
|
query | True |
string |
Version de l’API pour l’opération |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| properties |
Propriétés de la ressource Defender pour le stockage. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Demande réussie de création ou de mise à jour des paramètres Defender pour le stockage. |
|
| 201 Created |
Demande de création ou de mise à jour des paramètres Defender pour le stockage partiellement réussis. |
|
| Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Creates or updates the Defender for Storage settings on a specified resource.
Exemple de requête
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/defenderForStorageSettings/current?api-version=2025-06-01
{
"properties": {
"isEnabled": true,
"malwareScanning": {
"onUpload": {
"isEnabled": true,
"capGBPerMonth": -1,
"filters": {
"excludeBlobsWithPrefix": [
"unscanned-container",
"sample-container/logs"
],
"excludeBlobsWithSuffix": [
".log",
".jpg"
],
"excludeBlobsLargerThan": 1024
}
},
"scanResultsEventGridTopicResourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.EventGrid/topics/sampletopic"
},
"sensitiveDataDiscovery": {
"isEnabled": true
},
"overrideSubscriptionLevelSettings": true
}
}
Exemple de réponse
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/defenderForStorageSettings/current",
"type": "Microsoft.Security/defenderForStorageSettings",
"name": "current",
"properties": {
"isEnabled": true,
"malwareScanning": {
"onUpload": {
"isEnabled": true,
"capGBPerMonth": -1,
"filters": {
"excludeBlobsWithPrefix": [
"sample-container/logs",
"single-excluded-container/",
"excluded-containers"
],
"excludeBlobsWithSuffix": [
".log",
".jpg"
],
"excludeBlobsLargerThan": 1024
}
},
"scanResultsEventGridTopicResourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.EventGrid/topics/sampletopic",
"blobScanResultsOptions": "blobIndexTags",
"operationStatus": {
"code": "Succeeded"
}
},
"sensitiveDataDiscovery": {
"isEnabled": true,
"operationStatus": {
"code": "Succeeded"
}
},
"overrideSubscriptionLevelSettings": true
}
}
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/defenderForStorageSettings/current",
"type": "Microsoft.Security/defenderForStorageSettings",
"name": "current",
"properties": {
"isEnabled": true,
"malwareScanning": {
"onUpload": {
"isEnabled": false,
"capGBPerMonth": -1
},
"operationStatus": {
"code": "UnknownError",
"message": "Failed to setup data scanner."
}
},
"sensitiveDataDiscovery": {
"isEnabled": false,
"operationStatus": {
"code": "UnknownError",
"message": "Failed to setup data scanner."
}
},
"overrideSubscriptionLevelSettings": true
}
}
Définitions
| Nom | Description |
|---|---|
|
blob |
Optional. Écrire le résultat de l’analyse sur blobIndexTags par défaut. |
|
Cloud |
Réponse d’erreur courante pour toutes les API Azure Resource Manager afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.). |
|
Cloud |
Détail de l’erreur. |
|
Defender |
Ressource Defender pour stockage. |
|
Defender |
Propriétés de la ressource Defender pour le stockage. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Malware |
Propriétés de l’analyse des logiciels malveillants. |
|
On |
Optional. Déterminez quels objets blob sont analysés par l’analyse des programmes malveillants Lors du chargement. Une opération Ou est effectuée entre chaque type de filtre. |
|
On |
Propriétés de l’analyse des logiciels malveillants Lors de l’importation. |
|
Operation |
État décrivant la réussite/l’échec de l’opération d’activation/désactivation. |
|
Sensitive |
Propriétés de la découverte de données sensibles. |
|
setting |
Nom du paramètre Defender pour stockage. |
blobScanResultsOptions
Optional. Écrire le résultat de l’analyse sur blobIndexTags par défaut.
| Valeur | Description |
|---|---|
| blobIndexTags |
Écrivez les résultats de l’analyse sur les balises d’index des blobs. |
| None |
N’écrivez pas les résultats de l’analyse sur les balises d’index des blobs. |
CloudError
Réponse d’erreur courante pour toutes les API Azure Resource Manager afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).
| Nom | Type | Description |
|---|---|---|
| error.additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| error.code |
string |
Code d'erreur. |
| error.details |
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 |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d'erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
DefenderForStorageSetting
Ressource Defender pour stockage.
| Nom | Type | Description |
|---|---|---|
| id |
string |
ID de ressource |
| name |
string |
Nom de la ressource |
| properties |
Propriétés de la ressource Defender pour le stockage. |
|
| type |
string |
Type de ressource |
DefenderForStorageSettingProperties
Propriétés de la ressource Defender pour le stockage.
| Nom | Type | Description |
|---|---|---|
| isEnabled |
boolean |
Indique si Defender pour le stockage est activé sur ce compte de stockage. |
| malwareScanning |
Propriétés de l’analyse des logiciels malveillants. |
|
| overrideSubscriptionLevelSettings |
boolean |
Indique si les paramètres définis pour ce compte de stockage doivent remplacer les paramètres définis pour l’abonnement. |
| sensitiveDataDiscovery |
Propriétés de la découverte de données sensibles. |
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émentaire. |
MalwareScanningProperties
Propriétés de l’analyse des logiciels malveillants.
| Nom | Type | Description |
|---|---|---|
| blobScanResultsOptions |
Optional. Écrire le résultat de l’analyse sur blobIndexTags par défaut. |
|
| onUpload |
Propriétés de l’analyse des logiciels malveillants Lors de l’importation. |
|
| operationStatus |
En cas d’échec ou de réussite partielle. Des données supplémentaires décrivant l’analyse des programmes malveillants activent/désactivent l’opération. |
|
| scanResultsEventGridTopicResourceId |
string |
Optional. ID de ressource d’un sujet Event Grid auquel envoyer les résultats de l’analyse. |
OnUploadFilters
Optional. Déterminez quels objets blob sont analysés par l’analyse des programmes malveillants Lors du chargement. Une opération Ou est effectuée entre chaque type de filtre.
| Nom | Type | Description |
|---|---|---|
| excludeBlobsLargerThan |
Optional. Spécifie la taille maximale en octets des objets blob à analyser. Ce paramètre accepte une seule valeur entière positive. Les objets blob supérieurs à cette valeur seront exclus de l’analyse. |
|
| excludeBlobsWithPrefix |
string[] |
Optional. Liste des préfixes à exclure de l’analyse des programmes malveillants lors du téléchargement.
Format : |
| excludeBlobsWithSuffix |
string[] |
Optional. Liste de suffixes à exclure de l’analyse des logiciels malveillants lors du téléchargement. Les suffixes ne correspondent qu’à la fin des noms d’objets blob et ne doivent être utilisés que pour les extensions de fichiers ou les fins de noms d’objets blob. |
OnUploadProperties
Propriétés de l’analyse des logiciels malveillants Lors de l’importation.
| Nom | Type | Description |
|---|---|---|
| capGBPerMonth |
integer (int32) |
Définit le nombre maximal de Go à analyser par mois. Réglez sur -1 si aucun bouchage n’est nécessaire. Si elle n’est pas spécifiée, la valeur par défaut est -1. |
| filters |
Optional. Déterminez quels objets blob sont analysés par l’analyse des programmes malveillants Lors du chargement. Une opération Ou est effectuée entre chaque type de filtre. |
|
| isEnabled |
boolean |
Indique si l’analyse des logiciels malveillants Lors du téléchargement doit être activée. |
OperationStatus
État décrivant la réussite/l’échec de l’opération d’activation/désactivation.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Code d’état de l’opération. |
| message |
string |
Informations supplémentaires sur la réussite/l’échec de l’opération. |
SensitiveDataDiscoveryProperties
Propriétés de la découverte de données sensibles.
| Nom | Type | Description |
|---|---|---|
| isEnabled |
boolean |
Indique si la découverte des données sensibles doit être activée. |
| operationStatus |
En cas d’échec ou de réussite partielle. Des données supplémentaires décrivant l’opération d’activation/désactivation de la découverte de données sensibles. |
settingName
Nom du paramètre Defender pour stockage.
| Valeur | Description |
|---|---|
| current |
Nom du nom des paramètres defender pour le stockage. |