Sql Vulnerability Assessments Settings - Create Or Update

Tjänst:

SQL Database

API-version:

2023-08-01-preview

Skapar eller uppdaterar sql-sårbarhetsbedömningsprincipen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
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.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	Namnet på SQL Vulnerability Assessment.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
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.

Svar

Name	Typ	Description
200 OK	SqlVulnerabilityAssessment	Konfigurera SQL Vulnerability Assessment.
201 Created	SqlVulnerabilityAssessment	SQL Vulnerability Assessment har skapats.
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

Create a SQL Vulnerability Assessment policy

Exempelbegäran

HTTP

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

{
  "properties": {
    "state": "Enabled"
  }
}

Exempelsvar

Statuskod:

200

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

Statuskod:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/sqlVulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/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.
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.
VulnerabilityAssessmentName	Namnet på SQL Vulnerability Assessment.

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.

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.

VulnerabilityAssessmentName

Namnet på SQL Vulnerability Assessment.

Name	Typ	Description
default	string