Partilhar via

Data Masking Policies - Create Or Update

Serviço:
SQL Database
Versão da API:
2025-01-01

Cria ou atualiza uma política de mascaramento de dados de base de dados.

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

Parâmetros do URI

Name Em Necessário Tipo Description
databaseName
 path True

string

O nome do banco de dados.
dataMaskingPolicyName
 path True

DataMaskingPolicyName

O nome da base de dados para a qual se aplica a política de mascaramento de dados.
resourceGroupName
 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.
serverName
 path True

string

O nome do servidor.
subscriptionId
 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.dataMaskingState True

DataMaskingState

O estado da política de mascaramento de dados.
properties.exemptPrincipals

string

A lista dos principais isentos. Especifica a lista separada por ponto-e-vírgula de usuários de banco de dados aos quais a política de mascaramento de dados não se aplica. Os usuários especificados recebem resultados de dados sem mascarar todas as consultas do banco de dados.

Respostas

Name Tipo Description
200 OK

DataMaskingPolicy

Criei com sucesso a política de mascaramento de dados de base de dados.
201 Created

DataMaskingPolicy

Criou com sucesso a política de mascaramento de dados de base de dados..
Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 InvalidDatabaseNameForDataMaskingOperation - Não é possível aplicar a política e regras de mascaramento de dados diretamente à base de dados principal. As políticas/regras de mascaramento de dados só se aplicam à base de dados dos utilizadores.

Exemplos

Create or update data masking policy max
Create or update data masking policy min.

Create or update data masking policy 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?api-version=2025-01-01

{
  "properties": {
    "dataMaskingState": "Enabled",
    "exemptPrincipals": "testuser;"
  }
}

Resposta da amostra

Código de estado:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "testuser;",
    "maskingLevel": ""
  }
}
Código de estado:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "testuser;",
    "maskingLevel": ""
  }
}

Create or update data masking policy 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?api-version=2025-01-01

{
  "properties": {
    "dataMaskingState": "Enabled"
  }
}

Resposta da amostra

Código de estado:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "",
    "maskingLevel": ""
  }
}
Código de estado:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "",
    "maskingLevel": ""
  }
}

Definições

Name Description
DataMaskingPolicy

Uma política de mascaramento de dados para bases de dados.
DataMaskingPolicyName

O nome da base de dados para a qual se aplica a política de mascaramento de dados.
DataMaskingState

O estado da política de mascaramento de dados.
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro

DataMaskingPolicy

Object

Uma política de mascaramento de dados para bases de dados.

Name Tipo Description
id

string

ID do recurso.
kind

string

O tipo de Política de Mascaramento de Dados. Metadados, usados para o portal Azure.
location

string

A localização da política de dados sobre máscaras.
name

string

Nome do recurso.
properties.applicationPrincipals

string

A lista dos princípios da aplicação. Este é um parâmetro herdado e não é mais usado.
properties.dataMaskingState

DataMaskingState

O estado da política de mascaramento de dados.
properties.exemptPrincipals

string

A lista dos principais isentos. Especifica a lista separada por ponto-e-vírgula de usuários de banco de dados aos quais a política de mascaramento de dados não se aplica. Os usuários especificados recebem resultados de dados sem mascarar todas as consultas do banco de dados.
properties.maskingLevel

string

O nível de mascaramento. Este é um parâmetro herdado e não é mais usado.
type

string

Tipo de recurso.

DataMaskingPolicyName

Enumeração

O nome da base de dados para a qual se aplica a política de mascaramento de dados.

Valor Description
Default

DataMaskingState

Enumeração

O estado da política de mascaramento de dados.

Valor Description
Enabled
Disabled

ErrorAdditionalInfo

Object

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

Object

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.