Managed Database Vulnerability Assessment Scans - List By Database

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Listor genomsökningar av sårbarhetsbedömningar 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-11-01

URI-parametrar

Name	I	Obligatorisk	Typ	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	VulnerabilityAssessmentName	Namnet på sårbarhetsbedömningen.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	VulnerabilityAssessmentScanRecordListResult	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 – Sökvägen till lagringscontainern 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.

Name

Typ

Description

200 OK

VulnerabilityAssessmentScanRecordListResult

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 – Sökvägen till lagringscontainern 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

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-11-01


import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;

/**
 * Samples for ManagedDatabaseVulnerabilityAssessmentScans ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseVulnerabilityAssessmentScanRecordsListByDatabase.json
     */
    /**
     * Sample code: Gets the list of a database vulnerability assessment scan records.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheListOfADatabaseVulnerabilityAssessmentScanRecords(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseVulnerabilityAssessmentScans().listByDatabase(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, 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

Exempelsvar

Statuskod:: 200

{
  "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

Name	Description
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	Typ	Description
default	string

VulnerabilityAssessmentScanError

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

Name	Typ	Description
code	string	Felkoden.
message	string	Felmeddelandet.

VulnerabilityAssessmentScanRecord

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

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.endTime	string	Genomsökningens sluttid (UTC).
properties.errors	VulnerabilityAssessmentScanError[]	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	VulnerabilityAssessmentScanState	Genomsökningsstatus.
properties.storageContainerPath	string	Genomsökningen resulterar i lagringscontainerns sökväg.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Typ av genomsökningsutlösare.
type	string	Resurstyp.

VulnerabilityAssessmentScanRecordListResult

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

Name	Typ	Description
nextLink	string	Länka för att hämta nästa sida med resultat.
value	VulnerabilityAssessmentScanRecord[]	Matris med resultat.

VulnerabilityAssessmentScanState

Genomsökningsstatus.

Name	Typ	Description
Failed	string
FailedToRun	string
InProgress	string
Passed	string

VulnerabilityAssessmentScanTriggerType

Typ av genomsökningsutlösare.

Name	Typ	Description
OnDemand	string
Recurring	string

Dela via

Managed Database Vulnerability Assessment Scans - List By Database

URI-parametrar

Svar

Exempel

Gets the list of a database vulnerability assessment scan records

Exempelbegäran

Exempelsvar

Definitioner

VulnerabilityAssessmentName

VulnerabilityAssessmentScanError

VulnerabilityAssessmentScanRecord

VulnerabilityAssessmentScanRecordListResult

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

Ytterligare resurser