Database Sql Vulnerability Assessment Scans - Get

Tjänst:

SQL Database

API-version:

2023-08-01

Hämta resultatet av en databasgenomsökning för sårbarhetsbedömning.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
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.
scanId	path	True	string	Genomsöknings-ID för sårbarhetsbedömning för genomsökningen som ska hämtas.
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.

Svar

Name	Typ	Description
200 OK	SqlVulnerabilityAssessmentScanRecord	Databasens genomsökning av sårbarhetsbedömning har hämtats.
Other Status Codes	ErrorResponse	Felsvar: *** 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ömningsinställningen ä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ö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 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen. 404 SourceDatabaseNotFound – källdatabasen finns inte. 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

Get a database's vulnerability assessment scan.

Exempelbegäran

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/sqlVulnerabilityAssessments/default/scans/scan001?api-version=2023-08-01

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/DatabaseSqlVulnerabilityAssessmentScan.json
// this example is just showing the usage of "DatabaseSqlVulnerabilityAssessmentScans_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseSqlVulnerabilityAssessmentScanResource created on azure
// for more information of creating SqlDatabaseSqlVulnerabilityAssessmentScanResource, please refer to the document of SqlDatabaseSqlVulnerabilityAssessmentScanResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "vulnerabilityassessmenttest-4711";
string serverName = "vulnerabilityassessmenttest-6411";
string databaseName = "testdb";
VulnerabilityAssessmentName vulnerabilityAssessmentName = VulnerabilityAssessmentName.Default;
string scanId = "scan001";
ResourceIdentifier sqlDatabaseSqlVulnerabilityAssessmentScanResourceId = SqlDatabaseSqlVulnerabilityAssessmentScanResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, vulnerabilityAssessmentName, scanId);
SqlDatabaseSqlVulnerabilityAssessmentScanResource sqlDatabaseSqlVulnerabilityAssessmentScan = client.GetSqlDatabaseSqlVulnerabilityAssessmentScanResource(sqlDatabaseSqlVulnerabilityAssessmentScanResourceId);

// invoke the operation
SqlDatabaseSqlVulnerabilityAssessmentScanResource result = await sqlDatabaseSqlVulnerabilityAssessmentScan.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlVulnerabilityAssessmentScanData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exempelsvar

Statuskod:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/sqlVulnerabilityAssessments/default/scans/scan001",
  "name": "scan001",
  "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments/scans",
  "properties": {
    "scanId": "scan001",
    "triggerType": "Recurring",
    "state": "Failed",
    "server": "vulnerabilityassessmenttest-6411",
    "database": "testdb",
    "sqlVersion": "15.0.2000",
    "startTime": "2020-06-23T12:19:00.6455136+05:30",
    "endTime": "2020-06-23T06:49:00.7236217Z",
    "highSeverityFailedRulesCount": 3,
    "mediumSeverityFailedRulesCount": 2,
    "lowSeverityFailedRulesCount": 1,
    "totalPassedRulesCount": 20,
    "totalFailedRulesCount": 6,
    "totalRulesCount": 26,
    "isBaselineApplied": false,
    "lastScanTime": "2020-06-23T12:19:00.6455136+05:30"
  }
}

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
SqlVulnerabilityAssessmentScanError	Egenskaper för ett sårbarhetsbedömningsgenomsökningsfel.
SqlVulnerabilityAssessmentScanRecord	En genomsökningspost för sårbarhetsbedömning.
systemData	Metadata som rör skapande och senaste ändring av resursen.
VulnerabilityAssessmentName	Namnet på sårbarhetsbedömningen.
VulnerabilityAssessmentScanState	Genomsökningsstatus.
VulnerabilityAssessmentScanTriggerType	Typ av genomsökningsutlösare.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

SqlVulnerabilityAssessmentScanError

Objekt

Egenskaper för ett sårbarhetsbedömningsgenomsökningsfel.

Name	Typ	Description
code	string	Felkoden.
message	string	Felmeddelandet.

SqlVulnerabilityAssessmentScanRecord

Objekt

En genomsökningspost för sårbarhetsbedömning.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.database	string	Databasnamnet.
properties.endTime	string (date-time)	Genomsökningens sluttid (UTC).
properties.errors	SqlVulnerabilityAssessmentScanError[]	Genomsökningsfelen.
properties.highSeverityFailedRulesCount	integer (int32)	Antalet misslyckade regler med hög allvarlighetsgrad.
properties.isBaselineApplied	boolean	Baslinje som skapats för den här databasen och har en eller flera regler.
properties.lastScanTime	string (date-time)	Senaste genomsökningstid.
properties.lowSeverityFailedRulesCount	integer (int32)	Antalet misslyckade regler med låg allvarlighetsgrad.
properties.mediumSeverityFailedRulesCount	integer (int32)	Antalet misslyckade regler med medelhög allvarlighetsgrad.
properties.scanId	string	Genomsöknings-ID:t.
properties.server	string	Servernamnet.
properties.sqlVersion	string	SQL-versionen.
properties.startTime	string (date-time)	Genomsökningens starttid (UTC).
properties.state	VulnerabilityAssessmentScanState	Genomsökningsstatus.
properties.totalFailedRulesCount	integer (int32)	Antalet totalt misslyckade regler.
properties.totalPassedRulesCount	integer (int32)	Antalet regler som har godkänts totalt.
properties.totalRulesCount	integer (int32)	Antalet bedömda totala regler.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Typ av genomsökningsutlösare.
systemData	systemData	SystemData för SqlVulnerabilityAssessmentScanRecordResource.
type	string	Resurstyp.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	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

Uppräkning

Namnet på sårbarhetsbedömningen.

Värde	Description
default

VulnerabilityAssessmentScanState

Uppräkning

Genomsökningsstatus.

Värde	Description
Passed
Failed
FailedToRun
InProgress

VulnerabilityAssessmentScanTriggerType

Uppräkning

Typ av genomsökningsutlösare.

Värde	Description
OnDemand
Recurring