Server Vulnerability Assessments - List By Server

Service:

SQL Database

API Version:

2021-11-01

Elenchi i criteri di valutazione della vulnerabilità associati a un server.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	ServerVulnerabilityAssessmentListResult	Sono stati recuperati correttamente i criteri di valutazione della vulnerabilità del server.
Other Status Codes		Risposte di errore: 400 InvalidStorageAccountName: l'account di archiviazione specificato non è valido o non esiste. 400 InvalidStorageAccountCredentials: la firma di accesso condiviso o la chiave di archiviazione dell'account di archiviazione fornita non è valida. 400 VulnerabilityAssessmentUnsupportedStorageAccount: l'account di archiviazione fornito non è supportato. 400 VulnerabilityAssessmentADSIsDisabled - Sicurezza dei dati avanzata deve essere abilitata per usare la valutazione della vulnerabilità. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed - L'account di archiviazione non è incluso nell'elenco delle regole del firewall in uscita. 400 VulnerabilityAssessmentInsufficientStorageAccountPermissions- Autorizzazioni insufficienti per l'account di archiviazione specificato. 400 VulnerabilityAssessmentStorageAccountIsDisabled: l'account di archiviazione fornito è disabilitato. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

Esempio

Get a server's vulnerability assessment policies

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for ServerVulnerabilityAssessments ListByServer. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ServerVulnerabilityAssessmentListByServer.json
     */
    /**
     * Sample code: Get a server's vulnerability assessment policies.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAServerSVulnerabilityAssessmentPolicies(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerVulnerabilityAssessments()
            .listByServer("vulnerabilityaseessmenttest-4799", "vulnerabilityaseessmenttest-6440", 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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/",
      "name": "default",
      "type": "Microsoft.Sql/servers/vulnerabilityAssessments",
      "properties": {
        "recurringScans": {
          "isEnabled": true,
          "emailSubscriptionAdmins": true,
          "emails": [
            "email1@mail.com",
            "email2@mail.com"
          ]
        }
      }
    }
  ]
}

Definizioni

Nome	Descrizione
ServerVulnerabilityAssessment	Valutazione della vulnerabilità del server.
ServerVulnerabilityAssessmentListResult	Elenco delle valutazioni delle vulnerabilità del server.
VulnerabilityAssessmentRecurringScansProperties	Proprietà di una valutazione della vulnerabilità analisi ricorrenti.

ServerVulnerabilityAssessment

Valutazione della vulnerabilità del server.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.recurringScans	VulnerabilityAssessmentRecurringScansProperties	Impostazioni di analisi ricorrenti
properties.storageAccountAccessKey	string	Specifica la chiave dell'identificatore dell'account di archiviazione per i risultati dell'analisi della valutazione della vulnerabilità. Se 'StorageContainerSasKey' non è specificato, è necessario storageAccountAccessKey. Si applica solo se l'account di archiviazione non si trova dietro una rete virtuale o un firewall
properties.storageContainerPath	string	Percorso del contenitore di archiviazione BLOB per contenere i risultati dell'analisi ( ad esempio https://myStorage.blob.core.windows.net/VaScans/).
properties.storageContainerSasKey	string	Firma di accesso condiviso (chiave di firma di accesso condiviso) con accesso in scrittura al contenitore BLOB specificato nel parametro 'storageContainerPath'. Se 'storageAccountAccessKey' non è specificato, è necessario StorageContainerSasKey. Si applica solo se l'account di archiviazione non si trova dietro una rete virtuale o un firewall
type	string	Tipo di risorsa.

ServerVulnerabilityAssessmentListResult

Elenco delle valutazioni delle vulnerabilità del server.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	ServerVulnerabilityAssessment[]	Matrice di risultati.

VulnerabilityAssessmentRecurringScansProperties

Proprietà di una valutazione della vulnerabilità analisi ricorrenti.

Nome	Tipo	Valore predefinito	Descrizione
emailSubscriptionAdmins	boolean	True	Specifica che la notifica di analisi della pianificazione verrà inviata agli amministratori della sottoscrizione.
emails	string[]		Specifica una matrice di indirizzi di posta elettronica a cui viene inviata la notifica di analisi.
isEnabled	boolean		Stato delle analisi ricorrenti.