Managed Instance Vulnerability Assessments - List By Instance

Service:

SQL Database

Version d'API:

2021-11-01

Obtient les stratégies d’évaluation des vulnérabilités du instance managé.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
managedInstanceName	path	True	string	Nom du instance managé pour lequel les évaluations des vulnérabilités sont définies.
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.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Réponses

Nom	Type	Description
200 OK	ManagedInstanceVulnerabilityAssessmentListResult	Récupération réussie des stratégies d’évaluation des vulnérabilités instance managé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 VulnerabilityAssessmentADSIsDisabled - Advanced Data Security doit être activé pour pouvoir utiliser l’évaluation des vulnérabilités. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed : le compte de stockage ne figure pas dans la liste des règles de pare-feu sortantes. 400 VulnerabilityAssessmentInsufficientStorageAccountPermissions - Autorisations insuffisantes sur le compte de stockage fourni. 400 VulnerabilityAssessmentStorageAccountIsDisabled : le compte de stockage fourni est désactivé. 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable

Exemples

Get a managed instance's vulnerability assessment policies

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments?api-version=2021-11-01

Java

/**
 * Samples for ManagedInstanceVulnerabilityAssessments ListByInstance.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceVulnerabilityAssessmentListByInstance.json
     */
    /**
     * Sample code: Get a managed instance's vulnerability assessment policies.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAManagedInstanceSVulnerabilityAssessmentPolicies(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceVulnerabilityAssessments().listByInstance(
            "vulnerabilityaseessmenttest-4799", "vulnerabilityaseessmenttest-6440", 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/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default",
      "name": "default",
      "type": "Microsoft.Sql/managedInstances/vulnerabilityAssessments",
      "properties": {
        "recurringScans": {
          "isEnabled": true,
          "emailSubscriptionAdmins": true,
          "emails": [
            "email1@mail.com",
            "email2@mail.com"
          ]
        }
      }
    }
  ]
}

Définitions

Nom	Description
ManagedInstanceVulnerabilityAssessment	Une évaluation des vulnérabilités instance managée.
ManagedInstanceVulnerabilityAssessmentListResult	Liste des évaluations des vulnérabilités de ManagedInstance.
VulnerabilityAssessmentRecurringScansProperties	Propriétés d’une analyse périodique d’évaluation des vulnérabilités.

ManagedInstanceVulnerabilityAssessment

Object

Une évaluation des vulnérabilités instance managée.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.recurringScans	VulnerabilityAssessmentRecurringScansProperties	Paramètres des analyses périodiques
properties.storageAccountAccessKey	string	Spécifie la clé d’identificateur du compte de stockage pour les résultats de l’analyse de l’évaluation des vulnérabilités. Si « StorageContainerSasKey » n’est pas spécifié, storageAccountAccessKey est requis. S’applique uniquement si le compte de stockage n’est pas derrière un réseau virtuel ou un pare-feu
properties.storageContainerPath	string	Chemin d’accès au conteneur de stockage d’objets blob pour contenir les résultats de l’analyse (par exemple https://myStorage.blob.core.windows.net/VaScans/).
properties.storageContainerSasKey	string	Signature d’accès partagé (clé SAS) qui a un accès en écriture au conteneur d’objets blob spécifié dans le paramètre « storageContainerPath ». Si « storageAccountAccessKey » n’est pas spécifié, StorageContainerSasKey est requis. S’applique uniquement si le compte de stockage n’est pas derrière un réseau virtuel ou un pare-feu
type	string	Type de ressource.

ManagedInstanceVulnerabilityAssessmentListResult

Object

Liste des évaluations des vulnérabilités de ManagedInstance.

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

VulnerabilityAssessmentRecurringScansProperties

Object

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

Nom	Type	Valeur par défaut	Description
emailSubscriptionAdmins	boolean	True	Spécifie que la notification d’analyse de planification sera envoyée aux administrateurs de l’abonnement.
emails	string[]		Spécifie un tableau d’adresses de messagerie auxquelles la notification d’analyse est envoyée.
isEnabled	boolean		État des analyses périodiques.