Managed Database Vulnerability Assessment Scans - Initiate Scan

Dienst:

SQL Database

API-Version:

2021-11-01

Führt eine Überprüfung der Datenbank zur Sicherheitsrisikobewertung aus.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
managedInstanceName	path	True	string	Der Name der verwalteten Instanz.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
scanId	path	True	string	Die Überprüfungs-ID der Sicherheitsrisikobewertung des abzurufenden Scans.
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	Der Name der Sicherheitsrisikobewertung.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK		Eine Überprüfung der Datenbank zur Sicherheitsrisikobewertung wurde erfolgreich ausgeführt.
202 Accepted		Die Überprüfung der Datenbank zur Sicherheitsrisikobewertung wurde erfolgreich gestartet.
Other Status Codes		Fehlerantworten: *** 400 InvalidVulnerabilityAssessmentOperationRequest: Die Anforderung für den Vorgang zur Sicherheitsrisikobewertung ist nicht vorhanden oder weist kein Eigenschaftenobjekt auf. 400 DataSecurityInvalidUserSuppliedParameter: Vom Client wurde ein ungültiger Parameterwert bereitgestellt. 400 InvalidVulnerabilityAssessmentScanIdLength: Die Länge der Überprüfungs-ID der Sicherheitsrisikobewertung muss unterhalb der {0} Zeichen liegen. 400 InvalidStorageAccountName: Das angegebene Speicherkonto ist ungültig oder nicht vorhanden. 400 InvalidStorageAccountCredentials: Die angegebene Speicherkonto-Shared Access-Signatur oder der Kontospeicherschlüssel ist ungültig. 400 VulnerabilityAssessmentInvalidPolicy : Einstellungen für die Sicherheitsrisikobewertung sind nicht vorhanden oder ungültiger Speicher in den Einstellungen angegeben. 400 VulnerabilityAssessmentADSIsDisabled: Erweiterte Datensicherheit sollte aktiviert sein, um die Sicherheitsrisikobewertung zu verwenden. 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath : Speichercontainerpfad muss angegeben werden, wenn er nicht in der Richtlinie auf Serverebene festgelegt ist 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated: Der Vorgang zur Sicherheitsrisikobewertung konnte nicht ausgeführt werden, da die Datenbank angehalten wurde. Bitte setzen Sie sie fort. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed: Das Speicherkonto ist nicht in der Liste der ausgehenden Firewallregeln enthalten. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden 404 SourceDatabaseNotFound: Die Quelldatenbank ist nicht vorhanden. 404 DatabaseDoesNotExist: Der Benutzer hat einen Datenbanknamen angegeben, der auf diesem Server instance nicht vorhanden ist. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – Überprüfung der Sicherheitsrisikobewertung wird bereits ausgeführt. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 DatabaseIsUnavailable: Fehler beim Laden. Versuchen Sie es später noch mal. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Executes a database's vulnerability assessment scan.

Beispielanforderung

HTTP

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

Java

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

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

Beispiel für eine Antwort

Statuscode:

200

Statuscode:

202

Definitionen

VulnerabilityAssessmentName

Der Name der Sicherheitsrisikobewertung.

Name	Typ	Beschreibung
default	string