Data Masking Rules - Create Or Update
Cria ou atualiza uma regra de mascaramento de dados de banco de dados.
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
Parâmetros do URI
| Name | Em | Necessário | Tipo | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
O nome do banco de dados. |
|
data
|
path | True |
O nome do banco de dados ao qual a política de mascaramento de dados se aplica. |
|
|
data
|
path | True |
string |
O nome da regra de mascaramento de dados. |
|
resource
|
path | True |
string |
O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal. |
|
server
|
path | True |
string |
O nome do servidor. |
|
subscription
|
path | True |
string |
A ID de assinatura que identifica uma assinatura do Azure. |
|
api-version
|
query | True |
string |
A versão da API a ser usada para a solicitação. |
Corpo do Pedido
| Name | Necessário | Tipo | Description |
|---|---|---|---|
| properties.columnName | True |
string |
O nome da coluna na qual a regra de mascaramento de dados é aplicada. |
| properties.maskingFunction | True |
A função de mascaramento usada para a regra de mascaramento de dados. |
|
| properties.schemaName | True |
string |
O nome do esquema no qual a regra de mascaramento de dados é aplicada. |
| properties.tableName | True |
string |
O nome da tabela na qual a regra de mascaramento de dados é aplicada. |
| properties.aliasName |
string |
O nome do alias. Este é um parâmetro herdado e não é mais usado. |
|
| properties.numberFrom |
string |
A propriedade numberFrom da regra de mascaramento. Obrigatório se maskingFunction estiver definido como Number, caso contrário, esse parâmetro será ignorado. |
|
| properties.numberTo |
string |
A propriedade numberTo da regra de mascaramento de dados. Obrigatório se maskingFunction estiver definido como Number, caso contrário, esse parâmetro será ignorado. |
|
| properties.prefixSize |
string |
Se maskingFunction estiver definido como Text, o número de caracteres a serem exibidos desmascarados no início da cadeia de caracteres. Caso contrário, esse parâmetro será ignorado. |
|
| properties.replacementString |
string |
Se maskingFunction estiver definido como Text, o caractere a ser usado para mascarar a parte não exposta da cadeia de caracteres. Caso contrário, esse parâmetro será ignorado. |
|
| properties.ruleState |
O estado da regra. Usado para excluir uma regra. Para excluir uma regra existente, especifique schemaName, tableName, columnName, maskingFunction e especifique ruleState como desabilitado. No entanto, se a regra ainda não existir, ela será criada com ruleState definido como enabled, independentemente do valor fornecido de ruleState. |
||
| properties.suffixSize |
string |
Se maskingFunction estiver definido como Text, o número de caracteres a serem exibidos desmascarados no final da cadeia de caracteres. Caso contrário, esse parâmetro será ignorado. |
Respostas
| Name | Tipo | Description |
|---|---|---|
| 200 OK |
Definir com êxito uma regra de mascaramento de dados de banco de dados. |
|
| 201 Created |
Criada com êxito uma regra de mascaramento de dados de banco de dados. |
|
| Other Status Codes |
Respostas de erro: ***
|
Exemplos
| 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.
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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.
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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.
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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.
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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"
}
}
Definições
| Name | Description |
|---|---|
|
Data |
A função de mascaramento usada para a regra de mascaramento de dados. |
|
Data |
O nome do banco de dados ao qual a política de mascaramento de dados se aplica. |
|
Data |
Uma regra de mascaramento de dados de banco de dados. |
|
Data |
O estado da regra. Usado para excluir uma regra. Para excluir uma regra existente, especifique schemaName, tableName, columnName, maskingFunction e especifique ruleState como desabilitado. No entanto, se a regra ainda não existir, ela será criada com ruleState definido como enabled, independentemente do valor fornecido de ruleState. |
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
DataMaskingFunction
A função de mascaramento usada para a regra de mascaramento de dados.
| Valor | Description |
|---|---|
| Default | |
| CCN | |
| Number | |
| SSN | |
| Text |
DataMaskingPolicyName
O nome do banco de dados ao qual a política de mascaramento de dados se aplica.
| Valor | Description |
|---|---|
| Default |
DataMaskingRule
Uma regra de mascaramento de dados de banco de dados.
| Name | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso. |
| kind |
string |
O tipo de regra de mascaramento de dados. Metadados, usados para o portal do Azure. |
| location |
string |
A localização da regra de mascaramento de dados. |
| name |
string |
Nome do recurso. |
| properties.aliasName |
string |
O nome do alias. Este é um parâmetro herdado e não é mais usado. |
| properties.columnName |
string |
O nome da coluna na qual a regra de mascaramento de dados é aplicada. |
| properties.id |
string |
A regra Id. |
| properties.maskingFunction |
A função de mascaramento usada para a regra de mascaramento de dados. |
|
| properties.numberFrom |
string |
A propriedade numberFrom da regra de mascaramento. Obrigatório se maskingFunction estiver definido como Number, caso contrário, esse parâmetro será ignorado. |
| properties.numberTo |
string |
A propriedade numberTo da regra de mascaramento de dados. Obrigatório se maskingFunction estiver definido como Number, caso contrário, esse parâmetro será ignorado. |
| properties.prefixSize |
string |
Se maskingFunction estiver definido como Text, o número de caracteres a serem exibidos desmascarados no início da cadeia de caracteres. Caso contrário, esse parâmetro será ignorado. |
| properties.replacementString |
string |
Se maskingFunction estiver definido como Text, o caractere a ser usado para mascarar a parte não exposta da cadeia de caracteres. Caso contrário, esse parâmetro será ignorado. |
| properties.ruleState |
O estado da regra. Usado para excluir uma regra. Para excluir uma regra existente, especifique schemaName, tableName, columnName, maskingFunction e especifique ruleState como desabilitado. No entanto, se a regra ainda não existir, ela será criada com ruleState definido como enabled, independentemente do valor fornecido de ruleState. |
|
| properties.schemaName |
string |
O nome do esquema no qual a regra de mascaramento de dados é aplicada. |
| properties.suffixSize |
string |
Se maskingFunction estiver definido como Text, o número de caracteres a serem exibidos desmascarados no final da cadeia de caracteres. Caso contrário, esse parâmetro será ignorado. |
| properties.tableName |
string |
O nome da tabela na qual a regra de mascaramento de dados é aplicada. |
| type |
string |
Tipo de recurso. |
DataMaskingRuleState
O estado da regra. Usado para excluir uma regra. Para excluir uma regra existente, especifique schemaName, tableName, columnName, maskingFunction e especifique ruleState como desabilitado. No entanto, se a regra ainda não existir, ela será criada com ruleState definido como enabled, independentemente do valor fornecido de ruleState.
| Valor | Description |
|---|---|
| Enabled | |
| Disabled |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
| Name | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Name | Tipo | Description |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Name | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |