Database Sql Vulnerability Assessment Scans - List By Sql Vulnerability Assessments

Referens

Service:: SQL Database

API Version:: 2023-08-01-preview

Listor genomsökningar av sårbarhetsbedömningar av en databas.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseName	path	True	string	Namnet på databasen.
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.
serverName	path	True	string	Namnet på servern.
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	SqlVulnerabilityAssessmentScanRecordListResult	Databasens sårbarhetsbedömningsgenomsökningsposter har hämtats.
Other Status Codes	ErrorResponse	Felsvar: *** 400 SqlVulnerabilityAssessmentIsDisabled – SQL-funktionen för sårbarhetsbedömning är inaktiverad. aktivera funktionen innan du kör andra SQL-sårbarhetsbedömningsåtgärder. 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter – Ett ogiltigt parametervärde angavs av klienten. 400 InvalidSqlVulnerabilityAssessmentBaselineInput – baslinjeindata för SQL-sårbarhetsbedömning är null eller tomma. 400 InvalidSqlVulnerabilityAssessmentSettingsInput – Indata för SQL-sårbarhetsbedömningen är null eller tom 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet – SQL-resultat för sårbarhetsbedömning är inte tillgängliga ännu. Försök igen senare. 400 SqlVulnerabilityAssessmentInvalidRuleId – SQL:s regel-ID för sårbarhetsbedömning är ogiltigt. 400 SqlVulnerabilityAssessmentScanDoesNotExist – SQL sårbarhetsbedömningsgenomsökning finns inte. 400 SqlVulnerabilityAssessmentNoBaseline – Ingen baslinje har hittats för den senaste genomsökningen i resursen 400 SqlVulnerabilityAssessmentNoRuleBaseline – Ingen baslinje för SQL-sårbarhetsbedömning hittades 400 SqlVulnerabilityAssessmentBaselineNoScanResults – Inga genomsökningsresultat har hittats för regel-ID. Om du vill ange en baslinje måste det finnas resultat för den här regeln i den senaste tillgängliga genomsökningen 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat – Indata för binär regel är inte en boolesk representation 400 SqlVulnerabilityAssessmentBadRuleFormat – De angivna resultaten överensstämmer inte med den faktiska layouten för genomsökningsresultaten 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat – De angivna resultaten överensstämmer inte med den faktiska layouten för genomsökningsresultaten 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat – Indata för binär regel är inte en boolesk representation 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId – Inga genomsökningsresultat har hittats för någon av reglerna. Om du vill ange en baslinje måste det finnas resultat för den här regeln i den senaste tillgängliga genomsökningen 400 SqlVulnerabilityAssessmentEmptyBaseline – Baslinjen har inte angetts eftersom resultatet är null eller tomt 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 – SQL Vulnerability Assessment-genomsökning pågår redan 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled – Sårbarhetsbedömning är aktiverat på den här servern eller en av dess underliggande databaser med en inkompatibel version. Ytterligare felsökningsinformation finns https://aka.ms/SQLVAStoragelessDocumentation. 500 DatabaseIsUnavailable – Inläsningen misslyckades. Försök igen senare.

Name

Typ

Description

200 OK

SqlVulnerabilityAssessmentScanRecordListResult

Databasens sårbarhetsbedömningsgenomsökningsposter har hämtats.

Other Status Codes

ErrorResponse

Felsvar: ***

400 SqlVulnerabilityAssessmentIsDisabled – SQL-funktionen för sårbarhetsbedömning är inaktiverad. aktivera funktionen innan du kör andra SQL-sårbarhetsbedömningsåtgärder.
400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter – Ett ogiltigt parametervärde angavs av klienten.
400 InvalidSqlVulnerabilityAssessmentBaselineInput – baslinjeindata för SQL-sårbarhetsbedömning är null eller tomma.
400 InvalidSqlVulnerabilityAssessmentSettingsInput – Indata för SQL-sårbarhetsbedömningen är null eller tom
400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet – SQL-resultat för sårbarhetsbedömning är inte tillgängliga ännu. Försök igen senare.
400 SqlVulnerabilityAssessmentInvalidRuleId – SQL:s regel-ID för sårbarhetsbedömning är ogiltigt.
400 SqlVulnerabilityAssessmentScanDoesNotExist – SQL sårbarhetsbedömningsgenomsökning finns inte.
400 SqlVulnerabilityAssessmentNoBaseline – Ingen baslinje har hittats för den senaste genomsökningen i resursen
400 SqlVulnerabilityAssessmentNoRuleBaseline – Ingen baslinje för SQL-sårbarhetsbedömning hittades
400 SqlVulnerabilityAssessmentBaselineNoScanResults – Inga genomsökningsresultat har hittats för regel-ID. Om du vill ange en baslinje måste det finnas resultat för den här regeln i den senaste tillgängliga genomsökningen
400 SqlVulnerabilityAssessmentBadBinaryRuleFormat – Indata för binär regel är inte en boolesk representation
400 SqlVulnerabilityAssessmentBadRuleFormat – De angivna resultaten överensstämmer inte med den faktiska layouten för genomsökningsresultaten
400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat – De angivna resultaten överensstämmer inte med den faktiska layouten för genomsökningsresultaten
400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat – Indata för binär regel är inte en boolesk representation
400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId – Inga genomsökningsresultat har hittats för någon av reglerna. Om du vill ange en baslinje måste det finnas resultat för den här regeln i den senaste tillgängliga genomsökningen
400 SqlVulnerabilityAssessmentEmptyBaseline – Baslinjen har inte angetts eftersom resultatet är null eller tomt
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 – SQL Vulnerability Assessment-genomsökning pågår redan
409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled – Sårbarhetsbedömning är aktiverat på den här servern eller en av dess underliggande databaser med en inkompatibel version. Ytterligare felsökningsinformation finns https://aka.ms/SQLVAStoragelessDocumentation.
500 DatabaseIsUnavailable – Inläsningen misslyckades. Försök igen senare.

Exempel

Gets the list of a database vulnerability assessment scan records

Sample Request

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?api-version=2023-08-01-preview

Sample Response

Status code:: 200

{
  "value": [
    {
      "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"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/sqlVulnerabilityAssessments/default/scans/scan002",
      "name": "scan001",
      "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan002",
        "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"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/sqlVulnerabilityAssessments/default/scans/scan003",
      "name": "scan001",
      "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan003",
        "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"
      }
    }
  ]
}

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
SqlVulnerabilityAssessmentScanError	Egenskaper för ett genomsökningsfel för sårbarhetsbedömning.
SqlVulnerabilityAssessmentScanRecord	En genomsökningspost för sårbarhetsbedömning.
SqlVulnerabilityAssessmentScanRecordListResult	En lista över poster för sårbarhetsbedömningsgenomsökning.
systemData	Metadata som rör skapande och senaste ändring av resursen.
VulnerabilityAssessmentName	Namnet på sårbarhetsbedömningen.
VulnerabilityAssessmentScanState	Genomsökningsstatus.
VulnerabilityAssessmentScanTriggerType	Typ av genomsökningsutlösare.

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

SqlVulnerabilityAssessmentScanError

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

Name	Typ	Description
code	string	Felkoden.
message	string	Felmeddelandet.

SqlVulnerabilityAssessmentScanRecord

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

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.database	string	Databasnamnet.
properties.endTime	string	Genomsökningens sluttid (UTC).
properties.errors	SqlVulnerabilityAssessmentScanError[]	Genomsökningsfelen.
properties.highSeverityFailedRulesCount	integer	Antalet misslyckade regler med hög allvarlighetsgrad.
properties.isBaselineApplied	boolean	Baslinje som skapats för den här databasen och har en eller flera regler.
properties.lastScanTime	string	Den senaste genomsökningstiden.
properties.lowSeverityFailedRulesCount	integer	Antalet misslyckade regler med låg allvarlighetsgrad.
properties.mediumSeverityFailedRulesCount	integer	Antalet misslyckade regler med medelhög allvarlighetsgrad.
properties.scanId	string	Genomsöknings-ID:t.
properties.server	string	Servernamnet.
properties.sqlVersion	string	SQL-versionen.
properties.startTime	string	Genomsökningens starttid (UTC).
properties.state	VulnerabilityAssessmentScanState	Genomsökningsstatus.
properties.totalFailedRulesCount	integer	Antalet totalt misslyckade regler.
properties.totalPassedRulesCount	integer	Antalet regler som har godkänts totalt.
properties.totalRulesCount	integer	Antalet totala regler som utvärderas.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Typ av genomsökningsutlösare.
systemData	systemData	SystemData för SqlVulnerabilityAssessmentScanRecordResource.
type	string	Resurstyp.

SqlVulnerabilityAssessmentScanRecordListResult

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	SqlVulnerabilityAssessmentScanRecord[]	Matris med resultat.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

VulnerabilityAssessmentName

Namnet på sårbarhetsbedömningen.

Name	Typ	Description
default	string

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

Database Sql Vulnerability Assessment Scans - List By Sql Vulnerability Assessments

URI-parametrar

Svar

Exempel

Gets the list of a database vulnerability assessment scan records

Sample Request

Sample Response

Definitioner

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SqlVulnerabilityAssessmentScanError

SqlVulnerabilityAssessmentScanRecord

SqlVulnerabilityAssessmentScanRecordListResult

systemData

VulnerabilityAssessmentName

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

Ytterligare resurser