Partilhar via


Data Masking Rules - Create Or Update

Cria ou atualiza uma regra de máscara de dados de base de dados.

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

Parâmetros do URI

Name Em Necessário Tipo Description
databaseName
path True

string

O nome da base de dados.

dataMaskingPolicyName
path True

DataMaskingPolicyName

O nome da base de dados para a qual se aplica a política de máscara de dados.

dataMaskingRuleName
path True

string

O nome da regra de máscara de dados.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

O ID da subscrição que identifica uma subscrição do Azure.

api-version
query True

string

A versão da API a utilizar para o pedido.

Corpo do Pedido

Name Necessário Tipo Description
properties.columnName True

string

O nome da coluna em que a regra de máscara de dados é aplicada.

properties.maskingFunction True

DataMaskingFunction

A função de mascaramento utilizada para a regra de máscara de dados.

properties.schemaName True

string

O nome do esquema no qual a regra de máscara de dados é aplicada.

properties.tableName True

string

O nome da tabela em que a regra de máscara de dados é aplicada.

properties.aliasName

string

O nome do alias. Este é um parâmetro legado e já não é utilizado.

properties.numberFrom

string

A propriedade numberFrom da regra de máscara. Necessário se maskingFunction estiver definido como Número, caso contrário, este parâmetro será ignorado.

properties.numberTo

string

A propriedade numberTo da regra de máscara de dados. Necessário se maskingFunction estiver definido como Número, caso contrário, este parâmetro será ignorado.

properties.prefixSize

string

Se maskingFunction estiver definido como Texto, o número de carateres a mostrar desmascarado no início da cadeia. Caso contrário, este parâmetro será ignorado.

properties.replacementString

string

Se maskingFunction estiver definido como Texto, o caráter a utilizar para mascarar a parte nãoexposta da cadeia. Caso contrário, este parâmetro será ignorado.

properties.ruleState

DataMaskingRuleState

O estado da regra. Utilizado para eliminar uma regra. Para eliminar uma regra existente, especifique schemaName, tableName, columnName, maskingFunction e especifique ruleState como desativado. No entanto, se a regra ainda não existir, a regra será criada com ruleState definido como ativado, independentemente do valor fornecido de ruleState.

properties.suffixSize

string

Se maskingFunction estiver definido como Texto, o número de carateres a mostrar não foi desmascarado no final da cadeia. Caso contrário, este parâmetro será ignorado.

Respostas

Name Tipo Description
200 OK

DataMaskingRule

Definir com êxito uma regra de máscara de dados de base de dados.

201 Created

DataMaskingRule

Foi criada com êxito uma regra de máscara de dados de base 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=2021-11-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=2021-11-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=2021-11-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=2021-11-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
DataMaskingFunction

A função de mascaramento utilizada para a regra de máscara de dados.

DataMaskingPolicyName

O nome da base de dados para a qual se aplica a política de máscara de dados.

DataMaskingRule

Uma regra de máscara de dados de base de dados.

DataMaskingRuleState

O estado da regra. Utilizado para eliminar uma regra. Para eliminar uma regra existente, especifique schemaName, tableName, columnName, maskingFunction e especifique ruleState como desativado. No entanto, se a regra ainda não existir, a regra será criada com ruleState definido como ativado, independentemente do valor fornecido de ruleState.

DataMaskingFunction

A função de mascaramento utilizada para a regra de máscara de dados.

Name Tipo Description
CCN

string

Default

string

Email

string

Number

string

SSN

string

Text

string

DataMaskingPolicyName

O nome da base de dados para a qual se aplica a política de máscara de dados.

Name Tipo Description
Default

string

DataMaskingRule

Uma regra de máscara de dados de base de dados.

Name Tipo Description
id

string

ID do Recurso.

kind

string

O tipo de Regra de Máscara de Dados. Metadados, utilizados para portal do Azure.

location

string

A localização da regra de máscara de dados.

name

string

Nome do recurso.

properties.aliasName

string

O nome do alias. Este é um parâmetro legado e já não é utilizado.

properties.columnName

string

O nome da coluna em que a regra de máscara de dados é aplicada.

properties.id

string

O ID da regra.

properties.maskingFunction

DataMaskingFunction

A função de mascaramento utilizada para a regra de máscara de dados.

properties.numberFrom

string

A propriedade numberFrom da regra de máscara. Necessário se maskingFunction estiver definido como Número, caso contrário, este parâmetro será ignorado.

properties.numberTo

string

A propriedade numberTo da regra de máscara de dados. Necessário se maskingFunction estiver definido como Número, caso contrário, este parâmetro será ignorado.

properties.prefixSize

string

Se maskingFunction estiver definido como Texto, o número de carateres a mostrar desmascarado no início da cadeia. Caso contrário, este parâmetro será ignorado.

properties.replacementString

string

Se maskingFunction estiver definido como Texto, o caráter a utilizar para mascarar a parte nãoexposta da cadeia. Caso contrário, este parâmetro será ignorado.

properties.ruleState

DataMaskingRuleState

O estado da regra. Utilizado para eliminar uma regra. Para eliminar uma regra existente, especifique schemaName, tableName, columnName, maskingFunction e especifique ruleState como desativado. No entanto, se a regra ainda não existir, a regra será criada com ruleState definido como ativado, independentemente do valor fornecido de ruleState.

properties.schemaName

string

O nome do esquema no qual a regra de máscara de dados é aplicada.

properties.suffixSize

string

Se maskingFunction estiver definido como Texto, o número de carateres a mostrar não foi desmascarado no final da cadeia. Caso contrário, este parâmetro será ignorado.

properties.tableName

string

O nome da tabela em que a regra de máscara de dados é aplicada.

type

string

Tipo de recurso.

DataMaskingRuleState

O estado da regra. Utilizado para eliminar uma regra. Para eliminar uma regra existente, especifique schemaName, tableName, columnName, maskingFunction e especifique ruleState como desativado. No entanto, se a regra ainda não existir, a regra será criada com ruleState definido como ativado, independentemente do valor fornecido de ruleState.

Name Tipo Description
Disabled

string

Enabled

string