Database Vulnerability Assessments - List By Database

  • Referencia
Servicio:
SQL Database
Versión de la API:
2021-11-01

Listas las directivas de evaluación de vulnerabilidades asociadas a una base de datos.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
databaseName
 path True

string

Nombre de la base de datos para la que se definen las directivas de evaluación de vulnerabilidades.
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

DatabaseVulnerabilityAssessmentListResult

Recuperó correctamente las directivas de evaluación de vulnerabilidades de la base de datos.
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 VulnerabilityAssessmentInvalidPolicy: la configuración de evaluación de vulnerabilidades no existe o el almacenamiento no es válido especificado en la configuración.

  • 400 VulnerabilityAssessmentADSIsDisabled: Advanced Data Security debe estar habilitado para usar la evaluación de vulnerabilidades.

  • 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath: se debe proporcionar la ruta de acceso del contenedor de almacenamiento si no está establecida en la directiva de nivel de servidor.

  • 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated: no se pudo ejecutar la operación de evaluación de vulnerabilidades porque la base de datos está en pausa. Por favor reanudarlo.

  • 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed: la cuenta de almacenamiento no está en la lista de reglas de firewall de salida.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado

  • 404 SourceDatabaseNotFound: la base de datos de origen no existe.

  • 404 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor.

  • 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress: el examen de evaluación de vulnerabilidades ya está en curso.

  • 500 DatabaseIsUnavailable: error al cargar. Vuelva a intentarlo más tarde.

Ejemplos

Get the database's vulnerability assessment policies

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
DatabaseVulnerabilityAssessment

Una evaluación de vulnerabilidades de la base de datos.
DatabaseVulnerabilityAssessmentListResult

Lista de las evaluaciones de vulnerabilidades de la base de datos.
VulnerabilityAssessmentRecurringScansProperties

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

DatabaseVulnerabilityAssessment

Una evaluación de vulnerabilidades de la base de datos.

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/). Se requiere si la directiva de evaluación de vulnerabilidades de nivel de servidor no se establece.
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.

DatabaseVulnerabilityAssessmentListResult

Lista de las evaluaciones de vulnerabilidades de la base de datos.

Nombre Tipo Description
nextLink

string

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

DatabaseVulnerabilityAssessment[]

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.