Delen via

Defender For Storage - Create

  • Referentie
Service:
Defender for Cloud
API Version:
2022-12-01-preview

Hiermee worden de Defender for Storage-instellingen voor een opgegeven opslagaccount gemaakt of bijgewerkt.

PUT https://management.azure.com/{resourceId}/providers/Microsoft.Security/defenderForStorageSettings/current?api-version=2022-12-01-preview

URI-parameters

Name In Vereist Type Description
resourceId
 path True

string

De id van de resource.
settingName
 path True

settingName

Naam van Defender for Storage-instelling.

Regex pattern: ^[a-z][a-z0-9]*$
api-version
 query True

string

API-versie voor de bewerking

Aanvraagbody

Name Type Description
properties.isEnabled

boolean

Geeft aan of Defender for Storage is ingeschakeld voor dit opslagaccount.
properties.malwareScanning.onUpload.capGBPerMonth

integer

Hiermee definieert u het maximum aantal GB dat per maand moet worden gescand. Stel in op -1 als er geen limiet nodig is.
properties.malwareScanning.onUpload.isEnabled

boolean

Hiermee wordt aangegeven of bij het uploaden van malware scannen moet worden ingeschakeld.
properties.malwareScanning.scanResultsEventGridTopicResourceId

string

Optioneel. Resource-id van een Event Grid-onderwerp om scanresultaten naar te verzenden.
properties.overrideSubscriptionLevelSettings

boolean

Hiermee wordt aangegeven of de instellingen die voor dit opslagaccount zijn gedefinieerd, de instellingen voor het abonnement moeten overschrijven.
properties.sensitiveDataDiscovery.isEnabled

boolean

Hiermee wordt aangegeven of detectie van gevoelige gegevens moet worden ingeschakeld.

Antwoorden

Name Type Description
200 OK

DefenderForStorageSetting

Geslaagde aanvraag voor het maken of bijwerken van Defender for Storage-instellingen.
201 Created

DefenderForStorageSetting

De aanvraag voor het maken of bijwerken van Defender for Storage-instellingen is gedeeltelijk voltooid.
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

Creates or updates the Defender for Storage settings on a specified resource.

Sample Request

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=2022-12-01-preview

{
  "properties": {
    "isEnabled": true,
    "malwareScanning": {
      "onUpload": {
        "isEnabled": true,
        "capGBPerMonth": -1
      },
      "scanResultsEventGridTopicResourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.EventGrid/topics/sampletopic"
    },
    "sensitiveDataDiscovery": {
      "isEnabled": true
    },
    "overrideSubscriptionLevelSettings": true
  }
}

Sample Response

Status code:
200 
{
  "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
      },
      "scanResultsEventGridTopicResourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.EventGrid/topics/sampletopic",
      "operationStatus": {
        "code": "Succeeded"
      }
    },
    "sensitiveDataDiscovery": {
      "isEnabled": true,
      "operationStatus": {
        "code": "Succeeded"
      }
    },
    "overrideSubscriptionLevelSettings": true
  }
}
Status code:
201 
{
  "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
  }
}

Definities

Name Description
CloudError

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

De foutdetails.
DefenderForStorageSetting

De Defender for Storage-resource.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
OperationStatus

Een status die het slagen/mislukken van de activerings-/uitschakelingsbewerking beschrijft.
settingName

Naam van Defender for Storage-instelling.

CloudError

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

Name Type Description
error.additionalInfo

ErrorAdditionalInfo[]

Aanvullende informatie over de fout.
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[]

Aanvullende informatie over de fout.
code

string

De foutcode.
details

CloudErrorBody[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

DefenderForStorageSetting

De Defender for Storage-resource.

Name Type Description
id

string

Resource-id
name

string

Resourcenaam
properties.isEnabled

boolean

Geeft aan of Defender for Storage is ingeschakeld voor dit opslagaccount.
properties.malwareScanning.onUpload.capGBPerMonth

integer

Hiermee definieert u het maximum aantal GB dat per maand moet worden gescand. Stel in op -1 als er geen limiet nodig is.
properties.malwareScanning.onUpload.isEnabled

boolean

Hiermee wordt aangegeven of bij het uploaden van malware scannen moet worden ingeschakeld.
properties.malwareScanning.operationStatus

OperationStatus

Bij een fout of gedeeltelijk succes. Aanvullende gegevens over de bewerking malwarescans in-/uitschakelen.
properties.malwareScanning.scanResultsEventGridTopicResourceId

string

Optioneel. Resource-id van een Event Grid-onderwerp om scanresultaten naar te verzenden.
properties.overrideSubscriptionLevelSettings

boolean

Hiermee wordt aangegeven of de instellingen die voor dit opslagaccount zijn gedefinieerd, de instellingen voor het abonnement moeten overschrijven.
properties.sensitiveDataDiscovery.isEnabled

boolean

Hiermee wordt aangegeven of detectie van gevoelige gegevens moet worden ingeschakeld.
properties.sensitiveDataDiscovery.operationStatus

OperationStatus

Bij een fout of gedeeltelijk succes. Aanvullende gegevens met een beschrijving van de bewerking Gevoelige gegevensdetectie in-/uitschakelen.
type

string

Resourcetype

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het type aanvullende informatie.

OperationStatus

Een status die het slagen/mislukken van de activerings-/uitschakelingsbewerking beschrijft.

Name Type Description
code

string

De statuscode van de bewerking.
message

string

Aanvullende informatie over het slagen/mislukken van de bewerking.

settingName

Naam van Defender for Storage-instelling.

Name Type Description
current

string

Naam van de naam van de defender voor opslaginstellingen.