Database Sql Vulnerability Assessment Rule Baselines - Create Or Update

Referentie

Service:: SQL Database

API-versie:: 2024-05-01-preview

Hiermee maakt of werkt u de basislijn voor evaluatie van beveiligingsproblemen van een database bij.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/sqlVulnerabilityAssessments/default/baselines/default/rules/{ruleId}?api-version=2024-05-01-preview

URI-parameters

Name	In	Vereist	Type	Description
baselineName	path	True	BaselineName
databaseName	path	True	string	De naam van de database.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
ruleId	path	True	string	De id van de evaluatieregel voor beveiligingsproblemen.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	De naam van de evaluatie van beveiligingsproblemen.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Vereist	Type	Description
properties.latestScan	True	boolean	De meest recente scanvlag
properties.results	True	string[]	Het resultaat van de regelbasislijn

Antwoorden

Name	Type	Description
200 OK	DatabaseSqlVulnerabilityAssessmentRuleBaseline	Stel de basislijn voor de evaluatie van beveiligingsproblemen in.
Other Status Codes	ErrorResponse	Foutreacties: *** 400 SqlVulnerabilityAssessmentIsDisabled : de evaluatiefunctie voor SQL-beveiligingsproblemen is uitgeschakeld. Schakel de functie in voordat u andere SQL-evaluatiebewerkingen voor beveiligingsproblemen uitvoert. 400 InvalidSqlVulnerabilityAssessmentBaselineInput: de basislijninvoer voor evaluatie van SQL-beveiligingsproblemen is null of leeg. 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : er is een ongeldige parameterwaarde opgegeven door de client. 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : er is een ongeldige parameterwaarde opgegeven door de client. 400 InvalidSqlVulnerabilityAssessmentBaselineInput: de basislijninvoer voor evaluatie van SQL-beveiligingsproblemen is null of leeg. 400 InvalidSqlVulnerabilityAssessmentSettingsInput : de invoer van de instelling sql-beveiligingsproblemen is null of leeg 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - Evaluatieresultaten van SQL-beveiligingsproblemen zijn nog niet beschikbaar. Probeer het later opnieuw. 400 SqlVulnerabilityAssessmentInvalidRuleId : de id van de sql-beveiligingsevaluatieregel is ongeldig. 400 SqlVulnerabilityAssessmentScanDoesNotExist - Scan voor evaluatie van SQL-beveiligingsproblemen bestaat niet. 400 SqlVulnerabilityAssessmentNoBaseline - Er is geen basislijn gevonden voor de meest recente scan in de resource 400 SqlVulnerabilityAssessmentNoRuleBaseline - Er is geen basislijn voor evaluatie van SQL-beveiligingsproblemen gevonden 400 SqlVulnerabilityAssessmentBaselineNoScanResults - Er zijn geen scanresultaten gevonden voor regel-id. Als u een basislijn wilt instellen, moeten er resultaten zijn voor deze regel in de meest recente scan beschikbaar 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - Invoer voor binaire regel is geen booleaanse weergave 400 SqlVulnerabilityAssessmentBadRuleFormat - De opgegeven resultaten voldoen niet aan de werkelijke indeling van de scanresultaten 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat - De opgegeven resultaten voldoen niet aan de werkelijke indeling van de scanresultaten 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - Invoer voor binaire regel is geen booleaanse weergave 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId - Er zijn geen scanresultaten gevonden voor een van de regels. Als u een basislijn wilt instellen, moeten er resultaten zijn voor deze regel in de meest recente scan beschikbaar 400 SqlVulnerabilityAssessmentEmptyBaseline - Basislijn niet ingesteld omdat de resultaten null of leeg zijn 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 SourceDatabaseNotFound - De brondatabase bestaat niet. 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - Scan voor evaluatie van SQL-beveiligingsproblemen wordt al uitgevoerd 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - Evaluatie van beveiligingsproblemen is ingeschakeld op deze server of een van de onderliggende databases met een incompatibele versie. Aanvullende informatie over probleemoplossing vindt u https://aka.ms/SQLVAStoragelessDocumentation. 500 DatabaseIsUnavailable - Laden is mislukt. Probeer het later opnieuw.

Name

Type

Description

200 OK

DatabaseSqlVulnerabilityAssessmentRuleBaseline

Stel de basislijn voor de evaluatie van beveiligingsproblemen in.

Other Status Codes

ErrorResponse

Foutreacties: ***

400 SqlVulnerabilityAssessmentIsDisabled : de evaluatiefunctie voor SQL-beveiligingsproblemen is uitgeschakeld. Schakel de functie in voordat u andere SQL-evaluatiebewerkingen voor beveiligingsproblemen uitvoert.
400 InvalidSqlVulnerabilityAssessmentBaselineInput: de basislijninvoer voor evaluatie van SQL-beveiligingsproblemen is null of leeg.
400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : er is een ongeldige parameterwaarde opgegeven door de client.
400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : er is een ongeldige parameterwaarde opgegeven door de client.
400 InvalidSqlVulnerabilityAssessmentBaselineInput: de basislijninvoer voor evaluatie van SQL-beveiligingsproblemen is null of leeg.
400 InvalidSqlVulnerabilityAssessmentSettingsInput : de invoer van de instelling sql-beveiligingsproblemen is null of leeg
400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - Evaluatieresultaten van SQL-beveiligingsproblemen zijn nog niet beschikbaar. Probeer het later opnieuw.
400 SqlVulnerabilityAssessmentInvalidRuleId : de id van de sql-beveiligingsevaluatieregel is ongeldig.
400 SqlVulnerabilityAssessmentScanDoesNotExist - Scan voor evaluatie van SQL-beveiligingsproblemen bestaat niet.
400 SqlVulnerabilityAssessmentNoBaseline - Er is geen basislijn gevonden voor de meest recente scan in de resource
400 SqlVulnerabilityAssessmentNoRuleBaseline - Er is geen basislijn voor evaluatie van SQL-beveiligingsproblemen gevonden
400 SqlVulnerabilityAssessmentBaselineNoScanResults - Er zijn geen scanresultaten gevonden voor regel-id. Als u een basislijn wilt instellen, moeten er resultaten zijn voor deze regel in de meest recente scan beschikbaar
400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - Invoer voor binaire regel is geen booleaanse weergave
400 SqlVulnerabilityAssessmentBadRuleFormat - De opgegeven resultaten voldoen niet aan de werkelijke indeling van de scanresultaten
400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat - De opgegeven resultaten voldoen niet aan de werkelijke indeling van de scanresultaten
400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - Invoer voor binaire regel is geen booleaanse weergave
400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId - Er zijn geen scanresultaten gevonden voor een van de regels. Als u een basislijn wilt instellen, moeten er resultaten zijn voor deze regel in de meest recente scan beschikbaar
400 SqlVulnerabilityAssessmentEmptyBaseline - Basislijn niet ingesteld omdat de resultaten null of leeg zijn
404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 SourceDatabaseNotFound - De brondatabase bestaat niet.
404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren.
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - Scan voor evaluatie van SQL-beveiligingsproblemen wordt al uitgevoerd
409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - Evaluatie van beveiligingsproblemen is ingeschakeld op deze server of een van de onderliggende databases met een incompatibele versie. Aanvullende informatie over probleemoplossing vindt u https://aka.ms/SQLVAStoragelessDocumentation.
500 DatabaseIsUnavailable - Laden is mislukt. Probeer het later opnieuw.

Voorbeelden

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

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

{
  "properties": {
    "latestScan": false,
    "results": [
      [
        "userA",
        "SELECT"
      ],
      [
        "userB",
        "SELECT"
      ],
      [
        "userC",
        "SELECT"
      ]
    ]
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python database_sql_vulnerability_assessment_rule_baseline_create.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-1111-2222-3333-444444444444",
    )

    response = client.database_sql_vulnerability_assessment_rule_baselines.create_or_update(
        resource_group_name="vulnerabilityaseessmenttest-4799",
        server_name="vulnerabilityaseessmenttest-6440",
        database_name="testdb",
        vulnerability_assessment_name="default",
        baseline_name="default",
        rule_id="VA1001",
        parameters={
            "properties": {
                "latestScan": False,
                "results": [["userA", "SELECT"], ["userB", "SELECT"], ["userC", "SELECT"]],
            }
        },
    )
    print(response)


# x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2024-05-01-preview/examples/DatabaseSqlVulnerabilityAssessmentRuleBaselineCreate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:: 200

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

Definities

Name	Description
BaselineName
createdByType	Het type identiteit waarmee de resource is gemaakt.
DatabaseSqlVulnerabilityAssessmentRuleBaseline	Een basislijn voor evaluatie van sql-beveiligingsproblemen.
DatabaseSqlVulnerabilityAssessmentRuleBaselineInput	Basislijninvoer voor evaluatie van sql-beveiligingsproblemen in een database.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
VulnerabilityAssessmentName	De naam van de evaluatie van beveiligingsproblemen.

BaselineName

Inventarisatie

Waarde	Description
default

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
Application
Key
ManagedIdentity
User

DatabaseSqlVulnerabilityAssessmentRuleBaseline

Object

Een basislijn voor evaluatie van sql-beveiligingsproblemen.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.results	string[]	Het resultaat van de regelbasislijn
systemData	systemData	SystemData van DatabaseSqlVulnerabilityAssessmentRuleBaselineResource.
type	string	Resourcetype.

DatabaseSqlVulnerabilityAssessmentRuleBaselineInput

Object

Basislijninvoer voor evaluatie van sql-beveiligingsproblemen in een database.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.latestScan	boolean	De meest recente scanvlag
properties.results	string[]	Het resultaat van de regelbasislijn
systemData	systemData	SystemData of DatabaseSqlVulnerabilityAssessmentRuleBaselineInputResource.
type	string	Resourcetype.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

VulnerabilityAssessmentName

Inventarisatie

De naam van de evaluatie van beveiligingsproblemen.

Waarde	Description
default

Delen via

Database Sql Vulnerability Assessment Rule Baselines - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

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

Voorbeeldaanvraag

Voorbeeldrespons

Definities

BaselineName

createdByType

DatabaseSqlVulnerabilityAssessmentRuleBaseline

DatabaseSqlVulnerabilityAssessmentRuleBaselineInput

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

systemData

VulnerabilityAssessmentName

Aanvullende resources