Data Masking Rules - Create Or Update
Vytváří nebo aktualizuje pravidlo pro maskování dat v databázi.
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
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, na kterou se politika maskování dat vztahuje. |
|
|
data
|
path | True |
string |
Název pravidla pro maskování dat. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Název skupiny prostředků. Název nerozlišuje malá a velká písmena. |
|
server
|
path | True |
string |
Název serveru. |
|
subscription
|
path | True |
string (uuid) |
ID cílového předplatného. Hodnota musí být UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
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 |
Operace Azure byla úspěšně dokončena. |
|
| 201 Created |
Operace vytvoření zdroje 'DataMaskingRule' byla úspěšná |
|
| Other Status Codes |
Neočekávaná chybová odpověď |
Zabezpečení
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
| Name | Description |
|---|---|
| user_impersonation | zosobnění uživatelského účtu |
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=2025-01-01
{
"properties": {
"aliasName": "nickname",
"columnName": "test1",
"maskingFunction": "Default",
"ruleState": "Enabled",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Ukázková odpověď
{
"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.
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=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Default",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Ukázková odpověď
{
"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.
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=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Number",
"numberFrom": "0",
"numberTo": "2",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Ukázková odpověď
{
"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.
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=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Text",
"prefixSize": "1",
"replacementString": "asdf",
"schemaName": "dbo",
"suffixSize": "0",
"tableName": "Table_1"
}
}
Ukázková odpověď
{
"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"
}
}
Definice
| Name | Description |
|---|---|
|
created |
Typ identity, která prostředek vytvořila. |
|
Data |
Funkce maskování, která se používá pro pravidlo maskování dat. |
|
Data |
|
|
Data |
Pravidlo pro maskování dat v databázi. |
|
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ěď |
|
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
createdByType
Typ identity, která prostředek vytvořila.
| Hodnota | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataMaskingFunction
Funkce maskování, která se používá pro pravidlo maskování dat.
| Hodnota | Description |
|---|---|
| Default |
Výchozí |
| CCN |
CCN |
|
|
|
| Number |
Number |
| SSN |
ČSP |
| Text |
Text |
DataMaskingPolicyName
| Hodnota | Description |
|---|---|
| Default |
Výchozí |
DataMaskingRule
Pravidlo pro maskování dat v databázi.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| kind |
string |
Takové pravidlo pro maskování dat. Metadata, použité pro Azure portal. |
| location |
string |
Umístění pravidla pro 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 |
Pravidlo Id. |
| 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. |
| systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
|
| type |
string |
Typ prostředku. Například "Microsoft. Compute/virtualMachines" nebo "Microsoft. Úložiště/úložištěÚčty" |
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 |
Enabled |
| Disabled |
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. |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Časové razítko vytvoření prostředku (UTC). |
| createdBy |
string |
Identita, která prostředek vytvořila. |
| createdByType |
Typ identity, která prostředek vytvořila. |
|
| lastModifiedAt |
string (date-time) |
Časové razítko poslední změny zdroje (UTC) |
| lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
| lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |