Sql Vulnerability Assessment Scan Result - Get

Referencia

Service:: SQL Database

API Version:: 2023-08-01-preview

Lekéri egy adatbázis sebezhetőségi felmérési rekordját.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/sqlVulnerabilityAssessments/default/scans/{scanId}/scanResults/{scanResultId}?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.
scanResultId	path	True	string	A lekérni kívánt eredmény vizsgálati eredményazonosítója.
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	SqlVulnerabilityAssessmentScanResults	Sikeresen lekérte az SQL-sebezhetőség-felmérés azonosítóra vonatkozó 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 biztonságirés-felmérési vizsgálata nem létezik. 400 SqlVulnerabilityAssessmentNoBaseline – Nem található alapkonfiguráció az erőforrás legújabb vizsgálatához 400 SqlVulnerabilityAssessmentNoRuleBaseline – Nem található SQL-sebezhetőségi felmérési alapkonfiguráció 400 SqlVulnerabilityAssessmentBaselineNoScanResults – Nem találhatók vizsgálati eredmények a szabályazonosítóhoz. Alapkonfiguráció beállításához ennek a szabálynak eredményeket kell adni 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ók vizsgálati eredmények az egyik szabályhoz. Alapkonfiguráció beállításához ennek a szabálynak eredményeket kell adni 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

SqlVulnerabilityAssessmentScanResults

Sikeresen lekérte az SQL-sebezhetőség-felmérés azonosítóra vonatkozó 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 biztonságirés-felmérési vizsgálata nem létezik.
400 SqlVulnerabilityAssessmentNoBaseline – Nem található alapkonfiguráció az erőforrás legújabb vizsgálatához
400 SqlVulnerabilityAssessmentNoRuleBaseline – Nem található SQL-sebezhetőségi felmérési alapkonfiguráció
400 SqlVulnerabilityAssessmentBaselineNoScanResults – Nem találhatók vizsgálati eredmények a szabályazonosítóhoz. Alapkonfiguráció beállításához ennek a szabálynak eredményeket kell adni 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ók vizsgálati eredmények az egyik szabályhoz. Alapkonfiguráció beállításához ennek a szabálynak eredményeket kell adni 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

Get a system database SQL Vulnerability Assessment scan result for scan id and scan result id

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "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/vulnerabilityassessmenttest-6411/sqlVulnerabilityAssessments/Default/scans/scanId1/scanResults/VA1234",
  "name": "VA1234",
  "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments/scans/scanResults"
}

Definíciók

Name	Description
Baseline	Az SQL-sebezhetőségi felmérés alapkonfigurációinak részletei
BaselineAdjustedResult	Az SQL Sebezhetőségi felmérés alapkonfigurációja által korrigált eredmények
BenchmarkReference	SQL-sebezhetőségi felmérési teljesítményteszt referenciája
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	AZ SQL Sebezhetőségi felmérés lekérdezés-ellenőrző objektuma.
Remediation	AZ SQL-sebezhetőségi felmérés szervizelési részletei.
RuleSeverity	Az 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.
SqlVulnerabilityAssessmentScanResults
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
VaRule	Az SQL Biztonságirés-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óinak részletei

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 Sebezhetőségi 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 nincsenek 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

SQL-sebezhetőségi felmérési teljesítményteszt referenciája

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 információtí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 hibacél.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

QueryCheck

AZ SQL Sebezhetőségi felmérés lekérdezés-ellenőrző objektuma.

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

Remediation

AZ SQL-sebezhetőségi felmérés szervizelési részletei.

Name	Típus	Description
automated	boolean	Az SQL sebezhetőségi felmérése automatikusan szervizelhető.
description	string	Az SQL Sebezhetőségi felmérés szervizelésének leírása.
portalLink	string	Az SQL Biztonságirés-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

Az 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

SqlVulnerabilityAssessmentScanResults

Name	Típus	Description
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.baselineAdjustedResult	BaselineAdjustedResult	Az SQL Biztonságirés-felmérési szabály eredménye az alapkonfigurációval van módosítva.
properties.errorMessage	string	AZ SQL Sebezhetőségi felmérése hibaüzenet.
properties.isTrimmed	boolean	Az SQL Biztonságirés-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 adatokról.
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	Az SQL-sebezhetőségi felmérési szabály eredményének á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 az identitás, amely legutóbb módosította az erőforrást.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

VaRule

Az SQL Biztonságirés-felmérési szabály metaadatai.

Name	Típus	Description
benchmarkReferences	BenchmarkReference[]	SQL-sebezhetőségi felmérési referenciareferenciák.
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	Az 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	Az SQL Sebezhetőségi felmérési szabály súlyossága.
title	string	AZ SQL Biztonságirés-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 - Get

URI-paraméterek

Válaszok

Példák

Get a system database SQL Vulnerability Assessment scan result for scan id and scan result id

Sample Request

Sample Response

Definíciók

Baseline

BaselineAdjustedResult

BenchmarkReference

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

QueryCheck

Remediation

RuleSeverity

RuleStatus

RuleType

SqlVulnerabilityAssessmentName

SqlVulnerabilityAssessmentScanResults

systemData

VaRule

VulnerabilityAssessmentSystemDatabaseName

További források