Server Vulnerability Assessments - List By Server

Service:

SQL Database

API Version:

2021-11-01

Listas las directivas de evaluación de vulnerabilidades asociadas a un servidor.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName	path	True	string	El nombre del servidor.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	ServerVulnerabilityAssessmentListResult	Recuperó correctamente las directivas de evaluación de vulnerabilidades del servidor.
Other Status Codes		Respuestas de error: *** 400 InvalidStorageAccountName: la cuenta de almacenamiento proporcionada no es válida o no existe. 400 InvalidStorageAccountCredentials: la firma de acceso compartido o la clave de almacenamiento de la cuenta de almacenamiento proporcionada no son válidas. 400 VulnerabilityAssessmentUnsupportedStorageAccount: la cuenta de almacenamiento proporcionada no es compatible. 400 VulnerabilityAssessmentADSIsDisabled: Advanced Data Security debe estar habilitado para usar la evaluación de vulnerabilidades. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed: la cuenta de almacenamiento no está en la lista de reglas de firewall de salida. 400 VulnerabilityAssessmentInsufficientStorageAccountPermissions: permisos insuficientes en la cuenta de almacenamiento proporcionada. 400 VulnerabilityAssessmentStorageAccountIsDisabled: la cuenta de almacenamiento proporcionada está deshabilitada. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado

Ejemplos

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"
          ]
        }
      }
    }
  ]
}

Definiciones

Nombre	Description
ServerVulnerabilityAssessment	Una evaluación de vulnerabilidades del servidor.
ServerVulnerabilityAssessmentListResult	Lista de las evaluaciones de vulnerabilidades del servidor.
VulnerabilityAssessmentRecurringScansProperties	Propiedades de un examen periódico de evaluación de vulnerabilidades.

ServerVulnerabilityAssessment

Una evaluación de vulnerabilidades del servidor.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.recurringScans	VulnerabilityAssessmentRecurringScansProperties	La configuración de exámenes periódicos
properties.storageAccountAccessKey	string	Especifica la clave de identificador de la cuenta de almacenamiento para los resultados del examen de evaluación de vulnerabilidades. Si no se especifica "StorageContainerSasKey", se requiere storageAccountAccessKey. Solo se aplica si la cuenta de almacenamiento no está detrás de una red virtual o un firewall.
properties.storageContainerPath	string	Ruta de acceso del contenedor de Blob Storage para contener los resultados del examen (por ejemplo, https://myStorage.blob.core.windows.net/VaScans/).
properties.storageContainerSasKey	string	Firma de acceso compartido (clave SAS) que tiene acceso de escritura al contenedor de blobs especificado en el parámetro "storageContainerPath". Si no se especifica "storageAccountAccessKey", se requiere StorageContainerSasKey. Solo se aplica si la cuenta de almacenamiento no está detrás de una red virtual o un firewall.
type	string	Tipo de recurso.

ServerVulnerabilityAssessmentListResult

Lista de las evaluaciones de vulnerabilidades del servidor.

Nombre	Tipo	Description
nextLink	string	Vínculo para recuperar la página siguiente de resultados.
value	ServerVulnerabilityAssessment[]	Matriz de resultados.

VulnerabilityAssessmentRecurringScansProperties

Propiedades de un examen periódico de evaluación de vulnerabilidades.

Nombre	Tipo	Valor predeterminado	Description
emailSubscriptionAdmins	boolean	True	Especifica que la notificación de examen de programación se enviará a los administradores de la suscripción.
emails	string[]		Especifica una matriz de direcciones de correo electrónico a las que se envía la notificación de examen.
isEnabled	boolean		Estado de exámenes periódicos.