Compartilhar via


Data Masking Rules - List By Database

Obtém uma lista de regras de mascaramento de dados de banco de dados.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default/rules?api-version=2021-11-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
databaseName
path True

string

O nome do banco de dados.

dataMaskingPolicyName
path True

DataMaskingPolicyName

O nome do banco de dados para o qual a regra de mascaramento de dados se aplica.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor na API do Azure Resource Manager ou no portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID da assinatura que identifica uma assinatura do Azure.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Respostas

Nome Tipo Description
200 OK

DataMaskingRuleListResult

Recuperou com êxito a lista dos estados de Proteção Avançada contra Ameaças do servidor.

Other Status Codes

Respostas de erro: ***

Exemplos

Gets a list of database data masking rules.

Solicitação de exemplo

GET 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?api-version=2021-11-01

Resposta de exemplo

{
  "value": [
    {
      "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": "Number",
        "numberFrom": "0",
        "numberTo": "2",
        "prefixSize": null,
        "suffixSize": null,
        "replacementString": null
      }
    }
  ]
}

Definições

Nome Description
DataMaskingFunction

A função de mascaramento usada para a regra de mascaramento de dados.

DataMaskingPolicyName

O nome do banco de dados para o qual a regra de mascaramento de dados se aplica.

DataMaskingRule

Uma regra de mascaramento de dados de banco de dados.

DataMaskingRuleListResult

A lista de regras de mascaramento de dados de banco de dados.

DataMaskingRuleState

O estado da regra. Usado para excluir uma regra. Para excluir uma regra existente, especifique o esquemaName, tableName, columnName, maskingFunction e especifique ruleState como desabilitado. No entanto, se a regra ainda não existir, a regra será criada com ruleState definido como habilitado, independentemente do valor fornecido de ruleState.

DataMaskingFunction

A função de mascaramento usada para a regra de mascaramento de dados.

Valor Description
Default
CCN
Email
Number
SSN
Text

DataMaskingPolicyName

O nome do banco de dados para o qual a regra de mascaramento de dados se aplica.

Valor Description
Default

DataMaskingRule

Uma regra de mascaramento de dados de banco de dados.

Nome Tipo Description
id

string

ID do recurso.

kind

string

O tipo de regra de máscara de dados. Metadados, usados para o portal do Azure.

location

string

O local da regra de mascaramento de dados.

name

string

Nome do recurso.

properties.aliasName

string

O nome do alias. Esse é um parâmetro herdado e não é mais usado.

properties.columnName

string

O nome da coluna no qual a regra de mascaramento de dados é aplicada.

properties.id

string

A ID da regra.

properties.maskingFunction

DataMaskingFunction

A função de mascaramento usada para a regra de mascaramento de dados.

properties.numberFrom

string

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

properties.numberTo

string

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

properties.prefixSize

string

Se maskingFunction for definido como Texto, 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 Texto, o caractere a ser usado para mascarar a parte nãoexposta da cadeia de caracteres. Caso contrário, esse parâmetro será ignorado.

properties.ruleState

DataMaskingRuleState

O estado da regra. Usado para excluir uma regra. Para excluir uma regra existente, especifique o esquemaName, tableName, columnName, maskingFunction e especifique ruleState como desabilitado. No entanto, se a regra ainda não existir, a regra será criada com ruleState definido como habilitado, 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 for definido como Texto, 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 no qual a regra de mascaramento de dados é aplicada.

type

string

Tipo de recurso.

DataMaskingRuleListResult

A lista de regras de mascaramento de dados de banco de dados.

Nome Tipo Description
nextLink

string

Link para recuperar a próxima página de resultados.

value

DataMaskingRule[]

Matriz de resultados.

DataMaskingRuleState

O estado da regra. Usado para excluir uma regra. Para excluir uma regra existente, especifique o esquemaName, tableName, columnName, maskingFunction e especifique ruleState como desabilitado. No entanto, se a regra ainda não existir, a regra será criada com ruleState definido como habilitado, independentemente do valor fornecido de ruleState.

Valor Description
Enabled
Disabled