Database Sql Vulnerability Assessment Rule Baselines - Create Or Update

Service:

SQL Database

Version d'API:

2024-05-01-preview

Crée ou met à jour la base de référence des règles d’évaluation des vulnérabilités d’une base de données.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
baselineName	path	True	BaselineName
databaseName	path	True	string	Nom de la base de données.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
ruleId	path	True	string	ID de règle d’évaluation des vulnérabilités.
serverName	path	True	string	Nom du serveur.
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	Nom de l’évaluation des vulnérabilités.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Obligatoire	Type	Description
properties.latestScan	True	boolean	Indicateur d’analyse le plus récent
properties.results	True	string[]	Résultat de la base de référence de la règle

Réponses

Nom	Type	Description
200 OK	DatabaseSqlVulnerabilityAssessmentRuleBaseline	Définissez correctement la base de référence de la règle d’évaluation des vulnérabilités.
Other Status Codes	ErrorResponse	Réponses d’erreur : *** 400 SqlVulnerabilityAssessmentIsDisabled : la fonctionnalité d’évaluation des vulnérabilités SQL est désactivée. activez la fonctionnalité avant d’exécuter d’autres opérations d’évaluation des vulnérabilités SQL. 400 InvalidSqlVulnerabilityAssessmentBaselineInput : l’entrée de base de référence de l’évaluation des vulnérabilités SQL est null ou vide. 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : une valeur de paramètre non valide a été fournie par le client. 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter : une valeur de paramètre non valide a été fournie par le client. 400 InvalidSqlVulnerabilityAssessmentBaselineInput : l’entrée de base de référence de l’évaluation des vulnérabilités SQL est null ou vide. 400 InvalidSqlVulnerabilityAssessmentSettingsInput : l’entrée du paramètre d’évaluation des vulnérabilités SQL est null ou vide 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - Les résultats de l’évaluation des vulnérabilités SQL ne sont pas encore disponibles, réessayez ultérieurement. 400 SqlVulnerabilityAssessmentInvalidRuleId : l’ID de règle d’évaluation des vulnérabilités SQL n’est pas valide. 400 SqlVulnerabilityAssessmentScanDoesNotExist - L’analyse de l’évaluation des vulnérabilités SQL n’existe pas. 400 SqlVulnerabilityAssessmentNoBaseline - Aucune ligne de base n’a été trouvée pour la dernière analyse dans la ressource 400 SqlVulnerabilityAssessmentNoRuleBaseline - Aucune base de référence d’évaluation des vulnérabilités SQL n’a été trouvée 400 SqlVulnerabilityAssessmentBaselineNoScanResults : aucun résultat d’analyse n’a été trouvé pour l’ID de règle. Pour définir une ligne de base, il doit y avoir des résultats pour cette règle dans la dernière analyse disponible 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - L’entrée pour la règle binaire n’est pas une représentation booléenne 400 SqlVulnerabilityAssessmentBadRuleFormat : les résultats fournis ne sont pas conformes à la disposition réelle des résultats de l’analyse 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat : les résultats fournis ne sont pas conformes à la disposition réelle des résultats de l’analyse 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - L’entrée de la règle binaire n’est pas une représentation booléenne 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId : aucun résultat d’analyse n’a été trouvé pour l’une des règles. Pour définir une ligne de base, il doit y avoir des résultats pour cette règle dans la dernière analyse disponible 400 SqlVulnerabilityAssessmentEmptyBaseline - Ligne de base non définie, car les résultats sont null ou vides 404 SubscriptionDoesNotHaveServer - Le serveur demandé est introuvable 404 SourceDatabaseNotFound : la base de données source n’existe pas. 404 DatabaseDoesNotExist : l’utilisateur a spécifié un nom de base de données qui n’existe pas sur cette instance de serveur. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - L’analyse de l’évaluation des vulnérabilités SQL est déjà en cours 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled : l’évaluation des vulnérabilités est activée sur ce serveur ou l’une de ses bases de données sous-jacentes avec une version incompatible. Vous trouverez des informations de dépannage supplémentaires https://aka.ms/SQLVAStoragelessDocumentation. 500 DatabaseIsUnavailable - Échec du chargement. Réessayez plus tard.

Exemples

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

Exemple de requête

HTTP

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

Python

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
BaselineName
createdByType	Type d’identité qui a créé la ressource.
DatabaseSqlVulnerabilityAssessmentRuleBaseline	Base de référence de règle d’évaluation des vulnérabilités sql de base de données.
DatabaseSqlVulnerabilityAssessmentRuleBaselineInput	Entrée de base de référence de la règle d’évaluation des vulnérabilités sql de base de données.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
VulnerabilityAssessmentName	Nom de l’évaluation des vulnérabilités.

BaselineName

Énumération

Valeur	Description
default

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
Application
Key
ManagedIdentity
User

DatabaseSqlVulnerabilityAssessmentRuleBaseline

Object

Base de référence de règle d’évaluation des vulnérabilités sql de base de données.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.results	string[]	Résultat de la base de référence de la règle
systemData	systemData	SystemData of DatabaseSqlVulnerabilityAssessmentRuleBaselineResource.
type	string	Type de ressource.

DatabaseSqlVulnerabilityAssessmentRuleBaselineInput

Object

Entrée de base de référence de la règle d’évaluation des vulnérabilités sql de base de données.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.latestScan	boolean	Indicateur d’analyse le plus récent
properties.results	string[]	Résultat de la base de référence de la règle
systemData	systemData	SystemData of DatabaseSqlVulnerabilityAssessmentRuleBaselineInputResource.
type	string	Type de ressource.

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

VulnerabilityAssessmentName

Énumération

Nom de l’évaluation des vulnérabilités.

Valeur	Description
default