Defender For Storage - Start Malware Scan

Servizio:

Defender for Cloud

Versione API:

2024-10-01-preview

Avviare un'analisi malware di Defender for Storage per l'account di archiviazione specificato.

POST https://management.azure.com/{resourceId}/providers/Microsoft.Security/defenderForStorageSettings/current/startMalwareScan?api-version=2024-10-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceId	path	True	string	Identificatore della risorsa.
settingName	path	True	settingName	Nome dell'impostazione di Defender per Archiviazione. Criterio di espressione regolare: ^[a-z][a-z0-9]*$
api-version	query	True	string	Versione dell'API per l'operazione

Risposte

Nome	Tipo	Descrizione
200 OK	MalwareScan	Stato dell'operazione di analisi malware.
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Initiate a Defender for Storage malware scan for the specified storage account.

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/defenderForStorageSettings/current/startMalwareScan?api-version=2024-10-01-preview

Java

import com.azure.resourcemanager.security.models.SettingName;

/**
 * Samples for DefenderForStorage StartMalwareScan.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-10-01-preview/examples/DefenderForStorage
     * /StartMalwareScan_example.json
     */
    /**
     * Sample code: Initiate a Defender for Storage malware scan for the specified storage account.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void initiateADefenderForStorageMalwareScanForTheSpecifiedStorageAccount(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.defenderForStorages().startMalwareScanWithResponse(
            "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount",
            SettingName.CURRENT, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:

200

{
  "properties": {
    "scanId": "fc831479-412f-4bc2-8333-a8edda751a80",
    "scanStatus": "Queued",
    "scanStatusMessage": "The scan request has been queued for scanning"
  }
}

Definizioni

Nome	Descrizione
BlobsScanSummary	Riepilogo dei risultati dell'analisi dei BLOB analizzati.
CloudError	Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.
CloudErrorBody	Dettagli dell'errore.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
MalwareScan	Descrive lo stato di un'operazione di analisi malware.
MalwareScanProperties
ScanSummary	Riepilogo dei risultati dell'analisi.
settingName	Nome dell'impostazione di Defender per Archiviazione.

BlobsScanSummary

Object

Riepilogo dei risultati dell'analisi dei BLOB analizzati.

Nome	Tipo	Descrizione
maliciousBlobsCount	integer	Numero di BLOB dannosi rilevati durante l'analisi.
scannedBlobsInGB	number	Numero di gigabyte di dati analizzati.
skippedBlobsCount	integer	Numero di BLOB ignorati.
totalBlobsScanned	integer	Numero totale di BLOB analizzati.

CloudError

Object

Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

Nome	Tipo	Descrizione
error.additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
error.code	string	Codice di errore.
error.details	CloudErrorBody[]	Dettagli dell'errore.
error.message	string	Messaggio di errore.
error.target	string	Destinazione dell'errore.

CloudErrorBody

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	CloudErrorBody[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

MalwareScan

Object

Descrive lo stato di un'operazione di analisi malware.

Nome	Tipo	Descrizione
properties	MalwareScanProperties

MalwareScanProperties

Object

Nome	Tipo	Descrizione
scanEndTime	string	Ora in cui l'analisi è terminata. Disponibile solo per un'analisi terminata.
scanId	string	Identificatore dell'analisi.
scanStartTime	string	Ora in cui è stata avviata l'analisi.
scanStatus	string	Codice di stato dell'operazione di analisi.
scanStatusMessage	string	Descrizione dello stato dell'analisi.
scanSummary	ScanSummary	Riepilogo dei risultati dell'analisi.

ScanSummary

Object

Riepilogo dei risultati dell'analisi.

Nome	Tipo	Descrizione
blobs	BlobsScanSummary	Riepilogo dei risultati dell'analisi dei BLOB analizzati.
estimatedScanCostUSD	number	Costo stimato dell'analisi. Disponibile solo per un'analisi terminata.

settingName

Enumeration

Nome dell'impostazione di Defender per Archiviazione.

Valore	Descrizione
current	Nome del nome delle impostazioni di Defender per archiviazione.