Data Masking Policies - Create Or Update
Crée ou met à jour une politique de masquage des données de la base de données.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default?api-version=2025-01-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
Nom de la base de données. |
|
data
|
path | True |
Le nom de la base de données pour laquelle s’applique la politique de masquage des données. |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
server
|
path | True |
string |
Le nom du serveur |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| properties.dataMaskingState | True |
État de la stratégie de masquage des données. |
|
| properties.exemptPrincipals |
string |
Liste des principaux exemptés. Spécifie la liste séparée par des points-virgules des utilisateurs de base de données pour lesquels la stratégie de masquage des données ne s’applique pas. Les utilisateurs spécifiés reçoivent des résultats de données sans masquer toutes les requêtes de base de données. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Opération de mise à jour de la ressource 'DataMaskingPolicy' réussie |
|
| 201 Created |
Ressource 'DataMaskingPolicy' créer une opération réussie |
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
| Create or update data masking policy max |
| Create or update data masking policy min. |
Create or update data masking policy max
Exemple de requête
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default?api-version=2025-01-01
{
"properties": {
"dataMaskingState": "Enabled",
"exemptPrincipals": "testuser;"
}
}
Exemple de réponse
{
"name": "Default",
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
"kind": null,
"location": "Central US",
"properties": {
"applicationPrincipals": "",
"dataMaskingState": "Enabled",
"exemptPrincipals": "testuser;",
"maskingLevel": ""
}
}
{
"name": "Default",
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
"kind": null,
"location": "Central US",
"properties": {
"applicationPrincipals": "",
"dataMaskingState": "Enabled",
"exemptPrincipals": "testuser;",
"maskingLevel": ""
}
}
Create or update data masking policy min.
Exemple de requête
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default?api-version=2025-01-01
{
"properties": {
"dataMaskingState": "Enabled"
}
}
Exemple de réponse
{
"name": "Default",
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
"kind": null,
"location": "Central US",
"properties": {
"applicationPrincipals": "",
"dataMaskingState": "Enabled",
"exemptPrincipals": "",
"maskingLevel": ""
}
}
{
"name": "Default",
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
"kind": null,
"location": "Central US",
"properties": {
"applicationPrincipals": "",
"dataMaskingState": "Enabled",
"exemptPrincipals": "",
"maskingLevel": ""
}
}
Définitions
| Nom | Description |
|---|---|
|
created |
Type d’identité qui a créé la ressource. |
|
Data |
Une politique de masquage des données dans les bases de données. |
|
Data |
|
|
Data |
État de la stratégie de masquage des données. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataMaskingPolicy
Une politique de masquage des données dans les bases de données.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
| kind |
string |
Le genre de politique de masquage des données. Métadonnées, utilisées pour le portail Azure. |
| location |
string |
L’emplacement de la politique de masquage des données. |
| name |
string |
Nom de la ressource |
| properties.applicationPrincipals |
string |
La liste des principaux responsables de l’application. Il s’agit d’un paramètre hérité et n’est plus utilisé. |
| properties.dataMaskingState |
État de la stratégie de masquage des données. |
|
| properties.exemptPrincipals |
string |
Liste des principaux exemptés. Spécifie la liste séparée par des points-virgules des utilisateurs de base de données pour lesquels la stratégie de masquage des données ne s’applique pas. Les utilisateurs spécifiés reçoivent des résultats de données sans masquer toutes les requêtes de base de données. |
| properties.maskingLevel |
string |
Le niveau de masquage. Il s’agit d’un paramètre hérité et n’est plus utilisé. |
| systemData |
Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy. |
|
| type |
string |
Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts" |
DataMaskingPolicyName
| Valeur | Description |
|---|---|
| Default |
Par défaut |
DataMaskingState
État de la stratégie de masquage des données.
| Valeur | Description |
|---|---|
| Enabled |
Activé |
| Disabled |
Désactivé |
ErrorAdditionalInfo
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
Détail de l’erreur.
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
Objet d’erreur. |
systemData
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 |
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 |
Type d’identité qui a modifié la ressource pour la dernière fois. |