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
databaseName
path True

string

Az adatbázis neve.

dataMaskingPolicyName
path True

DataMaskingPolicyName

Az adatbázis neve, amelyre az adatmaszkolási szabályzat érvényes.

dataMaskingRuleName
path True

string

Az adatmaszkolási szabály neve.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

serverName
path True

string

A kiszolgáló neve.

subscriptionId
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

DataMaskingFunction

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

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.

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

DataMaskingRule

Az Azure működése sikeresen befejeződött.

201 Created

DataMaskingRule

Resource 'DataMaskingRule' létrehozása sikeres

Other Status Codes

ErrorResponse

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
createdByType

Az erőforrást létrehozó identitás típusa.

DataMaskingFunction

Az adatmaszkolási szabályhoz használt maszkoló függvény.

DataMaskingPolicyName

Az adatbázis neve, amelyre az adatmaszkolási szabályzat érvényes.

DataMaskingRule

Egy adatbázis-adatmaszkolási szabály.

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.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

systemData

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

Email

Email

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

DataMaskingFunction

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

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.

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

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

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célpontja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

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

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

createdByType

Az erőforrást legutóbb módosító identitás típusa.