Sql Vulnerability Assessment Execute Scan - Execute

Dienst:

SQL Database

API-Version:

2023-08-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/sqlVulnerabilityAssessments/default/initiateScan?systemDatabaseName=master&api-version=2023-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName	path	True	string	Der Name des Servers.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	Der Name der Sicherheitsrisikobewertung.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.
systemDatabaseName	query	True	VulnerabilityAssessmentSystemDatabaseName	Der Name der Systemdatenbank für die Sicherheitsrisikobewertung.

Antworten

Name	Typ	Beschreibung
200 OK		Eine Datenbanküberprüfung der Sicherheitsrisikobewertung wurde erfolgreich ausgeführt.
202 Accepted		Eine Datenbanküberprüfung der Sicherheitsrisikobewertung wurde erfolgreich gestartet. Header Location: string
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 SqlVulnerabilityAssessmentIsDisabled – Sql-Sicherheitsrisikobewertungsfeature ist deaktiviert. Aktivieren Sie das Feature, bevor Sie andere SQL-Sicherheitsrisikobewertungsvorgänge ausführen. 400 InvalidVulnerabilityAssessmentOperationRequest – Die Anforderung für die Sicherheitsrisikobewertung ist nicht vorhanden oder verfügt über kein Eigenschaftenobjekt. 400 DataSecurityInvalidUserSuppliedParameter – Ein ungültiger Parameterwert wurde vom Client bereitgestellt. 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden. 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist. 404 SourceDatabaseNotFound – Die Quelldatenbank ist nicht vorhanden. 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - SQL Vulnerability Assessment Scan ist bereits in Bearbeitung 409 VulnerabilityAssessmentStoragelessIsEnabled – Sicherheitsrisikobewertung ist auf diesem Server oder einer der zugrunde liegenden Datenbanken mit einer inkompatiblen Version aktiviert. Weitere Informationen zur Problembehandlung finden Sie https://aka.ms/SQLVAStoragelessDocumentation. 409 CannotCancelOperation – Der Verwaltungsvorgang befindet sich in einem Zustand, der nicht abgebrochen werden kann. 409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted – Der Vorgang für die Ressource konnte nicht abgeschlossen werden, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 500 DatabaseIsUnavailable - Fehler beim Laden. Versuchen Sie es später erneut. 500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut. 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, 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/servers/vulnerabilityassessmenttest-6411/sqlVulnerabilityAssessments/default/initiateScan?systemDatabaseName=master&api-version=2023-08-01

Beispiel für eine Antwort

Statuscode:

200

Statuscode:

202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/SqlVulnerabilityAssessmentScansExecute/00000000-1111-2222-3333-444444444444?api-version=2022-02-01-preview

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
VulnerabilityAssessmentName	Der Name der Sicherheitsrisikobewertung.
VulnerabilityAssessmentSystemDatabaseName	Der Name der Systemdatenbank für die Sicherheitsrisikobewertung.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

VulnerabilityAssessmentName

Enumeration

Der Name der Sicherheitsrisikobewertung.

Wert	Beschreibung
default

VulnerabilityAssessmentSystemDatabaseName

Enumeration

Der Name der Systemdatenbank für die Sicherheitsrisikobewertung.

Wert	Beschreibung
master