Database Sql Vulnerability Assessment Scans - Get

Referentie

Service:: SQL Database

API-versie:: 2024-05-01-preview

Bekijk een scanresultaat voor de evaluatie van beveiligingsproblemen in de database.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/sqlVulnerabilityAssessments/default/scans/{scanId}?api-version=2024-05-01-preview

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
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.
scanId	path	True	string	De scan-id voor de evaluatie van beveiligingsproblemen van de scan die moet worden opgehaald.
serverName	path	True	string	De naam van de server.
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	SqlVulnerabilityAssessmentScanRecord	De scan voor evaluatie van beveiligingsproblemen in de database is opgehaald.
Other Status Codes	ErrorResponse	Foutreacties: *** 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : er is een ongeldige parameterwaarde opgegeven door de client. 400 InvalidSqlVulnerabilityAssessmentBaselineInput: de basislijninvoer voor evaluatie van SQL-beveiligingsproblemen is null of leeg. 400 InvalidSqlVulnerabilityAssessmentSettingsInput : de invoer van de instelling sql-beveiligingsproblemen is null of leeg 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - Evaluatieresultaten van SQL-beveiligingsproblemen zijn nog niet beschikbaar. Probeer het later opnieuw. 400 SqlVulnerabilityAssessmentInvalidRuleId : de id van de sql-beveiligingsevaluatieregel is ongeldig. 400 SqlVulnerabilityAssessmentScanDoesNotExist - Scan voor evaluatie van SQL-beveiligingsproblemen bestaat niet. 400 SqlVulnerabilityAssessmentNoBaseline - Er is geen basislijn gevonden voor de meest recente scan in de resource 400 SqlVulnerabilityAssessmentNoRuleBaseline - Er is geen basislijn voor evaluatie van SQL-beveiligingsproblemen gevonden 400 SqlVulnerabilityAssessmentBaselineNoScanResults - Er zijn geen scanresultaten gevonden voor regel-id. Als u een basislijn wilt instellen, moeten er resultaten zijn voor deze regel in de meest recente scan beschikbaar 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - Invoer voor binaire regel is geen booleaanse weergave 400 SqlVulnerabilityAssessmentBadRuleFormat - De opgegeven resultaten voldoen niet aan de werkelijke indeling van de scanresultaten 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat - De opgegeven resultaten voldoen niet aan de werkelijke indeling van de scanresultaten 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - Invoer voor binaire regel is geen booleaanse weergave 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId - Er zijn geen scanresultaten gevonden voor een van de regels. Als u een basislijn wilt instellen, moeten er resultaten zijn voor deze regel in de meest recente scan beschikbaar 400 SqlVulnerabilityAssessmentEmptyBaseline - Basislijn niet ingesteld omdat de resultaten null of leeg zijn 400 SqlVulnerabilityAssessmentIsDisabled : de evaluatiefunctie voor SQL-beveiligingsproblemen is uitgeschakeld. Schakel de functie in voordat u andere SQL-evaluatiebewerkingen voor beveiligingsproblemen uitvoert. 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 serverexemplaren. 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - Evaluatie van beveiligingsproblemen is ingeschakeld op deze server of een van de onderliggende databases met een incompatibele versie. Aanvullende informatie over probleemoplossing vindt u https://aka.ms/SQLVAStoragelessDocumentation. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - Scan voor evaluatie van SQL-beveiligingsproblemen wordt al uitgevoerd 500 DatabaseIsUnavailable - Laden is mislukt. Probeer het later opnieuw.

Name

Type

Description

200 OK

SqlVulnerabilityAssessmentScanRecord

De scan voor evaluatie van beveiligingsproblemen in de database is opgehaald.

Other Status Codes

ErrorResponse

Foutreacties: ***

400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : er is een ongeldige parameterwaarde opgegeven door de client.
400 InvalidSqlVulnerabilityAssessmentBaselineInput: de basislijninvoer voor evaluatie van SQL-beveiligingsproblemen is null of leeg.
400 InvalidSqlVulnerabilityAssessmentSettingsInput : de invoer van de instelling sql-beveiligingsproblemen is null of leeg
400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - Evaluatieresultaten van SQL-beveiligingsproblemen zijn nog niet beschikbaar. Probeer het later opnieuw.
400 SqlVulnerabilityAssessmentInvalidRuleId : de id van de sql-beveiligingsevaluatieregel is ongeldig.
400 SqlVulnerabilityAssessmentScanDoesNotExist - Scan voor evaluatie van SQL-beveiligingsproblemen bestaat niet.
400 SqlVulnerabilityAssessmentNoBaseline - Er is geen basislijn gevonden voor de meest recente scan in de resource
400 SqlVulnerabilityAssessmentNoRuleBaseline - Er is geen basislijn voor evaluatie van SQL-beveiligingsproblemen gevonden
400 SqlVulnerabilityAssessmentBaselineNoScanResults - Er zijn geen scanresultaten gevonden voor regel-id. Als u een basislijn wilt instellen, moeten er resultaten zijn voor deze regel in de meest recente scan beschikbaar
400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - Invoer voor binaire regel is geen booleaanse weergave
400 SqlVulnerabilityAssessmentBadRuleFormat - De opgegeven resultaten voldoen niet aan de werkelijke indeling van de scanresultaten
400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat - De opgegeven resultaten voldoen niet aan de werkelijke indeling van de scanresultaten
400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - Invoer voor binaire regel is geen booleaanse weergave
400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId - Er zijn geen scanresultaten gevonden voor een van de regels. Als u een basislijn wilt instellen, moeten er resultaten zijn voor deze regel in de meest recente scan beschikbaar
400 SqlVulnerabilityAssessmentEmptyBaseline - Basislijn niet ingesteld omdat de resultaten null of leeg zijn
400 SqlVulnerabilityAssessmentIsDisabled : de evaluatiefunctie voor SQL-beveiligingsproblemen is uitgeschakeld. Schakel de functie in voordat u andere SQL-evaluatiebewerkingen voor beveiligingsproblemen uitvoert.
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 serverexemplaren.
409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - Evaluatie van beveiligingsproblemen is ingeschakeld op deze server of een van de onderliggende databases met een incompatibele versie. Aanvullende informatie over probleemoplossing vindt u https://aka.ms/SQLVAStoragelessDocumentation.
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - Scan voor evaluatie van SQL-beveiligingsproblemen wordt al uitgevoerd
500 DatabaseIsUnavailable - Laden is mislukt. Probeer het later opnieuw.

Voorbeelden

Get a database's vulnerability assessment scan.

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/sqlVulnerabilityAssessments/default/scans/scan001?api-version=2024-05-01-preview

Voorbeeldrespons

Statuscode:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/sqlVulnerabilityAssessments/default/scans/scan001",
  "name": "scan001",
  "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments/scans",
  "properties": {
    "scanId": "scan001",
    "triggerType": "Recurring",
    "state": "Failed",
    "server": "vulnerabilityassessmenttest-6411",
    "database": "testdb",
    "sqlVersion": "15.0.2000",
    "startTime": "2020-06-23T12:19:00.6455136+05:30",
    "endTime": "2020-06-23T06:49:00.7236217Z",
    "highSeverityFailedRulesCount": 3,
    "mediumSeverityFailedRulesCount": 2,
    "lowSeverityFailedRulesCount": 1,
    "totalPassedRulesCount": 20,
    "totalFailedRulesCount": 6,
    "totalRulesCount": 26,
    "isBaselineApplied": false,
    "lastScanTime": "2020-06-23T12:19:00.6455136+05:30"
  }
}

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
SqlVulnerabilityAssessmentScanError	Eigenschappen van een scanfout in de evaluatie van beveiligingsproblemen.
SqlVulnerabilityAssessmentScanRecord	Een scanrecord voor evaluatie van beveiligingsproblemen.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
VulnerabilityAssessmentName	De naam van de evaluatie van beveiligingsproblemen.
VulnerabilityAssessmentScanState	De scanstatus.
VulnerabilityAssessmentScanTriggerType	Het type scantrigger.

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

SqlVulnerabilityAssessmentScanError

Object

Eigenschappen van een scanfout in de evaluatie van beveiligingsproblemen.

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

SqlVulnerabilityAssessmentScanRecord

Object

Een scanrecord voor evaluatie van beveiligingsproblemen.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.database	string	De naam van de database.
properties.endTime	string (date-time)	De eindtijd van de scan (UTC).
properties.errors	SqlVulnerabilityAssessmentScanError[]	De scanfouten.
properties.highSeverityFailedRulesCount	integer (int32)	Het aantal mislukte regels met hoge ernst.
properties.isBaselineApplied	boolean	Basislijn gemaakt voor deze database en heeft een of meer regels.
properties.lastScanTime	string (date-time)	De laatste scantijd.
properties.lowSeverityFailedRulesCount	integer (int32)	Het aantal mislukte regels met een lage ernst.
properties.mediumSeverityFailedRulesCount	integer (int32)	Het aantal mislukte regels met gemiddelde ernst.
properties.scanId	string	De scan-id.
properties.server	string	De servernaam.
properties.sqlVersion	string	De SQL-versie.
properties.startTime	string (date-time)	De begintijd van de scan (UTC).
properties.state	VulnerabilityAssessmentScanState	De scanstatus.
properties.totalFailedRulesCount	integer (int32)	Het aantal mislukte regels in totaal.
properties.totalPassedRulesCount	integer (int32)	Het aantal doorgegeven regels.
properties.totalRulesCount	integer (int32)	Het aantal geëvalueerde totale regels.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Het type scantrigger.
systemData	systemData	SystemData van SqlVulnerabilityAssessmentScanRecordResource.
type	string	Resourcetype.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

VulnerabilityAssessmentName

Inventarisatie

De naam van de evaluatie van beveiligingsproblemen.

Waarde	Description
default

VulnerabilityAssessmentScanState

Inventarisatie

De scanstatus.

Waarde	Description
Failed
FailedToRun
InProgress
Passed

VulnerabilityAssessmentScanTriggerType

Inventarisatie

Het type scantrigger.

Waarde	Description
OnDemand
Recurring

Delen via

Database Sql Vulnerability Assessment Scans - Get

URI-parameters

Antwoorden

Voorbeelden

Get a database's vulnerability assessment scan.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SqlVulnerabilityAssessmentScanError

SqlVulnerabilityAssessmentScanRecord

systemData

VulnerabilityAssessmentName

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

Aanvullende resources