Managed Database Vulnerability Assessment Scans - List By Database

Referencia

Service:: SQL Database

API Version:: 2021-11-01

Listas los exámenes 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?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.
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	VulnerabilityAssessmentScanRecordListResult	Recuperó correctamente los registros 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 de la cuenta de almacenamiento proporcionada o la clave de almacenamiento de la cuenta no es válida. 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 habilitarse para poder usar la evaluación de vulnerabilidades. 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath: se debe proporcionar la ruta de acceso del contenedor de storage 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.

Nombre

Tipo

Description

200 OK

VulnerabilityAssessmentScanRecordListResult

Recuperó correctamente los registros 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 de la cuenta de almacenamiento proporcionada o la clave de almacenamiento de la cuenta no es válida.
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 habilitarse para poder usar la evaluación de vulnerabilidades.
400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath: se debe proporcionar la ruta de acceso del contenedor de storage 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 the list of a database vulnerability assessment scan records

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?api-version=2021-11-01


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;

/** Samples for ManagedDatabaseVulnerabilityAssessmentScans ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseVulnerabilityAssessmentScanRecordsListByDatabase.json
     */
    /**
     * Sample code: Gets the list of a database vulnerability assessment scan records.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheListOfADatabaseVulnerabilityAssessmentScanRecords(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseVulnerabilityAssessmentScans().listByDatabase(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, 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/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
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan002",
      "name": "scan002",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan002",
        "triggerType": "Recurring",
        "state": "Failed",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 9
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan003",
      "name": "scan003",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan003",
        "triggerType": "Recurring",
        "state": "FailedToRun",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [
          {
            "code": "StorageNotFound",
            "message": "Storage not found"
          }
        ],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 0
      }
    }
  ]
}

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.
VulnerabilityAssessmentScanRecordListResult	Lista de registros 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	La hora de inicio del examen (UTC).
properties.state	VulnerabilityAssessmentScanState	Estado del examen.
properties.storageContainerPath	string	Ruta de acceso del contenedor de almacenamiento de resultados del examen.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Tipo de desencadenador de examen.
type	string	Tipo de recurso.

VulnerabilityAssessmentScanRecordListResult

Lista de registros de examen de evaluación de vulnerabilidades.

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

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

Managed Database Vulnerability Assessment Scans - List By Database

Parámetros de identificador URI

Respuestas

Ejemplos

Gets the list of a database vulnerability assessment scan records

Sample Request

Sample Response

Definiciones

VulnerabilityAssessmentName

VulnerabilityAssessmentScanError

VulnerabilityAssessmentScanRecord

VulnerabilityAssessmentScanRecordListResult

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

Recursos adicionales