Database Sql Vulnerability Assessments Settings - List By Database

Service:

SQL Database

API Version:

2023-08-01-preview

Listor sql-principer för sårbarhetsbedömning som är associerade med en databas.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/sqlVulnerabilityAssessments?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	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	SqlVulnerabilityAssessmentListResult	Sql Vulnerability Assessment-principer har hämtats på en viss databas.
Other Status Codes	ErrorResponse	Felsvar: *** 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter – ett ogiltigt parametervärde angavs av klienten. 400 InvalidSqlVulnerabilityAssessmentBaselineInput – Baslinjeindata för SQL-sårbarhetsbedömningen är null eller tomma. 400 InvalidSqlVulnerabilityAssessmentSettingsInput – Indata för SQL-sårbarhetsbedömningsinställningen är null eller tom 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet – Resultat av SQL-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-genomsökningen för sårbarhetsbedömning 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ökningsresultatet 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat – De angivna resultaten överensstämmer inte med den faktiska layouten för genomsökningsresultatet 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 400 SqlVulnerabilityAssessmentIsDisabled – SQL-funktionen för sårbarhetsbedömning är inaktiverad. Aktivera funktionen innan du kör andra SQL-sårbarhetsbedömningsåtgärder. 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 SqlVulnerabilityAssessmentStoragefullApiIsEnabled – Sårbarhetsbedömning är aktiverat på den här servern eller någon av dess underliggande databaser med en inkompatibel version. Ytterligare felsökningsinformation finns https://aka.ms/SQLVAStoragelessDocumentation. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – SQL Vulnerability Assessment-genomsökning pågår redan 500 DatabaseIsUnavailable – Inläsningen misslyckades. Försök igen senare.

Exempel

Get SQL Vulnerability Assessment policies on a given database

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/sqlVulnerabilityAssessments?api-version=2023-08-01-preview

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/sqlVulnerabilityAssessments/default",
      "name": "default",
      "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments",
      "properties": {
        "state": "Enabled"
      }
    }
  ]
}

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
SqlVulnerabilityAssessment	En sårbarhetsbedömning för SQL.
SqlVulnerabilityAssessmentListResult	En lista över sårbarhetsbedömningar i SQL.
SqlVulnerabilityAssessmentState	Anger tillståndet för SQL-sårbarhetsbedömningen, om den är aktiverad eller inaktiverad eller om ett tillstånd ännu inte har tillämpats på den specifika databasen eller servern.
systemData	Metadata som rör skapande och senaste ändring av resursen.

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	Den ytterligare informationen.
type	string	Ytterligare informationstyp.

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.

SqlVulnerabilityAssessment

En sårbarhetsbedömning för SQL.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.state	SqlVulnerabilityAssessmentState	Anger tillståndet för SQL-sårbarhetsbedömningen, om den är aktiverad eller inaktiverad eller om ett tillstånd ännu inte har tillämpats på den specifika databasen eller servern.
systemData	systemData	SystemData för SqlVulnerabilityAssessmentResource.
type	string	Resurstyp.

SqlVulnerabilityAssessmentListResult

En lista över sårbarhetsbedömningar i SQL.

Name	Typ	Description
nextLink	string	Länk för att hämta nästa sida med resultat.
value	SqlVulnerabilityAssessment[]	Matris med resultat.

SqlVulnerabilityAssessmentState

Anger tillståndet för SQL-sårbarhetsbedömningen, om den är aktiverad eller inaktiverad eller om ett tillstånd ännu inte har tillämpats på den specifika databasen eller servern.

Name	Typ	Description
Disabled	string
Enabled	string

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.