Managed Database Vulnerability Assessment Scans - List By Database

Service:

SQL Database

API-versie:

2021-11-01

Lijsten de scans van de evaluatie van beveiligingsproblemen van een database.

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-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
managedInstanceName	path	True	string	De naam van het beheerde exemplaar.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	De naam van de evaluatie van beveiligingsproblemen.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name	Type	Description
200 OK	VulnerabilityAssessmentScanRecordListResult	De scanrecords voor de evaluatie van beveiligingsproblemen in de database zijn opgehaald.
Other Status Codes		Foutreacties: *** 400 InvalidStorageAccountName : het opgegeven opslagaccount is ongeldig of bestaat niet. 400 InvalidStorageAccountCredentials: de opgegeven shared access signature of accountopslagsleutel van het opslagaccount is ongeldig. 400 VulnerabilityAssessmentInvalidPolicy - Instellingen voor evaluatie van beveiligingsproblemen bestaan niet of er is een ongeldige opslag opgegeven in de instellingen. 400 VulnerabilityAssessmentADSIsDisabled - Advanced Data Security moet zijn ingeschakeld om evaluatie van beveiligingsproblemen te kunnen gebruiken. 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath - Opslagcontainerpad moet worden opgegeven als dit niet is ingesteld in beleid op serverniveau 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated - Kan de evaluatiebewerking voor beveiligingsproblemen niet uitvoeren omdat de database is onderbroken. Alsjeblieft hervatten. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed - Het opslagaccount staat niet in de lijst met uitgaande firewallregels. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 SourceDatabaseNotFound - De brondatabase bestaat niet. 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaar. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - Scan voor evaluatie van beveiligingsproblemen wordt al uitgevoerd. 500 DatabaseIsUnavailable - Laden is mislukt. Probeert u het later nog eens.

Voorbeelden

Gets the list of a database vulnerability assessment scan records

Voorbeeldaanvraag

HTTP

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

Java

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
VulnerabilityAssessmentName	De naam van de evaluatie van beveiligingsproblemen.
VulnerabilityAssessmentScanError	Eigenschappen van een scanfout bij de evaluatie van beveiligingsproblemen.
VulnerabilityAssessmentScanRecord	Een scanrecord voor de evaluatie van beveiligingsproblemen.
VulnerabilityAssessmentScanRecordListResult	Een lijst met scanrecords voor evaluatie van beveiligingsproblemen.
VulnerabilityAssessmentScanState	De scanstatus.
VulnerabilityAssessmentScanTriggerType	Het type scantrigger.

VulnerabilityAssessmentName

Enumeration

De naam van de evaluatie van beveiligingsproblemen.

Waarde	Description
default

VulnerabilityAssessmentScanError

Object

Eigenschappen van een scanfout bij de evaluatie van beveiligingsproblemen.

Name	Type	Description
code	string	De foutcode.
message	string	Het foutbericht.

VulnerabilityAssessmentScanRecord

Object

Een scanrecord voor de evaluatie van beveiligingsproblemen.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.endTime	string	De eindtijd van de scan (UTC).
properties.errors	VulnerabilityAssessmentScanError[]	De scanfouten.
properties.numberOfFailedSecurityChecks	integer	Het aantal mislukte beveiligingscontroles.
properties.scanId	string	De scan-id.
properties.startTime	string	De begintijd van de scan (UTC).
properties.state	VulnerabilityAssessmentScanState	De scanstatus.
properties.storageContainerPath	string	Het opslagcontainerpad met scanresultaten.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Het type scantrigger.
type	string	Resourcetype.

VulnerabilityAssessmentScanRecordListResult

Object

Een lijst met scanrecords voor evaluatie van beveiligingsproblemen.

Name	Type	Description
nextLink	string	Koppeling om de volgende pagina met resultaten op te halen.
value	VulnerabilityAssessmentScanRecord[]	Matrix met resultaten.

VulnerabilityAssessmentScanState

Enumeration

De scanstatus.

Waarde	Description
Failed
FailedToRun
InProgress
Passed

VulnerabilityAssessmentScanTriggerType

Enumeration

Het type scantrigger.

Waarde	Description
OnDemand
Recurring