Database Vulnerability Assessment Rule Baselines - Create Or Update

Dienst:

SQL Database

API-Version:

2021-11-01

Erstellt oder aktualisiert die Baseline für die Sicherheitsrisikobewertungsregel einer Datenbank.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
baselineName	path	True	VulnerabilityAssessmentPolicyBaselineName	Der Name der Baseline der Regel für die Sicherheitsrisikobewertung (Standard impliziert eine Baseline auf einer Regel auf Datenbankebene und master für Regel auf Serverebene).
databaseName	path	True	string	Der Name der Datenbank, für die die Baseline für die Sicherheitsrisikobewertungsregel definiert ist.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
ruleId	path	True	string	Die ID der Regel für die Sicherheitsrisikobewertung.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	Der Name der Sicherheitsrisikobewertung.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.baselineResults	True	DatabaseVulnerabilityAssessmentRuleBaselineItem[]	Das Ergebnis der Regelbaseline

Antworten

Name	Typ	Beschreibung
200 OK	DatabaseVulnerabilityAssessmentRuleBaseline	Die Baseline für die Regel zur Sicherheitsrisikobewertung wurde erfolgreich festgelegt.
Other Status Codes		Fehlerantworten: *** 400 VulnerabilityAssessmentStorageAuthenticationFailed: Beim Speicherkonto "{0}" konnte keine Authentifizierung durchgeführt werden. 400 VulnerabilityAssessmentInvalidPolicy: Einstellungen für die Sicherheitsrisikobewertung sind nicht vorhanden oder ungültiger Speicher, der in den Einstellungen angegeben ist. 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated: Der Vorgang zur Sicherheitsrisikobewertung konnte nicht ausgeführt werden, da die Datenbank angehalten ist. Bitte setzen Sie ihn fort. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed: Das Speicherkonto ist nicht in der Liste der Firewallregeln für ausgehenden Datenverkehr enthalten. 400 InvalidVulnerabilityAssessmentOperationRequest: Die Anforderung für den Vorgang zur Sicherheitsrisikobewertung ist nicht vorhanden oder weist kein Eigenschaftenobjekt auf. 400 DataSecurityInvalidUserSuppliedParameter: Vom Client wurde ein ungültiger Parameterwert bereitgestellt. 404 VulnerabilityAssessmentInvalidStorageAccount: Das in der Richtlinie definierte Speicherkonto "{0}" ist ungültig. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden. 404 SourceDatabaseNotFound: Die Quelldatenbank ist nicht vorhanden. 404 DatabaseDoesNotExist: Der Benutzer hat einen Datenbanknamen angegeben, der auf diesem Server instance nicht vorhanden ist. 404 VulnerabilityAssessmentRuleDoesNotExists : Regel "{0}" ist nicht vorhanden. 404 VulnerabilityAssessmentBaselineDoesNotExists – Baseline ist für Regel "{0}" nicht vorhanden 500 DatabaseIsUnavailable: Fehler beim Laden. Versuchen Sie es später noch mal.

Beispiele

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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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"
        ]
      }
    ]
  }
}

Definitionen

Name	Beschreibung
DatabaseVulnerabilityAssessmentRuleBaseline	Baseline einer Datenbank-Sicherheitsrisikobewertungsregel.
DatabaseVulnerabilityAssessmentRuleBaselineItem	Eigenschaften für das Ergebnis einer Azure SQL Datenbank-Sicherheitsrisikobewertungsregelbaseline.
VulnerabilityAssessmentName	Der Name der Sicherheitsrisikobewertung.
VulnerabilityAssessmentPolicyBaselineName	Der Name der Baseline der Regel für die Sicherheitsrisikobewertung (Standard impliziert eine Baseline auf einer Regel auf Datenbankebene und master für Regel auf Serverebene).

DatabaseVulnerabilityAssessmentRuleBaseline

Baseline einer Datenbank-Sicherheitsrisikobewertungsregel.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.baselineResults	DatabaseVulnerabilityAssessmentRuleBaselineItem[]	Das Ergebnis der Regelbaseline
type	string	Der Ressourcentyp.

DatabaseVulnerabilityAssessmentRuleBaselineItem

Eigenschaften für das Ergebnis einer Azure SQL Datenbank-Sicherheitsrisikobewertungsregelbaseline.

Name	Typ	Beschreibung
result	string[]	Das Ergebnis der Regelbaseline

VulnerabilityAssessmentName

Der Name der Sicherheitsrisikobewertung.

Name	Typ	Beschreibung
default	string

VulnerabilityAssessmentPolicyBaselineName

Der Name der Baseline der Regel für die Sicherheitsrisikobewertung (Standard impliziert eine Baseline auf einer Regel auf Datenbankebene und master für Regel auf Serverebene).

Name	Typ	Beschreibung
default	string
master	string