Managed Instance Vulnerability Assessments - List By Instance

Servicio:

SQL Database

Versión de la API:

2021-11-01

Obtiene las directivas de evaluación de vulnerabilidades de la instancia administrada.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
managedInstanceName	path	True	string	Nombre de la instancia administrada para la que se definen las evaluaciones 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.
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	ManagedInstanceVulnerabilityAssessmentListResult	Recuperó correctamente las directivas de evaluación de vulnerabilidades de la instancia administrada.
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 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 managed instance's vulnerability assessment policies

Solicitud de ejemplo

HTTP

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

Java

/**
 * Samples for ManagedInstanceVulnerabilityAssessments ListByInstance.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceVulnerabilityAssessmentListByInstance.json
     */
    /**
     * Sample code: Get a managed instance's vulnerability assessment policies.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAManagedInstanceSVulnerabilityAssessmentPolicies(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceVulnerabilityAssessments().listByInstance(
            "vulnerabilityaseessmenttest-4799", "vulnerabilityaseessmenttest-6440", com.azure.core.util.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

Respuesta de muestra

status code:

200

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

Definiciones

Nombre	Description
ManagedInstanceVulnerabilityAssessment	Una evaluación de vulnerabilidades de instancia administrada.
ManagedInstanceVulnerabilityAssessmentListResult	Una lista de las evaluaciones de vulnerabilidades de ManagedInstance.
VulnerabilityAssessmentRecurringScansProperties	Propiedades de exámenes periódicos de evaluación de vulnerabilidades.

ManagedInstanceVulnerabilityAssessment

Object

Una evaluación de vulnerabilidades de instancia administrada.

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/).
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.

ManagedInstanceVulnerabilityAssessmentListResult

Object

Una lista de las evaluaciones de vulnerabilidades de ManagedInstance.

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

VulnerabilityAssessmentRecurringScansProperties

Object

Propiedades de exámenes periódicos 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.