Managed Database Vulnerability Assessment Scans - List By Database

Elenca le analisi di valutazione della vulnerabilità di un database.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/vulnerabilityAssessments/default/scans?api-version=2021-08-01-preview

Parametri dell'URI

Name In Required Type Description
databaseName
path True
  • string

Nome del database.

managedInstanceName
path True
  • string

Nome dell'istanza gestita.

resourceGroupName
path True
  • string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

subscriptionId
path True
  • string

ID sottoscrizione che identifica una sottoscrizione di Azure.

vulnerabilityAssessmentName
path True

Nome della valutazione della vulnerabilità.

api-version
query True
  • string

Versione dell'API da usare per la richiesta.

Risposte

Name Type Description
200 OK

È stato recuperato correttamente i record di analisi della valutazione della vulnerabilità del database.

Other Status Codes

Risposte agli errori: **

  • 400 InvalidStorageAccountName: l'account di archiviazione fornito non è valido o non esiste.

  • 400 InvalidStorageAccountCredentials: la firma di accesso condiviso dell'account di archiviazione o la chiave di archiviazione dell'account fornita non è valida.

  • 400 VulnerabilitàAssessmentInvalidPolicy - Le impostazioni di valutazione delle vulnerabilità non esistono o non sono valide nelle impostazioni.

  • 400 VulnerabilitàAssessmentADSIsDisabled - La sicurezza avanzata dei dati deve essere abilitata per l'uso della valutazione delle vulnerabilità.

  • 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath - Archiviazione percorso contenitore deve essere fornito se non è impostato nei criteri a livello di server

  • 400 VulnerabilitàAssessmentDatawarehouseDatabaseIsDeactivated - Impossibile eseguire l'operazione valutazione delle vulnerabilità perché il database viene sospeso. Riprenderlo.

  • 400 VulnerabilitàAssessmentStorageOutboundFirewallNotAllowed - L'account di archiviazione non è nell'elenco delle regole del firewall in uscita.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 SourceDatabaseNotFound: il database di origine non esiste.

  • 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server.

  • 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - Analisi valutazione vulnerabilità è già in corso.

  • 500 DatabaseIsUnavailable - Caricamento non riuscito. Riprova più tardi.

Esempio

Gets the list of a database vulnerability assessment scan records

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6411/databases/testdb/vulnerabilityAssessments/default/scans?api-version=2021-08-01-preview

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan001",
      "name": "scan001",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan001",
        "triggerType": "OnDemand",
        "state": "Passed",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 9
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan002",
      "name": "scan002",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan002",
        "triggerType": "Recurring",
        "state": "Failed",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 9
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan003",
      "name": "scan003",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan003",
        "triggerType": "Recurring",
        "state": "FailedToRun",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [
          {
            "code": "StorageNotFound",
            "message": "Storage not found"
          }
        ],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 0
      }
    }
  ]
}

Definizioni

VulnerabilityAssessmentName

Nome della valutazione della vulnerabilità.

VulnerabilityAssessmentScanError

Proprietà di un errore di analisi della valutazione della vulnerabilità.

VulnerabilityAssessmentScanRecord

Record di analisi della valutazione della vulnerabilità.

VulnerabilityAssessmentScanRecordListResult

Elenco dei record di analisi della valutazione della vulnerabilità.

VulnerabilityAssessmentScanState

Stato dell'analisi.

VulnerabilityAssessmentScanTriggerType

Tipo di trigger di analisi.

VulnerabilityAssessmentName

Nome della valutazione della vulnerabilità.

Name Type Description
default
  • string

VulnerabilityAssessmentScanError

Proprietà di un errore di analisi della valutazione della vulnerabilità.

Name Type Description
code
  • string

Codice di errore.

message
  • string

Messaggio di errore.

VulnerabilityAssessmentScanRecord

Record di analisi della valutazione della vulnerabilità.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.endTime
  • string

Ora di fine analisi (UTC).

properties.errors

Errori di analisi.

properties.numberOfFailedSecurityChecks
  • integer

Numero di controlli di sicurezza non riusciti.

properties.scanId
  • string

ID analisi.

properties.startTime
  • string

Ora di inizio analisi (UTC).

properties.state

Stato dell'analisi.

properties.storageContainerPath
  • string

Percorso del contenitore di archiviazione dei risultati dell'analisi.

properties.triggerType

Tipo di trigger di analisi.

type
  • string

Tipo di risorsa.

VulnerabilityAssessmentScanRecordListResult

Elenco dei record di analisi della valutazione della vulnerabilità.

Name Type Description
nextLink
  • string

Collegamento per recuperare la pagina successiva dei risultati.

value

Matrice di risultati.

VulnerabilityAssessmentScanState

Stato dell'analisi.

Name Type Description
Failed
  • string
FailedToRun
  • string
InProgress
  • string
Passed
  • string

VulnerabilityAssessmentScanTriggerType

Tipo di trigger di analisi.

Name Type Description
OnDemand
  • string
Recurring
  • string