Data Masking Rules - Create Or Update
Létrehoz vagy frissíti az adatbázis-adatmaszkolási szabályt.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default/rules/{dataMaskingRuleName}?api-version=2025-01-01
URI-paraméterek
| Name | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
Az adatbázis neve. |
|
data
|
path | True |
Az adatbázis neve, amelyre az adatmaszkolási szabályzat érvényes. |
|
|
data
|
path | True |
string |
Az adatmaszkolási szabály neve. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
|
server
|
path | True |
string |
A kiszolgáló neve. |
|
subscription
|
path | True |
string (uuid) |
A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie. |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használandó API-verzió. |
Kérelem törzse
| Name | Kötelező | Típus | Description |
|---|---|---|---|
| properties.columnName | True |
string |
Az az oszlopnév, amelyre az adatmaszkoló szabályt alkalmazza. |
| properties.maskingFunction | True |
Az adatmaszkolási szabályhoz használt maszkoló függvény. |
|
| properties.schemaName | True |
string |
Az a sémanév, amelyre az adatmaszkolási szabályt alkalmazza. |
| properties.tableName | True |
string |
Az a táblanév, amelyre az adatmaszkoló szabályt alkalmazza. |
| properties.aliasName |
string |
Az alias neve. Ez egy örökölt paraméter, és már nincs használatban. |
|
| properties.numberFrom |
string |
A maszkoló szabály NumberFrom tulajdonsága. Akkor szükséges, ha a MaskingFunction értéke Szám, ellenkező esetben a rendszer figyelmen kívül hagyja ezt a paramétert. |
|
| properties.numberTo |
string |
Az adatmaszkolási szabály NumberTo tulajdonsága. Akkor szükséges, ha a MaskingFunction értéke Szám, ellenkező esetben a rendszer figyelmen kívül hagyja ezt a paramétert. |
|
| properties.prefixSize |
string |
Ha a MaskingFunction értéke Szöveg, a sztring elején elrejtett karakterek száma. Ellenkező esetben a paraméter figyelmen kívül lesz hagyva. |
|
| properties.replacementString |
string |
Ha a MaskingFunction szövegre van állítva, a sztring nem használt részének maszkolásához használandó karakter. Ellenkező esetben a paraméter figyelmen kívül lesz hagyva. |
|
| properties.ruleState |
A szabály állapota. Szabály törlésére szolgál. Meglévő szabály törléséhez adja meg a schemaName, tableName, columnName, maskingFunction, és adja meg a ruleState értéket letiltottként. Ha azonban a szabály még nem létezik, a szabály a ruleState beállítás engedélyezésével jön létre, függetlenül a ruleState megadott értékétől. |
||
| properties.suffixSize |
string |
Ha a MaskingFunction értéke Szöveg, a sztring végén maszkolatlan karakterek száma. Ellenkező esetben a paraméter figyelmen kívül lesz hagyva. |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
Az Azure működése sikeresen befejeződött. |
|
| 201 Created |
Resource 'DataMaskingRule' létrehozása sikeres |
|
| Other Status Codes |
Váratlan hibaválasz. |
Biztonság
azure_auth
Azure Active Directory Oauth2-folyamat.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
| Name | Description |
|---|---|
| user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
| Create/Update data masking rule for default max. |
| Create/Update data masking rule for default min. |
| Create/Update data masking rule for numbers. |
| Create/Update data masking rule for text. |
Create/Update data masking rule for default max.
Mintakérelem
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/rules/rule1?api-version=2025-01-01
{
"properties": {
"aliasName": "nickname",
"columnName": "test1",
"maskingFunction": "Default",
"ruleState": "Enabled",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Mintaválasz
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": "nickname",
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": "nickname",
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
Create/Update data masking rule for default min.
Mintakérelem
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/rules/rule1?api-version=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Default",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Mintaválasz
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
Create/Update data masking rule for numbers.
Mintakérelem
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/rules/rule1?api-version=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Number",
"numberFrom": "0",
"numberTo": "2",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Mintaválasz
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Number",
"numberFrom": "0",
"numberTo": "2",
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Number",
"numberFrom": "0",
"numberTo": "2",
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
Create/Update data masking rule for text.
Mintakérelem
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/rules/rule1?api-version=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Text",
"prefixSize": "1",
"replacementString": "asdf",
"schemaName": "dbo",
"suffixSize": "0",
"tableName": "Table_1"
}
}
Mintaválasz
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Text",
"numberFrom": null,
"numberTo": null,
"prefixSize": "1",
"replacementString": "asdf",
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": "0",
"tableName": "Table_1"
}
}
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Text",
"numberFrom": null,
"numberTo": null,
"prefixSize": "1",
"replacementString": "asdf",
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": "0",
"tableName": "Table_1"
}
}
Definíciók
| Name | Description |
|---|---|
|
created |
Az erőforrást létrehozó identitás típusa. |
|
Data |
Az adatmaszkolási szabályhoz használt maszkoló függvény. |
|
Data |
Az adatbázis neve, amelyre az adatmaszkolási szabályzat érvényes. |
|
Data |
Egy adatbázis-adatmaszkolási szabály. |
|
Data |
A szabály állapota. Szabály törlésére szolgál. Meglévő szabály törléséhez adja meg a schemaName, tableName, columnName, maskingFunction, és adja meg a ruleState értéket letiltottként. Ha azonban a szabály még nem létezik, a szabály a ruleState beállítás engedélyezésével jön létre, függetlenül a ruleState megadott értékétől. |
|
Error |
Az erőforrás-kezelési hiba további információi. |
|
Error |
A hiba részletei. |
|
Error |
Hibaválasz |
|
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
createdByType
Az erőforrást létrehozó identitás típusa.
| Érték | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataMaskingFunction
Az adatmaszkolási szabályhoz használt maszkoló függvény.
| Érték | Description |
|---|---|
| Default |
Alapértelmezett |
| CCN |
CCN |
|
|
|
| Number |
Szám |
| SSN |
TAJ szám |
| Text |
Szöveg |
DataMaskingPolicyName
Az adatbázis neve, amelyre az adatmaszkolási szabályzat érvényes.
| Érték | Description |
|---|---|
| Default |
Alapértelmezett |
DataMaskingRule
Egy adatbázis-adatmaszkolási szabály.
| Name | Típus | Description |
|---|---|---|
| id |
string (arm-id) |
Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| kind |
string |
Az a fajta adatmaszkolási szabály. Metaadat, amelyet az Azure portálhoz használnak. |
| location |
string |
Az adatmaszkolási szabály helye. |
| name |
string |
Az erőforrás neve |
| properties.aliasName |
string |
Az alias neve. Ez egy örökölt paraméter, és már nincs használatban. |
| properties.columnName |
string |
Az az oszlopnév, amelyre az adatmaszkoló szabályt alkalmazza. |
| properties.id |
string |
A szabály Id. |
| properties.maskingFunction |
Az adatmaszkolási szabályhoz használt maszkoló függvény. |
|
| properties.numberFrom |
string |
A maszkoló szabály NumberFrom tulajdonsága. Akkor szükséges, ha a MaskingFunction értéke Szám, ellenkező esetben a rendszer figyelmen kívül hagyja ezt a paramétert. |
| properties.numberTo |
string |
Az adatmaszkolási szabály NumberTo tulajdonsága. Akkor szükséges, ha a MaskingFunction értéke Szám, ellenkező esetben a rendszer figyelmen kívül hagyja ezt a paramétert. |
| properties.prefixSize |
string |
Ha a MaskingFunction értéke Szöveg, a sztring elején elrejtett karakterek száma. Ellenkező esetben a paraméter figyelmen kívül lesz hagyva. |
| properties.replacementString |
string |
Ha a MaskingFunction szövegre van állítva, a sztring nem használt részének maszkolásához használandó karakter. Ellenkező esetben a paraméter figyelmen kívül lesz hagyva. |
| properties.ruleState |
A szabály állapota. Szabály törlésére szolgál. Meglévő szabály törléséhez adja meg a schemaName, tableName, columnName, maskingFunction, és adja meg a ruleState értéket letiltottként. Ha azonban a szabály még nem létezik, a szabály a ruleState beállítás engedélyezésével jön létre, függetlenül a ruleState megadott értékétől. |
|
| properties.schemaName |
string |
Az a sémanév, amelyre az adatmaszkolási szabályt alkalmazza. |
| properties.suffixSize |
string |
Ha a MaskingFunction értéke Szöveg, a sztring végén maszkolatlan karakterek száma. Ellenkező esetben a paraméter figyelmen kívül lesz hagyva. |
| properties.tableName |
string |
Az a táblanév, amelyre az adatmaszkoló szabályt alkalmazza. |
| systemData |
Azure Resource Manager metaadat, amely createdBy és modifiedBy információkat tartalmaz. |
|
| type |
string |
Az erőforrás típusa. Például: "Microsoft. Compute/virtualMachines" vagy "Microsoft. Tárhely/tárolásFiókok" |
DataMaskingRuleState
A szabály állapota. Szabály törlésére szolgál. Meglévő szabály törléséhez adja meg a schemaName, tableName, columnName, maskingFunction, és adja meg a ruleState értéket letiltottként. Ha azonban a szabály még nem létezik, a szabály a ruleState beállítás engedélyezésével jön létre, függetlenül a ruleState megadott értékétől.
| Érték | Description |
|---|---|
| Enabled |
Engedélyezett |
| Disabled |
Disabled |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
| Name | Típus | Description |
|---|---|---|
| info |
object |
A további információk. |
| type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
| Name | Típus | Description |
|---|---|---|
| additionalInfo |
A hiba további információi. |
|
| code |
string |
A hibakód. |
| details |
A hiba részletei. |
|
| message |
string |
A hibaüzenet. |
| target |
string |
A hiba célpontja. |
ErrorResponse
Hibaválasz
| Name | Típus | Description |
|---|---|---|
| error |
A hibaobjektum. |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
| Name | Típus | Description |
|---|---|---|
| createdAt |
string (date-time) |
Az erőforrás-létrehozás időbélyege (UTC). |
| createdBy |
string |
Az erőforrást létrehozó identitás. |
| createdByType |
Az erőforrást létrehozó identitás típusa. |
|
| lastModifiedAt |
string (date-time) |
Az erőforrás utolsó módosításának időbélyege (UTC) |
| lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
| lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |