Server Vulnerability Assessments - List By Server

Enumera 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-05-01-preview

Parámetros de identificador URI

Name In Required Type 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

Name Type Description
200 OK

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 de la cuenta de almacenamiento proporcionada o la clave de almacenamiento de la cuenta no es válida.

  • 400 VulnerabilityAssessmentUnsupportedStorageAccount: la cuenta de almacenamiento proporcionada no es compatible.

  • 400 VulnerabilityAssessmentADSIsDisabled: Advanced Data Security debe habilitarse para poder 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

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

Sample Response

{
  "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

ServerVulnerabilityAssessment

Una evaluación de vulnerabilidades del servidor.

ServerVulnerabilityAssessmentListResult

Una lista de las evaluaciones de vulnerabilidades del servidor.

VulnerabilityAssessmentRecurringScansProperties

Propiedades de exámenes periódicos de evaluación de vulnerabilidades.

ServerVulnerabilityAssessment

Una evaluación de vulnerabilidades del servidor.

Name Type Description
id
  • string

Identificador del recurso.

name
  • string

Nombre del recurso.

properties.recurringScans

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

Una lista de las evaluaciones de vulnerabilidades del servidor.

Name Type Description
nextLink
  • string

Vínculo para recuperar la página siguiente de resultados.

value

Matriz de resultados.

VulnerabilityAssessmentRecurringScansProperties

Propiedades de exámenes periódicos de evaluación de vulnerabilidades.

Name Type Default Value 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.