Sdílet prostřednictvím


Data Masking Rules - Create Or Update

Vytvoří nebo aktualizuje pravidlo maskování dat databáze.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default/rules/{dataMaskingRuleName}?api-version=2021-11-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
databaseName
path True

string

Název databáze.

dataMaskingPolicyName
path True

DataMaskingPolicyName

Název databáze, pro kterou se zásady maskování dat vztahují.

dataMaskingRuleName
path True

string

Název pravidla maskování dat.

resourceGroupName
path True

string

Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.

serverName
path True

string

Název serveru.

subscriptionId
path True

string

ID předplatného, které identifikuje předplatné Azure.

api-version
query True

string

Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name Vyžadováno Typ Description
properties.columnName True

string

Název sloupce, na který se pravidlo maskování dat použije.

properties.maskingFunction True

DataMaskingFunction

Funkce maskování, která se používá pro pravidlo maskování dat.

properties.schemaName True

string

Název schématu, na který se pravidlo maskování dat použije.

properties.tableName True

string

Název tabulky, na kterou se pravidlo maskování dat použije.

properties.aliasName

string

Název aliasu. Jedná se o starší parametr a už se nepoužívá.

properties.numberFrom

string

Vlastnost numberFrom pravidla maskování. Vyžaduje se, pokud je funkce maskingFunction nastavená na hodnotu Number, jinak bude tento parametr ignorován.

properties.numberTo

string

Vlastnost numberTo pravidla maskování dat. Vyžaduje se, pokud je funkce maskingFunction nastavená na hodnotu Number, jinak bude tento parametr ignorován.

properties.prefixSize

string

Pokud je maskingFunction nastavena na Text, počet znaků, které se mají zobrazit bez maskování na začátku řetězce. V opačném případě bude tento parametr ignorován.

properties.replacementString

string

Pokud je funkce maskingFunction nastavena na Text, znak, který se má použít k maskování nevyexponované části řetězce. V opačném případě bude tento parametr ignorován.

properties.ruleState

DataMaskingRuleState

Stav pravidla. Používá se k odstranění pravidla. Pokud chcete odstranit existující pravidlo, zadejte schemaName, tableName, columnName, maskingFunction a jako zakázáno zadejte ruleState. Pokud však pravidlo ještě neexistuje, vytvoří se pravidlo s hodnotou ruleState nastavenou na povolenou bez ohledu na zadanou hodnotu ruleState.

properties.suffixSize

string

Pokud je funkce maskingFunction nastavená na Text, počet znaků, které se mají zobrazit bez maskování na konci řetězce. V opačném případě bude tento parametr ignorován.

Odpovědi

Name Typ Description
200 OK

DataMaskingRule

Pravidlo maskování dat databáze bylo úspěšně nastaveno.

201 Created

DataMaskingRule

Pravidlo maskování dat databáze se úspěšně vytvořilo.

Other Status Codes

Chybové odpovědi: ***

Příklady

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.

Ukázkový požadavek

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=2021-11-01

{
  "properties": {
    "aliasName": "nickname",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "maskingFunction": "Default",
    "ruleState": "Enabled"
  }
}

Ukázková odpověď

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
  "name": null,
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
  "location": "Central US",
  "kind": null,
  "properties": {
    "id": "dbo_Table_1_test1",
    "ruleState": "Enabled",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "aliasName": "nickname",
    "maskingFunction": "Default",
    "numberFrom": null,
    "numberTo": null,
    "prefixSize": null,
    "suffixSize": null,
    "replacementString": null
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
  "name": null,
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
  "location": "Central US",
  "kind": null,
  "properties": {
    "id": "dbo_Table_1_test1",
    "ruleState": "Enabled",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "aliasName": "nickname",
    "maskingFunction": "Default",
    "numberFrom": null,
    "numberTo": null,
    "prefixSize": null,
    "suffixSize": null,
    "replacementString": null
  }
}

Create/Update data masking rule for default min.

Ukázkový požadavek

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=2021-11-01

{
  "properties": {
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "maskingFunction": "Default"
  }
}

Ukázková odpověď

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
  "name": null,
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
  "location": "Central US",
  "kind": null,
  "properties": {
    "id": "dbo_Table_1_test1",
    "ruleState": "Enabled",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "aliasName": null,
    "maskingFunction": "Default",
    "numberFrom": null,
    "numberTo": null,
    "prefixSize": null,
    "suffixSize": null,
    "replacementString": null
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
  "name": null,
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
  "location": "Central US",
  "kind": null,
  "properties": {
    "id": "dbo_Table_1_test1",
    "ruleState": "Enabled",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "aliasName": null,
    "maskingFunction": "Default",
    "numberFrom": null,
    "numberTo": null,
    "prefixSize": null,
    "suffixSize": null,
    "replacementString": null
  }
}

Create/Update data masking rule for numbers.

Ukázkový požadavek

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=2021-11-01

{
  "properties": {
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "maskingFunction": "Number",
    "numberFrom": "0",
    "numberTo": "2"
  }
}

Ukázková odpověď

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
  "name": null,
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
  "location": "Central US",
  "kind": null,
  "properties": {
    "id": "dbo_Table_1_test1",
    "ruleState": "Enabled",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "aliasName": null,
    "maskingFunction": "Number",
    "numberFrom": "0",
    "numberTo": "2",
    "prefixSize": null,
    "suffixSize": null,
    "replacementString": null
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
  "name": null,
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
  "location": "Central US",
  "kind": null,
  "properties": {
    "id": "dbo_Table_1_test1",
    "ruleState": "Enabled",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "aliasName": null,
    "maskingFunction": "Number",
    "numberFrom": "0",
    "numberTo": "2",
    "prefixSize": null,
    "suffixSize": null,
    "replacementString": null
  }
}

Create/Update data masking rule for text.

Ukázkový požadavek

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=2021-11-01

{
  "properties": {
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "maskingFunction": "Text",
    "prefixSize": "1",
    "suffixSize": "0",
    "replacementString": "asdf"
  }
}

Ukázková odpověď

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
  "name": null,
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
  "location": "Central US",
  "kind": null,
  "properties": {
    "id": "dbo_Table_1_test1",
    "ruleState": "Enabled",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "aliasName": null,
    "maskingFunction": "Text",
    "numberFrom": null,
    "numberTo": null,
    "prefixSize": "1",
    "suffixSize": "0",
    "replacementString": "asdf"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
  "name": null,
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
  "location": "Central US",
  "kind": null,
  "properties": {
    "id": "dbo_Table_1_test1",
    "ruleState": "Enabled",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "aliasName": null,
    "maskingFunction": "Text",
    "numberFrom": null,
    "numberTo": null,
    "prefixSize": "1",
    "suffixSize": "0",
    "replacementString": "asdf"
  }
}

Definice

Name Description
DataMaskingFunction

Funkce maskování, která se používá pro pravidlo maskování dat.

DataMaskingPolicyName

Název databáze, pro kterou se zásady maskování dat vztahují.

DataMaskingRule

Pravidlo maskování dat databáze.

DataMaskingRuleState

Stav pravidla. Používá se k odstranění pravidla. Pokud chcete odstranit existující pravidlo, zadejte schemaName, tableName, columnName, maskingFunction a jako zakázáno zadejte ruleState. Pokud však pravidlo ještě neexistuje, vytvoří se pravidlo s hodnotou ruleState nastavenou na povolenou bez ohledu na zadanou hodnotu ruleState.

DataMaskingFunction

Funkce maskování, která se používá pro pravidlo maskování dat.

Name Typ Description
CCN

string

Default

string

Email

string

Number

string

SSN

string

Text

string

DataMaskingPolicyName

Název databáze, pro kterou se zásady maskování dat vztahují.

Name Typ Description
Default

string

DataMaskingRule

Pravidlo maskování dat databáze.

Name Typ Description
id

string

ID prostředku.

kind

string

Druh pravidla maskování dat. Metadata používaná pro Azure Portal.

location

string

Umístění pravidla maskování dat.

name

string

Název prostředku.

properties.aliasName

string

Název aliasu. Jedná se o starší parametr a už se nepoužívá.

properties.columnName

string

Název sloupce, na který se pravidlo maskování dat použije.

properties.id

string

ID pravidla.

properties.maskingFunction

DataMaskingFunction

Funkce maskování, která se používá pro pravidlo maskování dat.

properties.numberFrom

string

Vlastnost numberFrom pravidla maskování. Vyžaduje se, pokud je funkce maskingFunction nastavená na hodnotu Number, jinak bude tento parametr ignorován.

properties.numberTo

string

Vlastnost numberTo pravidla maskování dat. Vyžaduje se, pokud je funkce maskingFunction nastavená na hodnotu Number, jinak bude tento parametr ignorován.

properties.prefixSize

string

Pokud je maskingFunction nastavena na Text, počet znaků, které se mají zobrazit bez maskování na začátku řetězce. V opačném případě bude tento parametr ignorován.

properties.replacementString

string

Pokud je funkce maskingFunction nastavena na Text, znak, který se má použít k maskování nevyexponované části řetězce. V opačném případě bude tento parametr ignorován.

properties.ruleState

DataMaskingRuleState

Stav pravidla. Používá se k odstranění pravidla. Pokud chcete odstranit existující pravidlo, zadejte schemaName, tableName, columnName, maskingFunction a jako zakázáno zadejte ruleState. Pokud však pravidlo ještě neexistuje, vytvoří se pravidlo s hodnotou ruleState nastavenou na povolenou bez ohledu na zadanou hodnotu ruleState.

properties.schemaName

string

Název schématu, na který se pravidlo maskování dat použije.

properties.suffixSize

string

Pokud je funkce maskingFunction nastavená na Text, počet znaků, které se mají zobrazit bez maskování na konci řetězce. V opačném případě bude tento parametr ignorován.

properties.tableName

string

Název tabulky, na kterou se pravidlo maskování dat použije.

type

string

Typ prostředku.

DataMaskingRuleState

Stav pravidla. Používá se k odstranění pravidla. Pokud chcete odstranit existující pravidlo, zadejte schemaName, tableName, columnName, maskingFunction a jako zakázáno zadejte ruleState. Pokud však pravidlo ještě neexistuje, vytvoří se pravidlo s hodnotou ruleState nastavenou na povolenou bez ohledu na zadanou hodnotu ruleState.

Name Typ Description
Disabled

string

Enabled

string