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=2023-08-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 platí zásady maskování dat.

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 Manageru nebo 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ém se použije pravidlo maskování dat.

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ém je použito pravidlo maskování dat.

properties.tableName True

string

Název tabulky, na kterém je použito pravidlo maskování dat.

properties.aliasName

string

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

properties.numberFrom

string

NumberFrom vlastnost masking rule. Vyžaduje se, pokud je maskingFunction nastaven na Number, jinak bude tento parametr ignorován.

properties.numberTo

string

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

properties.prefixSize

string

Pokud je maskováníFunction nastaveno na Text, počet znaků, které se mají zobrazit na začátku řetězce. Jinak se tento parametr bude ignorovat.

properties.replacementString

string

Pokud je maskováníFunction nastaveno na Text, znak, který se má použít k maskování nevyexponované části řetězce. Jinak se tento parametr bude ignorovat.

properties.ruleState

DataMaskingRuleState

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

properties.suffixSize

string

Pokud je maskingFunction nastaven na Text, počet znaků, které se mají zobrazit odmaskované na konci řetězce. Jinak se tento parametr bude ignorovat.

Odpovědi

Name Typ Description
200 OK

DataMaskingRule

Úspěšně nastavte pravidlo maskování dat databáze.

201 Created

DataMaskingRule

Úspěšně se vytvořilo pravidlo maskování dat databáze.

Other Status Codes

ErrorResponse

Chybové odpovědi: ***

  • 400 InvalidDatabaseNameForDataMaskingOperation - Není možné použít zásady maskování dat a pravidla přímo na hlavní databázi. Zásady maskování dat nebo pravidla se vztahují pouze na uživatelskou databázi.

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=2023-08-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=2023-08-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=2023-08-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=2023-08-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 platí zásady maskování dat.

DataMaskingRule

Pravidlo maskování dat databáze.

DataMaskingRuleState

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

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

DataMaskingFunction

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

Hodnota Description
Default
CCN
Email
Number
SSN
Text

DataMaskingPolicyName

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

Hodnota Description
Default

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ém se použije pravidlo maskování dat.

properties.id

string

ID pravidla.

properties.maskingFunction

DataMaskingFunction

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

properties.numberFrom

string

NumberFrom vlastnost masking rule. Vyžaduje se, pokud je maskingFunction nastaven na Number, jinak bude tento parametr ignorován.

properties.numberTo

string

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

properties.prefixSize

string

Pokud je maskováníFunction nastaveno na Text, počet znaků, které se mají zobrazit na začátku řetězce. Jinak se tento parametr bude ignorovat.

properties.replacementString

string

Pokud je maskováníFunction nastaveno na Text, znak, který se má použít k maskování nevyexponované části řetězce. Jinak se tento parametr bude ignorovat.

properties.ruleState

DataMaskingRuleState

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

properties.schemaName

string

Název schématu, na kterém je použito pravidlo maskování dat.

properties.suffixSize

string

Pokud je maskingFunction nastaven na Text, počet znaků, které se mají zobrazit odmaskované na konci řetězce. Jinak se tento parametr bude ignorovat.

properties.tableName

string

Název tabulky, na kterém je použito pravidlo maskování dat.

type

string

Typ prostředku.

DataMaskingRuleState

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

Hodnota Description
Enabled
Disabled

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.