Sql Vulnerability Assessment Rule Baseline - Create Or Update

Service:

SQL Database

API Version:

2023-08-01-preview

Skapar eller uppdaterar en databas baslinje för sårbarhetsbedömningsregler.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
baselineName	path	True	BaselineName
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.
ruleId	path	True	string	Regel-ID för sårbarhetsbedömning.
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å sårbarhetsbedömningen.
api-version	query	True	string	DEN API-version som ska användas för begäran.
systemDatabaseName	query	True	VulnerabilityAssessmentSystemDatabaseName	Databasnamnet för sårbarhetsbedömningssystemet.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.latestScan	True	boolean	Den senaste genomsökningsflaggan
properties.results	True	string[]	Baslinjeresultatet för regeln

Svar

Name	Typ	Description
200 OK	DatabaseSqlVulnerabilityAssessmentRuleBaseline	Ange baslinjen för sårbarhetsbedömningsregeln.
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 InvalidSqlVulnerabilityAssessmentBaselineInput – Baslinjeindata för SQL-sårbarhetsbedömningen är null eller tomma. 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter – ett ogiltigt parametervärde angavs av klienten. 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 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 någon 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

Creates or updates a database's vulnerability assessment rule baseline.

Sample Request

HTTP

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

{
  "properties": {
    "latestScan": false,
    "results": [
      [
        "userA",
        "SELECT"
      ],
      [
        "userB",
        "SELECT"
      ],
      [
        "userC",
        "SELECT"
      ]
    ]
  }
}

Sample Response

Status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/sqlVulnerabilityAssessments/default/rules/VA1001",
  "name": "Scan123",
  "type": "Microsoft.Sql/servers/vulnerabilityAssessments/rules/baselines",
  "properties": {
    "results": [
      [
        "userA",
        "SELECT"
      ],
      [
        "userB",
        "SELECT"
      ],
      [
        "userC",
        "SELECT"
      ]
    ]
  }
}

Definitioner

Name	Description
BaselineName
createdByType	Den typ av identitet som skapade resursen.
DatabaseSqlVulnerabilityAssessmentRuleBaseline	En databas med en regelbaslinje för sql-sårbarhetsbedömning.
DatabaseSqlVulnerabilityAssessmentRuleBaselineInput	En databas sql vulnerability assessment rule baseline input.a database sql vulnerability assessment rule baseline input.a database sql vulnerability assessment rule baseline input.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
systemData	Metadata som rör skapande och senaste ändring av resursen.
VulnerabilityAssessmentName	Namnet på sårbarhetsbedömningen.
VulnerabilityAssessmentSystemDatabaseName	Databasnamnet för sårbarhetsbedömningssystemet.

BaselineName

Name	Typ	Description
default	string

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DatabaseSqlVulnerabilityAssessmentRuleBaseline

En databas med en regelbaslinje för sql-sårbarhetsbedömning.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.results	string[]	Baslinjeresultatet för regeln
systemData	systemData	SystemData för DatabaseSqlVulnerabilityAssessmentRuleBaselineResource.
type	string	Resurstyp.

DatabaseSqlVulnerabilityAssessmentRuleBaselineInput

En databas sql vulnerability assessment rule baseline input.a database sql vulnerability assessment rule baseline input.a database sql vulnerability assessment rule baseline input.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.latestScan	boolean	Den senaste genomsökningsflaggan
properties.results	string[]	Baslinjeresultatet för regeln
systemData	systemData	SystemData för DatabaseSqlVulnerabilityAssessmentRuleBaselineInputResource.
type	string	Resurstyp.

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.

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

VulnerabilityAssessmentSystemDatabaseName

Databasnamnet för sårbarhetsbedömningssystemet.

Name	Typ	Description
master	string