Database Vulnerability Assessment Rule Baselines - Create Or Update

Servicio:

SQL Database

Versión de la API:

2021-11-01

Crea o actualiza la base de referencia de la regla de evaluación de vulnerabilidades de una base de datos.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
baselineName	path	True	VulnerabilityAssessmentPolicyBaselineName	El nombre de la línea de base de la regla de evaluación de vulnerabilidades (el valor predeterminado implica una línea base en una regla de nivel de base de datos y un patrón para la regla de nivel de servidor).
databaseName	path	True	string	Nombre de la base de datos para la que se define la línea base de la regla 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.
ruleId	path	True	string	Identificador de la regla de evaluación de vulnerabilidades.
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	VulnerabilityAssessmentName	Nombre de la evaluación de vulnerabilidades.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.baselineResults	True	DatabaseVulnerabilityAssessmentRuleBaselineItem[]	Resultado de la línea base de la regla

Respuestas

Nombre	Tipo	Description
200 OK	DatabaseVulnerabilityAssessmentRuleBaseline	Establezca correctamente la línea base de la regla de evaluación de vulnerabilidades.
Other Status Codes		Respuestas de error: *** 400 VulnerabilityAssessmentStorageAuthenticationFailed: no se pudo autenticar en la cuenta de almacenamiento "{0}". 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 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. 400 InvalidVulnerabilityAssessmentOperationRequest: la solicitud de operación de evaluación de vulnerabilidades no existe o no tiene ningún objeto de propiedades. 400 DataSecurityInvalidUserSuppliedParameter: el cliente proporcionó un valor de parámetro no válido. 404 VulnerabilityAssessmentInvalidStorageAccount: la cuenta de almacenamiento "{0}" definida en la directiva no es válida. 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. 404 VulnerabilityAssessmentRuleDoesNotExists: la regla '{0}' no existe. 404 VulnerabilityAssessmentBaselineDoesNotExists: la línea de base no existe para la regla '{0}' 500 DatabaseIsUnavailable: error al cargar. Vuelva a intentarlo más tarde.

Ejemplos

Creates or updates a database's vulnerability assessment rule baseline.

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "baselineResults": [
      {
        "result": [
          "userA",
          "SELECT"
        ]
      },
      {
        "result": [
          "userB",
          "SELECT"
        ]
      },
      {
        "result": [
          "userC",
          "SELECT",
          "tableId_4"
        ]
      }
    ]
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.DatabaseVulnerabilityAssessmentRuleBaselineInner;
import com.azure.resourcemanager.sql.models.DatabaseVulnerabilityAssessmentRuleBaselineItem;
import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;
import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentPolicyBaselineName;
import java.util.Arrays;

/**
 * Samples for DatabaseVulnerabilityAssessmentRuleBaselines CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * DatabaseVulnerabilityAssessmentRuleBaselineCreate.json
     */
    /**
     * Sample code: Creates or updates a database's vulnerability assessment rule baseline.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsOrUpdatesADatabaseSVulnerabilityAssessmentRuleBaseline(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseVulnerabilityAssessmentRuleBaselines()
            .createOrUpdateWithResponse("vulnerabilityaseessmenttest-4799", "vulnerabilityaseessmenttest-6440",
                "testdb", VulnerabilityAssessmentName.DEFAULT, "VA1001",
                VulnerabilityAssessmentPolicyBaselineName.DEFAULT,
                new DatabaseVulnerabilityAssessmentRuleBaselineInner().withBaselineResults(Arrays.asList(
                    new DatabaseVulnerabilityAssessmentRuleBaselineItem().withResult(Arrays.asList("userA", "SELECT")),
                    new DatabaseVulnerabilityAssessmentRuleBaselineItem().withResult(Arrays.asList("userB", "SELECT")),
                    new DatabaseVulnerabilityAssessmentRuleBaselineItem()
                        .withResult(Arrays.asList("userC", "SELECT", "tableId_4")))),
                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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/rules/VA1001/baselines/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/rules/baselines",
  "properties": {
    "baselineResults": [
      {
        "result": [
          "userA",
          "SELECT"
        ]
      },
      {
        "result": [
          "userB",
          "SELECT"
        ]
      },
      {
        "result": [
          "userC",
          "SELECT",
          "tableId_4"
        ]
      }
    ]
  }
}

Definiciones

Nombre	Description
DatabaseVulnerabilityAssessmentRuleBaseline	Línea base de la regla de evaluación de vulnerabilidades de la base de datos.
DatabaseVulnerabilityAssessmentRuleBaselineItem	Propiedades de una base de referencia de la regla de evaluación de vulnerabilidades de base de datos de Azure SQL.
VulnerabilityAssessmentName	Nombre de la evaluación de vulnerabilidades.
VulnerabilityAssessmentPolicyBaselineName	El nombre de la línea de base de la regla de evaluación de vulnerabilidades (el valor predeterminado implica una línea base en una regla de nivel de base de datos y un patrón para la regla de nivel de servidor).

DatabaseVulnerabilityAssessmentRuleBaseline

Object

Línea base de la regla de evaluación de vulnerabilidades de la base de datos.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.baselineResults	DatabaseVulnerabilityAssessmentRuleBaselineItem[]	Resultado de la línea base de la regla
type	string	Tipo de recurso.

DatabaseVulnerabilityAssessmentRuleBaselineItem

Object

Propiedades de una base de referencia de la regla de evaluación de vulnerabilidades de base de datos de Azure SQL.

Nombre	Tipo	Description
result	string[]	Resultado de la línea base de la regla

VulnerabilityAssessmentName

Enumeration

Nombre de la evaluación de vulnerabilidades.

Valor	Description
default

VulnerabilityAssessmentPolicyBaselineName

Enumeration

El nombre de la línea de base de la regla de evaluación de vulnerabilidades (el valor predeterminado implica una línea base en una regla de nivel de base de datos y un patrón para la regla de nivel de servidor).

Valor	Description
default
master