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
resourceId
path True

string

Identificateur de la ressource.

settingName
path True

settingName

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

DefenderForStorageSettingProperties

Propriétés de la ressource Defender pour le stockage.

Réponses

Nom Type Description
200 OK

DefenderForStorageSetting

Demande réussie de création ou de mise à jour des paramètres Defender pour le stockage.

201 Created

DefenderForStorageSetting

Demande de création ou de mise à jour des paramètres Defender pour le stockage partiellement réussis.

Other Status Codes

CloudError

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
blobScanResultsOptions

Optional. Écrire le résultat de l’analyse sur blobIndexTags par défaut.

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.).

CloudErrorBody

Détail de l’erreur.

DefenderForStorageSetting

Ressource Defender pour stockage.

DefenderForStorageSettingProperties

Propriétés de la ressource Defender pour le stockage.

ErrorAdditionalInfo

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

MalwareScanningProperties

Propriétés de l’analyse des logiciels malveillants.

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.

OnUploadProperties

Propriétés de l’analyse des logiciels malveillants Lors de l’importation.

OperationStatus

État décrivant la réussite/l’échec de l’opération d’activation/désactivation.

SensitiveDataDiscoveryProperties

Propriétés de la découverte de données sensibles.

settingName

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

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.

DefenderForStorageSetting

Ressource Defender pour stockage.

Nom Type Description
id

string

ID de ressource

name

string

Nom de la ressource

properties

DefenderForStorageSettingProperties

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

MalwareScanningProperties

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

SensitiveDataDiscoveryProperties

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

blobScanResultsOptions

Optional. Écrire le résultat de l’analyse sur blobIndexTags par défaut.

onUpload

OnUploadProperties

Propriétés de l’analyse des logiciels malveillants Lors de l’importation.

operationStatus

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 : container-name/blob-name (commencez par le nom du conteneur ; n’incluez pas le nom du compte de stockage). Exclure des conteneurs entiers : utilisez le préfixe des noms de conteneur que vous souhaitez exclure sans qu’il /y ait de fin . Exclure un seul conteneur : ajoutez une barre oblique / de fin après le nom du conteneur pour éviter d’exclure d’autres conteneurs avec des préfixes similaires.

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

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.

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

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.