Sql Vulnerability Assessment Scan Result - List By Scan

Referencia

Service:: SQL Database

API Version:: 2023-08-01-preview

Lekéri egy adatbázis biztonságirés-felmérési vizsgálati rekordját.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
scanId	path	True	string	Az SQL Biztonságirés-felmérés vizsgálatának vizsgálati azonosítója az eredmény lekéréséhez.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
vulnerabilityAssessmentName	path	True	SqlVulnerabilityAssessmentName	Az SQL Biztonságirés-felmérés neve.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.
systemDatabaseName	query	True	VulnerabilityAssessmentSystemDatabaseName	Az SQL sebezhetőségi felmérési rendszer adatbázisának neve.

Válaszok

Name	Típus	Description
200 OK	SQLVulnerabilityAssessmentScanListResult	Sikerült lekérni az SQL-sebezhetőségi felmérés vizsgálati eredményeit.
Other Status Codes	ErrorResponse	Hibaválaszok: *** 400 SqlVulnerabilityAssessmentIsDisabled – Az SQL sebezhetőségi felmérési funkciója le van tiltva. engedélyezze a funkciót, mielőtt más SQL biztonságirés-felmérési műveleteket hajt végre. 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter – Az ügyfél érvénytelen paraméterértéket adott meg. 400 InvalidSqlVulnerabilityAssessmentBaselineInput – Az SQL biztonságirés-felmérés alapkonfigurációjának bemenete null értékű vagy üres. 400 InvalidSqlVulnerabilityAssessmentSettingsInput – Az SQL biztonságirés-felmérési beállítás bemenete null értékű vagy üres 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet – Az SQL sebezhetőségi felmérésének eredményei még nem érhetők el, próbálkozzon újra később. 400 SqlVulnerabilityAssessmentInvalidRuleId – Az SQL sebezhetőségi felmérési szabály azonosítója érvénytelen. 400 SqlVulnerabilityAssessmentScanDoesNotExist – Az SQL sebezhetőségi felmérésének vizsgálata nem létezik. 400 SqlVulnerabilityAssessmentNoBaseline – Nem található alapterv az erőforrás legújabb vizsgálatához 400 SqlVulnerabilityAssessmentNoRuleBaseline – Nem található SQL biztonságirés-felmérési alapkonfiguráció 400 SqlVulnerabilityAssessmentBaselineNoScanResults – Nem található vizsgálati eredmény a szabályazonosítóhoz. Alapkonfiguráció beállításához ennek a szabálynak eredményeket kell kapnia a legújabb elérhető vizsgálatban 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat – A bináris szabály bemenete nem logikai ábrázolás 400 SqlVulnerabilityAssessmentBadRuleFormat – A megadott eredmények nem felelnek meg a vizsgálati eredmények tényleges elrendezésének 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat – A megadott eredmények nem felelnek meg a vizsgálati eredmények tényleges elrendezésének 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat – A bináris szabály bemenete nem logikai ábrázolás 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId – Nem található vizsgálati eredmény az egyik szabályhoz. Alapkonfiguráció beállításához ennek a szabálynak eredményeket kell kapnia a legújabb elérhető vizsgálatban 400 SqlVulnerabilityAssessmentEmptyBaseline – Az alapterv nincs beállítva, mert az eredmények null értékűek vagy üresek 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 SourceDatabaseNotFound – A forrásadatbázis nem létezik. 404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – Az SQL sebezhetőségi felmérésének vizsgálata már folyamatban van 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled – A sebezhetőségi felmérés engedélyezve van ezen a kiszolgálón vagy annak egyik mögöttes adatbázisán, amely nem kompatibilis verzióval rendelkezik. További hibaelhárítási információk találhatók https://aka.ms/SQLVAStoragelessDocumentation. 500 DatabaseIsUnavailable – A betöltés nem sikerült. Próbálkozzon újra később.

Name

Típus

Description

200 OK

SQLVulnerabilityAssessmentScanListResult

Sikerült lekérni az SQL-sebezhetőségi felmérés vizsgálati eredményeit.

Other Status Codes

ErrorResponse

Hibaválaszok: ***

400 SqlVulnerabilityAssessmentIsDisabled – Az SQL sebezhetőségi felmérési funkciója le van tiltva. engedélyezze a funkciót, mielőtt más SQL biztonságirés-felmérési műveleteket hajt végre.
400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter – Az ügyfél érvénytelen paraméterértéket adott meg.
400 InvalidSqlVulnerabilityAssessmentBaselineInput – Az SQL biztonságirés-felmérés alapkonfigurációjának bemenete null értékű vagy üres.
400 InvalidSqlVulnerabilityAssessmentSettingsInput – Az SQL biztonságirés-felmérési beállítás bemenete null értékű vagy üres
400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet – Az SQL sebezhetőségi felmérésének eredményei még nem érhetők el, próbálkozzon újra később.
400 SqlVulnerabilityAssessmentInvalidRuleId – Az SQL sebezhetőségi felmérési szabály azonosítója érvénytelen.
400 SqlVulnerabilityAssessmentScanDoesNotExist – Az SQL sebezhetőségi felmérésének vizsgálata nem létezik.
400 SqlVulnerabilityAssessmentNoBaseline – Nem található alapterv az erőforrás legújabb vizsgálatához
400 SqlVulnerabilityAssessmentNoRuleBaseline – Nem található SQL biztonságirés-felmérési alapkonfiguráció
400 SqlVulnerabilityAssessmentBaselineNoScanResults – Nem található vizsgálati eredmény a szabályazonosítóhoz. Alapkonfiguráció beállításához ennek a szabálynak eredményeket kell kapnia a legújabb elérhető vizsgálatban
400 SqlVulnerabilityAssessmentBadBinaryRuleFormat – A bináris szabály bemenete nem logikai ábrázolás
400 SqlVulnerabilityAssessmentBadRuleFormat – A megadott eredmények nem felelnek meg a vizsgálati eredmények tényleges elrendezésének
400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat – A megadott eredmények nem felelnek meg a vizsgálati eredmények tényleges elrendezésének
400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat – A bináris szabály bemenete nem logikai ábrázolás
400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId – Nem található vizsgálati eredmény az egyik szabályhoz. Alapkonfiguráció beállításához ennek a szabálynak eredményeket kell kapnia a legújabb elérhető vizsgálatban
400 SqlVulnerabilityAssessmentEmptyBaseline – Az alapterv nincs beállítva, mert az eredmények null értékűek vagy üresek
404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található
404 SourceDatabaseNotFound – A forrásadatbázis nem létezik.
404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon.
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – Az SQL sebezhetőségi felmérésének vizsgálata már folyamatban van
409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled – A sebezhetőségi felmérés engedélyezve van ezen a kiszolgálón vagy annak egyik mögöttes adatbázisán, amely nem kompatibilis verzióval rendelkezik. További hibaelhárítási információk találhatók https://aka.ms/SQLVAStoragelessDocumentation.
500 DatabaseIsUnavailable – A betöltés nem sikerült. Próbálkozzon újra később.

Példák

List system database SQL Vulnerability Assessment scan results for scan id

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/testsvr/sqlVulnerabilityAssessments/default/scans/scanId1/scanResults?systemDatabaseName=master&api-version=2023-08-01-preview

Sample Response

Status code:: 200

{
  "value": [
    {
      "properties": {
        "ruleId": "VA1234",
        "status": "NonFinding",
        "errorMessage": null,
        "isTrimmed": false,
        "queryResults": [
          [
            "a1",
            "a2",
            "a3"
          ],
          [
            "b1",
            "b2",
            "b3"
          ]
        ],
        "remediation": {
          "description": "Remove users",
          "scripts": [
            "drop user a",
            "drop user b"
          ],
          "automated": false,
          "portalLink": null
        },
        "baselineAdjustedResult": null,
        "ruleMetadata": {
          "ruleId": "VA1234",
          "severity": "Informational",
          "category": "information",
          "ruleType": "NegativeList",
          "title": "This is the title",
          "description": "This is an example check",
          "rationale": "This is important",
          "queryCheck": {
            "query": "Select a1,a2, a3",
            "expectedResult": [],
            "columnNames": [
              "col1",
              "col2",
              "col3"
            ]
          },
          "benchmarkReferences": [
            {
              "benchmark": "fedramp",
              "reference": "v1"
            }
          ]
        }
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/testsvr/sqlVulnerabilityAssessments/Default/scans/scanId1/scanResults/VA1234",
      "name": "VA1234",
      "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments/scans/scanResults"
    },
    {
      "properties": {
        "ruleId": "VA2341",
        "status": "NonFinding",
        "errorMessage": null,
        "isTrimmed": false,
        "queryResults": [
          [
            "a1",
            "a2",
            "a3"
          ],
          [
            "b1",
            "b2",
            "b3"
          ]
        ],
        "remediation": {
          "description": "Remove users",
          "scripts": [
            "drop user a",
            "drop user b"
          ],
          "automated": false,
          "portalLink": null
        },
        "baselineAdjustedResult": null,
        "ruleMetadata": {
          "ruleId": "VA1234",
          "severity": "Informational",
          "category": "information",
          "ruleType": "NegativeList",
          "title": "This is the title",
          "description": "This is an example check",
          "rationale": "This is important",
          "queryCheck": {
            "query": "Select a1,a2, a3",
            "expectedResult": [],
            "columnNames": [
              "col1",
              "col2",
              "col3"
            ]
          },
          "benchmarkReferences": [
            {
              "benchmark": "fedramp",
              "reference": "v1"
            }
          ]
        }
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/testsvr/sqlVulnerabilityAssessments/Default/scans/scanId1/scanResults/VA2341",
      "name": "VA2341",
      "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments/scans/scanResults"
    }
  ]
}

Definíciók

Name	Description
Baseline	Az SQL sebezhetőségi felmérés alapkonfigurációja – részletek
BaselineAdjustedResult	Az SQL Sebezhetőségi felmérés alapkonfigurációja által korrigált eredmények
BenchmarkReference	AZ SQL sebezhetőségi felmérésének referenciaanyaga
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
QueryCheck	SQL Biztonságirés-felmérés lekérdezés-ellenőrző objektum.
Remediation	Az SQL sebezhetőségi felmérésének szervizelési részletei.
RuleSeverity	Sql-sebezhetőségi felmérési szabály súlyossága.
RuleStatus	AZ SQL sebezhetőségi felmérés alapállapota
RuleType	SQL-sebezhetőségi felmérési szabály típusa.
SqlVulnerabilityAssessmentName	Az SQL biztonságirés-felmérés neve.
SQLVulnerabilityAssessmentScanListResult	A sebezhetőségi felmérés vizsgálati eredményeinek listája.
SqlVulnerabilityAssessmentScanResults
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
VaRule	Az SQL sebezhetőségi felmérési szabály metaadatai.
VulnerabilityAssessmentSystemDatabaseName	Az SQL sebezhetőségi felmérési rendszer adatbázisának neve.

Baseline

Az SQL sebezhetőségi felmérés alapkonfigurációja – részletek

Name	Típus	Description
expectedResults	string[]	Az SQL-sebezhetőségi felmérés alapkonfigurációja várt eredményei
updatedTime	string	AZ SQL biztonságirés-felmérés alapkonfiguráció frissítési ideje (UTC)

BaselineAdjustedResult

Az SQL Sebezhetőségi felmérés alapkonfigurációja által korrigált eredmények

Name	Típus	Description
baseline	Baseline	Az SQL sebezhetőségi felmérés alapkonfigurációinak részletei
resultsNotInBaseline	string[]	Az SQL sebezhetőségi felmérésének eredményei, amelyek nem szerepelnek az alapkonfigurációban
resultsOnlyInBaseline	string[]	Az SQL sebezhetőségi felmérésének alapkonfigurációban szereplő eredményei.
status	RuleStatus	AZ SQL sebezhetőségi felmérés alapállapota

BenchmarkReference

AZ SQL sebezhetőségi felmérésének referenciaanyaga

Name	Típus	Description
benchmark	string	SQL-sebezhetőségi felmérési teljesítményteszt neve
reference	string	SQL-sebezhetőségi felmérési teljesítményteszt referenciája.

createdByType

Az erőforrást létrehozó identitás típusa.

Name	Típus	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további adattípus.

ErrorDetail

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célja.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

QueryCheck

SQL Biztonságirés-felmérés lekérdezés-ellenőrző objektum.

Name	Típus	Description
columnNames	string[]	Az SQL Biztonságirés-felmérés oszlopneve a várt lekérdezési eredményhez.
expectedResult	string[]	Az SQL-sebezhetőségi felmérés lekérdezésének várt eredménye.
query	string	SQL Sebezhetőségi felmérési szabály lekérdezése.

Remediation

Az SQL sebezhetőségi felmérésének szervizelési részletei.

Name	Típus	Description
automated	boolean	Az SQL sebezhetőségi felmérése automatikusan szervizelhető.
description	string	SQL-sebezhetőségi felmérés szervizelésének leírása.
portalLink	string	Az SQL-sebezhetőségi felmérés nem kötelező hivatkozása az Azure Portalon történő szervizeléshez.
scripts	string[]	SQL-sebezhetőségi felmérés szervizelési szkriptje.

RuleSeverity

Sql-sebezhetőségi felmérési szabály súlyossága.

Name	Típus	Description
High	string
Informational	string
Low	string
Medium	string
Obsolete	string

RuleStatus

AZ SQL sebezhetőségi felmérés alapállapota

Name	Típus	Description
Finding	string
InternalError	string
NonFinding	string

RuleType

SQL-sebezhetőségi felmérési szabály típusa.

Name	Típus	Description
BaselineExpected	string
Binary	string
NegativeList	string
PositiveList	string

SqlVulnerabilityAssessmentName

Az SQL biztonságirés-felmérés neve.

Name	Típus	Description
default	string

SQLVulnerabilityAssessmentScanListResult

A sebezhetőségi felmérés vizsgálati eredményeinek listája.

Name	Típus	Description
nextLink	string	Hivatkozás az eredmények következő oldalának lekéréséhez.
value	SqlVulnerabilityAssessmentScanResults[]	Eredmények tömbje.

SqlVulnerabilityAssessmentScanResults

Name	Típus	Description
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.baselineAdjustedResult	BaselineAdjustedResult	Az SQL sebezhetőségi felmérési szabályának eredménye az alapkonfigurációhoz igazodik.
properties.errorMessage	string	SQL Sebezhetőségi felmérés hibaüzenet.
properties.isTrimmed	boolean	Az SQL Sebezhetőségi felmérés a lekérdezési eredmények levágva.
properties.queryResults	string[]	A futtatott SQL-sebezhetőségi felmérés lekérdezési eredményei.
properties.remediation	Remediation	AZ SQL sebezhetőségi felmérése a szervizelési részletek.
properties.ruleId	string	SQL biztonságirés-felmérési szabály azonosítója.
properties.ruleMetadata	VaRule	SQL-sebezhetőségi felmérési szabály metaadatai.
properties.status	RuleStatus	Sql-sebezhetőségi felmérési szabály eredményállapota.
systemData	systemData	SystemData of AdvancedThreatProtectionResource.
type	string	Erőforrástípus.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást utoljára módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

VaRule

Az SQL sebezhetőségi felmérési szabály metaadatai.

Name	Típus	Description
benchmarkReferences	BenchmarkReference[]	SQL-sebezhetőségi felmérési teljesítményteszt referenciái.
category	string	SQL Biztonságirés-felmérési szabálykategória.
description	string	SQL-sebezhetőségi felmérési szabály leírása.
queryCheck	QueryCheck	Az SQL sebezhetőségi felmérési szabály lekérdezésének részletei.
rationale	string	Sql-sebezhetőségi felmérési szabály indoklása.
ruleId	string	SQL biztonságirés-felmérési szabály azonosítója.
ruleType	RuleType	SQL-sebezhetőségi felmérési szabály típusa.
severity	RuleSeverity	Sql-sebezhetőségi felmérési szabály súlyossága.
title	string	SQL-sebezhetőségi felmérési szabály címe.

VulnerabilityAssessmentSystemDatabaseName

Az SQL sebezhetőségi felmérési rendszer adatbázisának neve.

Name	Típus	Description
master	string

Megosztás a következőn keresztül:

Sql Vulnerability Assessment Scan Result - List By Scan

URI-paraméterek

Válaszok

Példák

List system database SQL Vulnerability Assessment scan results for scan id

Sample Request

Sample Response

Definíciók

Baseline

BaselineAdjustedResult

BenchmarkReference

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

QueryCheck

Remediation

RuleSeverity

RuleStatus

RuleType

SqlVulnerabilityAssessmentName

SQLVulnerabilityAssessmentScanListResult

SqlVulnerabilityAssessmentScanResults

systemData

VaRule

VulnerabilityAssessmentSystemDatabaseName

További források