Database Sql Vulnerability Assessment Baselines - Create Or Update

Service:

SQL Database

API Version:

2023-08-01-preview

Lägg till en databass baslinjelista för sårbarhetsbedömningsregel.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
baselineName	path	True	BaselineName
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.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.latestScan	True	boolean	Den senaste genomsökningsflaggan
properties.results	True	object	Resultatlistan för regelbaslinje

Svar

Name	Typ	Description
200 OK	DatabaseSqlVulnerabilityAssessmentBaselineSet	Lägg till baslinjelistan 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ömning ä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ö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

Add a database's vulnerability assessment rule baseline from the latest scan result.

Add a database's vulnerability assessment rule baseline list.

Add a database's vulnerability assessment rule baseline from the latest scan result.

Sample Request

HTTP

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

{
  "properties": {
    "latestScan": true,
    "results": {}
  }
}

Sample Response

Status code:

200

{
  "properties": {
    "results": {
      "VA1020": [],
      "VA1054": [],
      "VA1095": [],
      "VA1096": [],
      "VA1097": [],
      "VA1099": [],
      "VA1143": [
        [
          "True"
        ]
      ],
      "VA1219": [
        [
          "False"
        ]
      ],
      "VA1221": [],
      "VA1223": [],
      "VA1224": [],
      "VA1246": [],
      "VA1248": [],
      "VA1258": [],
      "VA1281": [],
      "VA1282": [],
      "VA2020": [],
      "VA2033": [],
      "VA2062": [],
      "VA2064": [],
      "VA2108": [],
      "VA2109": [],
      "VA2129": [],
      "VA2130": []
    }
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/sqlVulnerabilityAssessments/Default/baselines/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments/baselines"
}

Add a database's vulnerability assessment rule baseline list.

Sample Request

HTTP

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

{
  "properties": {
    "latestScan": false,
    "results": {
      "VA2063": [
        [
          "AllowAll",
          "0.0.0.0",
          "255.255.255.255"
        ]
      ],
      "VA2065": [
        [
          "AllowAll",
          "0.0.0.0",
          "255.255.255.255"
        ]
      ]
    }
  }
}

Sample Response

Status code:

200

{
  "properties": {
    "results": {
      "VA2063": [
        [
          "AllowAll",
          "0.0.0.0",
          "255.255.255.255"
        ]
      ],
      "VA2065": [
        [
          "AllowAll",
          "0.0.0.0",
          "255.255.255.255"
        ]
      ]
    }
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/sqlVulnerabilityAssessments/Default/baselines/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments/baselines"
}

Definitioner

Name	Description
BaselineName
createdByType	Den typ av identitet som skapade resursen.
DatabaseSqlVulnerabilityAssessmentBaselineSet	En databas för sql-baslinje för sårbarhetsbedömning.
DatabaseSqlVulnerabilityAssessmentRuleBaselineListInput	En databas sql vulnerability assessment rule baseline list 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.

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

DatabaseSqlVulnerabilityAssessmentBaselineSet

En databas för sql-baslinje för sårbarhetsbedömning.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.results	object	Baslinjeuppsättningsresultatet
systemData	systemData	SystemData för DatabaseSqlVulnerabilityAssessmentBaselineSetResource.
type	string	Resurstyp.

DatabaseSqlVulnerabilityAssessmentRuleBaselineListInput

En databas sql vulnerability assessment rule baseline list input.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.latestScan	boolean	Den senaste genomsökningsflaggan
properties.results	object	Resultatlistan för regelbaslinje
systemData	systemData	SystemData för DatabaseSqlVulnerabilityAssessmentRuleBaselineListInputResource.
type	string	Resurstyp.

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.

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