Data Masking Policies - Create Or Update

Riferimento

Service:: SQL Database

API Version:: 2021-11-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=2021-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
dataMaskingPolicyName	path	True	DataMaskingPolicyName	Nome del database per il quale si applicano i criteri di maschera dati.
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure 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 del criterio per la maschera dati.
properties.exemptPrincipals		string	Elenco delle entità esentate. Specifica l'elenco delimitato da punto e virgola degli utenti del database per i quali i criteri di maschera dati non si applicano. Gli utenti specificati ricevono i risultati dei dati senza mascherare per tutte le query di database.

Risposte

Nome	Tipo	Descrizione
200 OK	DataMaskingPolicy	Criteri di maschera dati del database creati correttamente.
201 Created	DataMaskingPolicy	Criteri di maschera dati del database creati correttamente.
Other Status Codes		Risposte di errore:

Esempio

Create or update data masking policy max

Create or update data masking policy min.

Create or update data masking policy max

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=2021-11-01

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.DataMaskingPolicyInner;
import com.azure.resourcemanager.sql.models.DataMaskingPolicyName;
import com.azure.resourcemanager.sql.models.DataMaskingState;

/** Samples for DataMaskingPolicies CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DataMaskingPolicyCreateOrUpdateMax.
     * json
     */
    /**
     * Sample code: Create or update data masking policy max.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateDataMaskingPolicyMax(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDataMaskingPolicies().createOrUpdateWithResponse(
            "sqlcrudtest-6852", "sqlcrudtest-2080", "sqlcrudtest-331", DataMaskingPolicyName.DEFAULT,
            new DataMaskingPolicyInner().withDataMaskingState(DataMaskingState.ENABLED)
                .withExemptPrincipals("testuser;"),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 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": ""
  }
}

Status code:: 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.

Sample Request

HTTP
Java

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=2021-11-01

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.DataMaskingPolicyInner;
import com.azure.resourcemanager.sql.models.DataMaskingPolicyName;
import com.azure.resourcemanager.sql.models.DataMaskingState;

/** Samples for DataMaskingPolicies CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DataMaskingPolicyCreateOrUpdateMin.
     * json
     */
    /**
     * Sample code: Create or update data masking policy min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateDataMaskingPolicyMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDataMaskingPolicies().createOrUpdateWithResponse(
            "sqlcrudtest-6852", "sqlcrudtest-2080", "sqlcrudtest-331", DataMaskingPolicyName.DEFAULT,
            new DataMaskingPolicyInner().withDataMaskingState(DataMaskingState.ENABLED), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 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": ""
  }
}

Status code:: 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 il quale si applicano i criteri di maschera dati.
DataMaskingState	Stato del criterio per la maschera dati.

DataMaskingPolicy

Criteri di maschera dati del database.

Nome	Tipo	Descrizione
id	string	ID risorsa.
kind	string	Tipo di criteri di maschera dati. Metadati usati per 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 del criterio per la maschera dati.
properties.exemptPrincipals	string	Elenco delle entità esentate. Specifica l'elenco delimitato da punto e virgola degli utenti del database per i quali i criteri di maschera dati non si applicano. Gli utenti specificati ricevono i risultati dei dati senza mascherare per 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

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

Nome	Tipo	Descrizione
Default	string

DataMaskingState

Stato del criterio per la maschera dati.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

Data Masking Policies - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Create or update data masking policy max

Sample Request

Sample Response

Create or update data masking policy min.

Sample Request

Sample Response

Definizioni

DataMaskingPolicy

DataMaskingPolicyName

DataMaskingState

Risorse aggiuntive