Defender For Storage - Get Malware Scan

Riferimento

Servizio:: Defender for Cloud

Versione API:: 2024-10-01-preview

Ottiene l'analisi malware di Defender for Storage per la risorsa di archiviazione specificata.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceId	path	True	string	Identificatore della risorsa.
scanId	path	True	string	Identificatore dell'analisi. Può essere "latest" o un GUID. Criterio di espressione regolare: `^(latest\|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$`
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

Gets the Defender for Storage malware scan for the specified storage resource.

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


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

/**
 * Samples for DefenderForStorage GetMalwareScan.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-10-01-preview/examples/DefenderForStorage
     * /GetMalwareScan_example.json
     */
    /**
     * Sample code: Gets the Defender for Storage malware scan for the specified storage resource.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void getsTheDefenderForStorageMalwareScanForTheSpecifiedStorageResource(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.defenderForStorages().getMalwareScanWithResponse(
            "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount",
            SettingName.CURRENT, "latest", 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": "0ce362c5-87a5-4030-ba6a-109566cd7b3d",
    "scanStatus": "Completed",
    "scanStartTime": "2024-09-12T12:20:14.6364816Z",
    "scanEndTime": "2024-09-12T12:21:17.5648386Z",
    "scanSummary": {
      "blobs": {
        "totalBlobsScanned": 40,
        "maliciousBlobsCount": 10,
        "skippedBlobsCount": 0,
        "scannedBlobsInGB": 0.019550956785678864
      },
      "estimatedScanCostUSD": 0.0029326435178518295
    }
  }
}

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

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

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

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

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

MalwareScan

Descrive lo stato di un'operazione di analisi malware.

Nome	Tipo	Descrizione
properties	MalwareScanProperties

MalwareScanProperties

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

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

Nome dell'impostazione di Defender per Archiviazione.

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

Condividi tramite