Sql Vulnerability Assessment Scans - Get

Service:

SQL Database

Version d'API:

2024-05-01-preview

Obtenir un enregistrement d’analyse d’évaluation des vulnérabilités de base de données système.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
scanId	path	True	string
serverName	path	True	string	Nom du serveur.
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	Nom de l’évaluation des vulnérabilités.
api-version	query	True	string	Version de l’API à utiliser pour la requête.
systemDatabaseName	query	True	VulnerabilityAssessmentSystemDatabaseName	Nom de la base de données du système d’évaluation des vulnérabilités.

Réponses

Nom	Type	Description
200 OK	SqlVulnerabilityAssessmentScanRecord	Récupération réussie de l’enregistrement d’analyse de l’évaluation des vulnérabilités de la base de données.
Other Status Codes	ErrorResponse	Réponses d’erreur : *** 400 SqlVulnerabilityAssessmentIsDisabled : la fonctionnalité d’évaluation des vulnérabilités SQL est désactivée. activez la fonctionnalité avant d’exécuter d’autres opérations d’évaluation des vulnérabilités SQL. 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : une valeur de paramètre non valide a été fournie par le client. 400 InvalidSqlVulnerabilityAssessmentBaselineInput : l’entrée de base de référence de l’évaluation des vulnérabilités SQL est null ou vide. 400 InvalidSqlVulnerabilityAssessmentSettingsInput : l’entrée du paramètre d’évaluation des vulnérabilités SQL est null ou vide 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - Les résultats de l’évaluation des vulnérabilités SQL ne sont pas encore disponibles, réessayez ultérieurement. 400 SqlVulnerabilityAssessmentInvalidRuleId : l’ID de règle d’évaluation des vulnérabilités SQL n’est pas valide. 400 SqlVulnerabilityAssessmentScanDoesNotExist - L’analyse de l’évaluation des vulnérabilités SQL n’existe pas. 400 SqlVulnerabilityAssessmentNoBaseline - Aucune ligne de base n’a été trouvée pour la dernière analyse dans la ressource 400 SqlVulnerabilityAssessmentNoRuleBaseline - Aucune base de référence d’évaluation des vulnérabilités SQL n’a été trouvée 400 SqlVulnerabilityAssessmentBaselineNoScanResults : aucun résultat d’analyse n’a été trouvé pour l’ID de règle. Pour définir une ligne de base, il doit y avoir des résultats pour cette règle dans la dernière analyse disponible 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - L’entrée pour la règle binaire n’est pas une représentation booléenne 400 SqlVulnerabilityAssessmentBadRuleFormat : les résultats fournis ne sont pas conformes à la disposition réelle des résultats de l’analyse 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat : les résultats fournis ne sont pas conformes à la disposition réelle des résultats de l’analyse 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - L’entrée de la règle binaire n’est pas une représentation booléenne 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId : aucun résultat d’analyse n’a été trouvé pour l’une des règles. Pour définir une ligne de base, il doit y avoir des résultats pour cette règle dans la dernière analyse disponible 400 SqlVulnerabilityAssessmentEmptyBaseline - Ligne de base non définie, car les résultats sont null ou vides 404 SubscriptionDoesNotHaveServer - Le serveur demandé est introuvable 404 SourceDatabaseNotFound : la base de données source n’existe pas. 404 DatabaseDoesNotExist : l’utilisateur a spécifié un nom de base de données qui n’existe pas sur cette instance de serveur. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - L’analyse de l’évaluation des vulnérabilités SQL est déjà en cours 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled : l’évaluation des vulnérabilités est activée sur ce serveur ou l’une de ses bases de données sous-jacentes avec une version incompatible. Vous trouverez des informations de dépannage supplémentaires https://aka.ms/SQLVAStoragelessDocumentation. 500 DatabaseIsUnavailable - Échec du chargement. Réessayez plus tard.

Exemples

Gets the a database vulnerability assessment scan records

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/sqlVulnerabilityAssessments/default/scans/scan001",
  "name": "scan001",
  "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments/scans",
  "properties": {
    "scanId": "scan001",
    "triggerType": "Recurring",
    "state": "Failed",
    "server": "vulnerabilityassessmenttest-6411",
    "database": "master",
    "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"
  }
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
SqlVulnerabilityAssessmentScanError	Propriétés d’une erreur d’analyse d’évaluation des vulnérabilités.
SqlVulnerabilityAssessmentScanRecord	Enregistrement d’analyse de l’évaluation des vulnérabilités.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
VulnerabilityAssessmentName	Nom de l’évaluation des vulnérabilités.
VulnerabilityAssessmentScanState	État de l’analyse.
VulnerabilityAssessmentScanTriggerType	Type de déclencheur d’analyse.
VulnerabilityAssessmentSystemDatabaseName	Nom de la base de données du système d’évaluation des vulnérabilités.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

SqlVulnerabilityAssessmentScanError

Object

Propriétés d’une erreur d’analyse d’évaluation des vulnérabilités.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur.

SqlVulnerabilityAssessmentScanRecord

Object

Enregistrement d’analyse de l’évaluation des vulnérabilités.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.database	string	Nom de la base de données.
properties.endTime	string (date-time)	Heure de fin de l’analyse (UTC).
properties.errors	SqlVulnerabilityAssessmentScanError[]	Erreurs d’analyse.
properties.highSeverityFailedRulesCount	integer (int32)	Nombre de règles ayant échoué avec une gravité élevée.
properties.isBaselineApplied	boolean	La base de référence créée pour cette base de données et a une ou plusieurs règles.
properties.lastScanTime	string (date-time)	Heure de la dernière analyse.
properties.lowSeverityFailedRulesCount	integer (int32)	Nombre de règles ayant échoué avec une gravité faible.
properties.mediumSeverityFailedRulesCount	integer (int32)	Nombre de règles ayant échoué avec une gravité moyenne.
properties.scanId	string	ID d’analyse.
properties.server	string	Nom du serveur.
properties.sqlVersion	string	Version SQL.
properties.startTime	string (date-time)	Heure de début de l’analyse (UTC).
properties.state	VulnerabilityAssessmentScanState	État de l’analyse.
properties.totalFailedRulesCount	integer (int32)	Nombre total de règles ayant échoué.
properties.totalPassedRulesCount	integer (int32)	Nombre total de règles passées.
properties.totalRulesCount	integer (int32)	Nombre total de règles évaluées.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Type de déclencheur d’analyse.
systemData	systemData	SystemData de SqlVulnerabilityAssessmentScanRecordResource.
type	string	Type de ressource.

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

VulnerabilityAssessmentName

Énumération

Nom de l’évaluation des vulnérabilités.

Valeur	Description
default

VulnerabilityAssessmentScanState

Énumération

État de l’analyse.

Valeur	Description
Failed
FailedToRun
InProgress
Passed

VulnerabilityAssessmentScanTriggerType

Énumération

Type de déclencheur d’analyse.

Valeur	Description
OnDemand
Recurring

VulnerabilityAssessmentSystemDatabaseName

Énumération

Nom de la base de données du système d’évaluation des vulnérabilités.

Valeur	Description
master