Condividi tramite

Data Masking Policies - Create Or Update

Servizio:
SQL Database
Versione API:
2025-01-01

Crea o aggiorna una politica di mascheramento dati del database.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
 path True

string

Nome del database.
dataMaskingPolicyName
 path True

DataMaskingPolicyName

Il nome del database per cui si applica la politica di mascheramento dei dati.
resourceGroupName
 path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
serverName
 path True

string

Il nome del server.
subscriptionId
 path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version
 query True

string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome Necessario Tipo Descrizione
properties.dataMaskingState True

DataMaskingState

Stato dei criteri di maschera dati.
properties.exemptPrincipals

string

Elenco delle entità esentate. Specifica l'elenco delimitato da punto e virgola degli utenti del database per cui non si applicano i criteri di maschera dati. Gli utenti specificati ricevono i risultati dei dati senza mascherare tutte le query di database.

Risposte

Nome Tipo Descrizione
200 OK

DataMaskingPolicy

Ho creato con successo una politica di mascheramento dei dati del database.
201 Created

DataMaskingPolicy

Ha creato con successo una politica di mascheramento dei dati del database..
Other Status Codes

ErrorResponse

Risposte di errore:

  • 400 InvalidDatabaseNameForDataMaskingOperation - Non è possibile applicare direttamente la politica e le regole di mascheramento dei dati al database master. Le politiche/regole sulla mascheratura dati sono applicabili solo al database degli utenti.

Esempio

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

Create or update data masking policy max

Esempio di richiesta

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;"
  }
}

Risposta di esempio

Codice di stato:
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": ""
  }
}
Codice di stato:
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.

Esempio di richiesta

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"
  }
}

Risposta di esempio

Codice di stato:
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": ""
  }
}
Codice di stato:
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": ""
  }
}

Definizioni

Nome Descrizione
DataMaskingPolicy

Una politica di maschera dei dati del database.
DataMaskingPolicyName

Il nome del database per cui si applica la politica di mascheramento dei dati.
DataMaskingState

Stato dei criteri di maschera dati.
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore

DataMaskingPolicy

Oggetto

Una politica di maschera dei dati del database.

Nome Tipo Descrizione
id

string

ID risorsa.
kind

string

Il tipo di politica di mascheramento dati. Metadati, utilizzati per il portale Azure.
location

string

La posizione della politica di mascherina sui dati.
name

string

Nome risorsa.
properties.applicationPrincipals

string

L'elenco dei principi dell'applicazione. Si tratta di un parametro legacy e non viene più usato.
properties.dataMaskingState

DataMaskingState

Stato dei criteri di maschera dati.
properties.exemptPrincipals

string

Elenco delle entità esentate. Specifica l'elenco delimitato da punto e virgola degli utenti del database per cui non si applicano i criteri di maschera dati. Gli utenti specificati ricevono i risultati dei dati senza mascherare tutte le query di database.
properties.maskingLevel

string

Il livello di mascheramento. Si tratta di un parametro legacy e non viene più usato.
type

string

Tipo di risorsa.

DataMaskingPolicyName

Enumerazione

Il nome del database per cui si applica la politica di mascheramento dei dati.

Valore Descrizione
Default

DataMaskingState

Enumerazione

Stato dei criteri di maschera dati.

Valore Descrizione
Enabled
Disabled

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

ErrorDetail[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.