Managed Database Vulnerability Assessment Scans - List By Database

Visar en lista över sårbarhetsbedömningsgenomsökningar av en databas.

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

URI-parametrar

Name In Required Type Description
databaseName
path True
  • string

Namnet på databasen.

managedInstanceName
path True
  • string

Namnet på den hanterade instansen.

resourceGroupName
path True
  • string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

subscriptionId
path True
  • string

Prenumerations-ID:t som identifierar en Azure-prenumeration.

vulnerabilityAssessmentName
path True

Namnet på sårbarhetsbedömningen.

api-version
query True
  • string

DEN API-version som ska användas för begäran.

Svar

Name Type Description
200 OK

Databasens sårbarhetsbedömningsgenomsökningsposter har hämtats.

Other Status Codes

Felsvar: ***

  • 400 InvalidStorageAccountName – det angivna lagringskontot är inte giltigt eller finns inte.

  • 400 InvalidStorageAccountCredentials – Den angivna signaturen för delad åtkomst för lagringskontot eller lagringsnyckeln för kontot är inte giltig.

  • 400 VulnerabilityAssessmentInvalidPolicy – Inställningarna för sårbarhetsbedömning finns inte eller ogiltig lagring som anges i inställningarna.

  • 400 VulnerabilityAssessmentADSIsDisabled – Advanced Data Security bör aktiveras för att använda sårbarhetsbedömning.

  • 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath – Storage containersökväg måste anges om den inte anges i servernivåprincipen

  • 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated – Det gick inte att köra åtgärden Sårbarhetsbedömning eftersom databasen har pausats. Återuppta den.

  • 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed – lagringskontot finns inte i listan över regler för utgående brandvägg.

  • 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte

  • 404 SourceDatabaseNotFound – källdatabasen finns inte.

  • 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen.

  • 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – Genomsökning av sårbarhetsbedömning pågår redan.

  • 500 DatabaseIsUnavailable – Inläsningen misslyckades. Försök igen senare.

Exempel

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
      }
    }
  ]
}

Definitioner

VulnerabilityAssessmentName

Namnet på sårbarhetsbedömningen.

VulnerabilityAssessmentScanError

Egenskaper för ett genomsökningsfel för sårbarhetsbedömning.

VulnerabilityAssessmentScanRecord

En genomsökningspost för sårbarhetsbedömning.

VulnerabilityAssessmentScanRecordListResult

En lista över poster för sårbarhetsbedömningsgenomsökning.

VulnerabilityAssessmentScanState

Genomsökningsstatus.

VulnerabilityAssessmentScanTriggerType

Typ av genomsökningsutlösare.

VulnerabilityAssessmentName

Namnet på sårbarhetsbedömningen.

Name Type Description
default
  • string

VulnerabilityAssessmentScanError

Egenskaper för ett genomsökningsfel för sårbarhetsbedömning.

Name Type Description
code
  • string

Felkoden.

message
  • string

Felmeddelandet.

VulnerabilityAssessmentScanRecord

En genomsökningspost för sårbarhetsbedömning.

Name Type Description
id
  • string

Resurs-ID.

name
  • string

Resursnamn.

properties.endTime
  • string

Genomsökningens sluttid (UTC).

properties.errors

Genomsökningsfelen.

properties.numberOfFailedSecurityChecks
  • integer

Antalet misslyckade säkerhetskontroller.

properties.scanId
  • string

Genomsöknings-ID:t.

properties.startTime
  • string

Genomsökningens starttid (UTC).

properties.state

Genomsökningsstatus.

properties.storageContainerPath
  • string

Genomsökningen resulterar i lagringscontainerns sökväg.

properties.triggerType

Typ av genomsökningsutlösare.

type
  • string

Resurstyp.

VulnerabilityAssessmentScanRecordListResult

En lista över poster för sårbarhetsbedömningsgenomsökning.

Name Type Description
nextLink
  • string

Länka för att hämta nästa sida med resultat.

value

Matris med resultat.

VulnerabilityAssessmentScanState

Genomsökningsstatus.

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

VulnerabilityAssessmentScanTriggerType

Typ av genomsökningsutlösare.

Name Type Description
OnDemand
  • string
Recurring
  • string