Database Vulnerability Assessment Scans - Get

Obtiene un registro de examen de evaluación de vulnerabilidades de una base de datos.

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

Parámetros de identificador URI

Name In Required Type Description
databaseName
path True
  • string

El nombre de la base de datos.

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.

scanId
path True
  • string

Identificador de examen de evaluación de vulnerabilidades del examen que se va a recuperar.

serverName
path True
  • string

El nombre del servidor.

subscriptionId
path True
  • string

El id. de suscripción que identifica una suscripción de Azure.

vulnerabilityAssessmentName
path True

Nombre de la evaluación de vulnerabilidades.

api-version
query True
  • string

La versión de API que se usará para la solicitud.

Respuestas

Name Type Description
200 OK

Recuperó correctamente el registro de examen 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 Storage ruta de acceso del contenedor 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. Inténtelo de nuevo más tarde.

Ejemplos

Gets a database vulnerability assessment scan record by scan ID

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/vulnerabilityAssessments/default/scans/scan001?api-version=2021-05-01-preview

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan001",
  "name": "scan001",
  "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
  "properties": {
    "scanId": "scan001",
    "triggerType": "OnDemand",
    "state": "Passed",
    "startTime": "2017-12-12T17:45:06Z",
    "endTime": "2017-12-12T17:47:06Z",
    "errors": [],
    "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
    "numberOfFailedSecurityChecks": 9
  }
}

Definiciones

VulnerabilityAssessmentName

Nombre de la evaluación de vulnerabilidades.

VulnerabilityAssessmentScanError

Propiedades de un error de examen de evaluación de vulnerabilidades.

VulnerabilityAssessmentScanRecord

Un registro de examen de evaluación de vulnerabilidades.

VulnerabilityAssessmentScanState

Estado del examen.

VulnerabilityAssessmentScanTriggerType

Tipo de desencadenador de examen.

VulnerabilityAssessmentName

Nombre de la evaluación de vulnerabilidades.

Name Type Description
default
  • string

VulnerabilityAssessmentScanError

Propiedades de un error de examen de evaluación de vulnerabilidades.

Name Type Description
code
  • string

Código de error.

message
  • string

El mensaje de error.

VulnerabilityAssessmentScanRecord

Un registro de examen de evaluación de vulnerabilidades.

Name Type Description
id
  • string

Identificador del recurso.

name
  • string

Nombre del recurso.

properties.endTime
  • string

Hora de finalización del examen (UTC).

properties.errors

Errores de examen.

properties.numberOfFailedSecurityChecks
  • integer

Número de comprobaciones de seguridad con errores.

properties.scanId
  • string

Identificador de examen.

properties.startTime
  • string

Hora de inicio del examen (UTC).

properties.state

Estado del examen.

properties.storageContainerPath
  • string

La ruta de acceso del contenedor de almacenamiento da como resultado el examen.

properties.triggerType

Tipo de desencadenador de examen.

type
  • string

Tipo de recurso.

VulnerabilityAssessmentScanState

Estado del examen.

Name Type Description
Failed
  • string
FailedToRun
  • string
InProgress
  • string
Passed
  • string

VulnerabilityAssessmentScanTriggerType

Tipo de desencadenador de examen.

Name Type Description
OnDemand
  • string
Recurring
  • string