Compartir a través de

Managed Database Vulnerability Assessment Scans - Get

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

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/managedInstances/{managedInstanceName}/databases/{databaseName}/vulnerabilityAssessments/default/scans/{scanId}?api-version=2021-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
databaseName
 path True

string

El nombre de la base de datos.
managedInstanceName
 path True

string

El nombre de la instancia administrada.
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.
subscriptionId
 path True

string

El id. de suscripción que identifica una suscripción de Azure.
vulnerabilityAssessmentName
 path True

VulnerabilityAssessmentName

Nombre de la evaluación de vulnerabilidades.
api-version
 query True

string

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

Respuestas

Nombre Tipo Description
200 OK

VulnerabilityAssessmentScanRecord

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

Gets a database vulnerability assessment scan record by scan ID

Solicitud de ejemplo

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

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/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

Nombre Description
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.

Nombre Tipo Description
default

string

VulnerabilityAssessmentScanError

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

Nombre Tipo Description
code

string

Código de error.
message

string

El mensaje de error.

VulnerabilityAssessmentScanRecord

Un registro de examen de evaluación de vulnerabilidades.

Nombre Tipo Description
id

string

Identificador del recurso.
name

string

Nombre del recurso.
properties.endTime

string

Hora de finalización del examen (UTC).
properties.errors

VulnerabilityAssessmentScanError[]

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

VulnerabilityAssessmentScanState

Estado del examen.
properties.storageContainerPath

string

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

VulnerabilityAssessmentScanTriggerType

Tipo de desencadenador de examen.
type

string

Tipo de recurso.

VulnerabilityAssessmentScanState

Estado del examen.

Nombre Tipo Description
Failed

string

FailedToRun

string

InProgress

string

Passed

string

VulnerabilityAssessmentScanTriggerType

Tipo de desencadenador de examen.

Nombre Tipo Description
OnDemand

string

Recurring

string