Data Masking Policies - Create Or Update

Riferimento

Servizio:: SQL Database

Versione API:: 2023-08-01

Crea o aggiorna un criterio di maschera dati del database.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
dataMaskingPolicyName	path	True	DataMaskingPolicyName	Nome del database per cui si applicano i criteri di maschera 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	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	Criteri di maschera dati del database creati correttamente.
201 Created	DataMaskingPolicy	Il criterio di maschera dati del database è stato creato correttamente.
Other Status Codes	ErrorResponse	Risposte di errore: 400 InvalidDatabaseNameForDataMaskingOperation: non è possibile applicare criteri e regole di maschera dati direttamente al database master. I criteri o le regole di maschera dati sono applicabili solo al database utente.

Nome

Tipo

Descrizione

200 OK

DataMaskingPolicy

Criteri di maschera dati del database creati correttamente.

201 Created

DataMaskingPolicy

Il criterio di maschera dati del database è stato creato correttamente.

Other Status Codes

ErrorResponse

Risposte di errore:

400 InvalidDatabaseNameForDataMaskingOperation: non è possibile applicare criteri e regole di maschera dati direttamente al database master. I criteri o le regole di maschera dati sono applicabili solo al database utente.

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

HTTP

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=2023-08-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

HTTP

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=2023-08-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	Criteri di maschera dati del database.
DataMaskingPolicyName	Nome del database per cui si applicano i criteri di maschera 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

Object

Criteri di maschera dati del database.

Nome	Tipo	Descrizione
id	string	ID risorsa.
kind	string	Tipo di criteri di maschera dati. Metadati, usati per il portale di Azure.
location	string	Posizione dei criteri di maschera dati.
name	string	Nome risorsa.
properties.applicationPrincipals	string	Elenco delle entità 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	Livello di mascheramento. Si tratta di un parametro legacy e non viene più usato.
type	string	Tipo di risorsa.

DataMaskingPolicyName

Enumerazione

Nome del database per cui si applicano i criteri di maschera dati.

Valore	Descrizione
Default

DataMaskingState

Enumerazione

Stato dei criteri di maschera dati.

Valore	Descrizione
Disabled
Enabled

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

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

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

Condividi tramite

Data Masking Policies - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Create or update data masking policy max

Esempio di richiesta

Risposta di esempio

Create or update data masking policy min.

Esempio di richiesta

Risposta di esempio

Definizioni

DataMaskingPolicy

DataMaskingPolicyName

DataMaskingState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Risorse aggiuntive