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 |
|---|---|---|---|---|
|
database
|
path | True |
string |
Název databáze. |
|
data
|
path | True |
Název databáze, pro kterou platí zásady maskování dat. |
|
|
data
|
path | True |
string |
Název pravidla maskování dat. |
|
resource
|
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. |
|
server
|
path | True |
string |
Název serveru. |
|
subscription
|
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 |
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 |
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 |
Úspěšně nastavte pravidlo maskování dat databáze. |
|
| 201 Created |
Úspěšně se vytvořilo pravidlo maskování dat databáze. |
|
| 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=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 |
|---|---|
|
Data |
Funkce maskování, která se používá pro pravidlo maskování dat. |
|
Data |
Název databáze, pro kterou platí zásady maskování dat. |
|
Data |
Pravidlo maskování dat databáze. |
|
Data |
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. |
|
Error |
Další informace o chybě správy prostředků |
|
Error |
Podrobnosti o chybě. |
|
Error |
Chybová odpověď |
DataMaskingFunction
Funkce maskování, která se používá pro pravidlo maskování dat.
| Hodnota | Description |
|---|---|
| Default | |
| CCN | |
| 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 |
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 |
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 |
Další informace o chybě. |
|
| code |
string |
Kód chyby. |
| details |
Podrobnosti o chybě. |
|
| message |
string |
Chybová zpráva. |
| target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
| Name | Typ | Description |
|---|---|---|
| error |
Objekt chyby. |