Managed Database Vulnerability Assessment Scans - List By Database

Référence

Service:: SQL Database

Version d'API:: 2021-11-01

Listes les analyses d’évaluation des vulnérabilités d’une base de données.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/vulnerabilityAssessments/default/scans?api-version=2021-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données.
managedInstanceName	path	True	string	Nom de l'instance managée.
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.
subscriptionId	path	True	string	L’ID d’abonnement d’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.

Réponses

Nom	Type	Description
200 OK	VulnerabilityAssessmentScanRecordListResult	Récupération réussie des enregistrements d’analyse de l’évaluation des vulnérabilités de la base de données.
Other Status Codes		Réponses d’erreur : *** 400 InvalidStorageAccountName : le compte de stockage fourni n’est pas valide ou n’existe pas. 400 InvalidStorageAccountCredentials : la signature d’accès partagé ou la clé de stockage du compte de stockage fournie n’est pas valide. 400 VulnerabilityAssessmentInvalidPolicy : les paramètres d’évaluation des vulnérabilités n’existent pas ou le stockage non valide spécifié dans les paramètres. 400 VulnerabilityAssessmentADSIsDisabled : Advanced Data Security doit être activé pour utiliser l’évaluation des vulnérabilités. 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath : le chemin du conteneur de stockage doit être fourni s’il n’est pas défini dans la stratégie au niveau du serveur 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated : impossible d’exécuter l’opération d’évaluation des vulnérabilités, car la base de données est suspendue. Veuillez la reprendre. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed : le compte de stockage ne figure pas dans la liste des règles de pare-feu sortantes. 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 ce serveur instance. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress : l’analyse de l’évaluation des vulnérabilités est déjà en cours. 500 DatabaseIsUnavailable - Échec du chargement. Veuillez réessayer plus tard.

Nom

Type

Description

200 OK

VulnerabilityAssessmentScanRecordListResult

Récupération réussie des enregistrements d’analyse de l’évaluation des vulnérabilités de la base de données.

Other Status Codes

Réponses d’erreur : ***

400 InvalidStorageAccountName : le compte de stockage fourni n’est pas valide ou n’existe pas.
400 InvalidStorageAccountCredentials : la signature d’accès partagé ou la clé de stockage du compte de stockage fournie n’est pas valide.
400 VulnerabilityAssessmentInvalidPolicy : les paramètres d’évaluation des vulnérabilités n’existent pas ou le stockage non valide spécifié dans les paramètres.
400 VulnerabilityAssessmentADSIsDisabled : Advanced Data Security doit être activé pour utiliser l’évaluation des vulnérabilités.
400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath : le chemin du conteneur de stockage doit être fourni s’il n’est pas défini dans la stratégie au niveau du serveur
400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated : impossible d’exécuter l’opération d’évaluation des vulnérabilités, car la base de données est suspendue. Veuillez la reprendre.
400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed : le compte de stockage ne figure pas dans la liste des règles de pare-feu sortantes.
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 ce serveur instance.
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress : l’analyse de l’évaluation des vulnérabilités est déjà en cours.
500 DatabaseIsUnavailable - Échec du chargement. Veuillez réessayer plus tard.

Exemples

Gets the list of a database vulnerability assessment scan records

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6411/databases/testdb/vulnerabilityAssessments/default/scans?api-version=2021-11-01


import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;

/**
 * Samples for ManagedDatabaseVulnerabilityAssessmentScans ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseVulnerabilityAssessmentScanRecordsListByDatabase.json
     */
    /**
     * Sample code: Gets the list of a database vulnerability assessment scan records.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheListOfADatabaseVulnerabilityAssessmentScanRecords(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseVulnerabilityAssessmentScans().listByDatabase(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, com.azure.core.util.Context.NONE);
    }
}

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

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan001",
      "name": "scan001",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan001",
        "triggerType": "OnDemand",
        "state": "Passed",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 9
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan002",
      "name": "scan002",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan002",
        "triggerType": "Recurring",
        "state": "Failed",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 9
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan003",
      "name": "scan003",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan003",
        "triggerType": "Recurring",
        "state": "FailedToRun",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [
          {
            "code": "StorageNotFound",
            "message": "Storage not found"
          }
        ],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 0
      }
    }
  ]
}

Définitions

Nom	Description
VulnerabilityAssessmentName	Nom de l’évaluation des vulnérabilités.
VulnerabilityAssessmentScanError	Propriétés d’une erreur d’analyse d’évaluation des vulnérabilités.
VulnerabilityAssessmentScanRecord	Un enregistrement d’analyse d’évaluation des vulnérabilités.
VulnerabilityAssessmentScanRecordListResult	Liste des enregistrements d’analyse de l’évaluation des vulnérabilités.
VulnerabilityAssessmentScanState	Analyse status.
VulnerabilityAssessmentScanTriggerType	Type de déclencheur d’analyse.

VulnerabilityAssessmentName

Enumeration

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

Valeur	Description
default

VulnerabilityAssessmentScanError

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.

VulnerabilityAssessmentScanRecord

Object

Un enregistrement d’analyse d’évaluation des vulnérabilités.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.endTime	string	Heure de fin de l’analyse (UTC).
properties.errors	VulnerabilityAssessmentScanError[]	Erreurs d’analyse.
properties.numberOfFailedSecurityChecks	integer	Nombre de vérifications de sécurité ayant échoué.
properties.scanId	string	ID d’analyse.
properties.startTime	string	Heure de début de l’analyse (UTC).
properties.state	VulnerabilityAssessmentScanState	Analyse status.
properties.storageContainerPath	string	Chemin du conteneur de stockage des résultats de l’analyse.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Type de déclencheur d’analyse.
type	string	Type de ressource.

VulnerabilityAssessmentScanRecordListResult

Object

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

Nom	Type	Description
nextLink	string	Lien pour récupérer la page de résultats suivante.
value	VulnerabilityAssessmentScanRecord[]	Tableau de résultats.

VulnerabilityAssessmentScanState

Enumeration

Analyse status.

Valeur	Description
Failed
FailedToRun
InProgress
Passed

VulnerabilityAssessmentScanTriggerType

Enumeration

Type de déclencheur d’analyse.

Valeur	Description
OnDemand
Recurring

Partager via

Managed Database Vulnerability Assessment Scans - List By Database

Paramètres URI

Réponses

Exemples

Gets the list of a database vulnerability assessment scan records

Exemple de requête

Exemple de réponse

Définitions

VulnerabilityAssessmentName

VulnerabilityAssessmentScanError

VulnerabilityAssessmentScanRecord

VulnerabilityAssessmentScanRecordListResult

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

Ressources supplémentaires