Data Masking Policies - Create Or Update

Servicio:

SQL Database

Versión de la API:

2021-11-01

Crea o actualiza una directiva de enmascaramiento de datos de base de datos.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
databaseName	path	True	string	El nombre de la base de datos.
dataMaskingPolicyName	path	True	DataMaskingPolicyName	Nombre de la base de datos para la que se aplica la directiva de enmascaramiento de datos.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName	path	True	string	El nombre del servidor.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.dataMaskingState	True	DataMaskingState	El estado de la directiva de enmascaramiento de datos.
properties.exemptPrincipals		string	Lista de las entidades de seguridad exentas. Especifica la lista separada por punto y coma de usuarios de base de datos para los que no se aplica la directiva de enmascaramiento de datos. Los usuarios especificados reciben resultados de datos sin enmascaramiento para todas las consultas de base de datos.

Respuestas

Nombre	Tipo	Description
200 OK	DataMaskingPolicy	Se creó correctamente la directiva de enmascaramiento de datos de base de datos.
201 Created	DataMaskingPolicy	Se creó correctamente la directiva de enmascaramiento de datos de la base de datos.
Other Status Codes		Respuestas de error: ***

Ejemplos

Create or update data masking policy max

Create or update data masking policy min.

Create or update data masking policy max

Solicitud de ejemplo

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

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

Java

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;"),
                com.azure.core.util.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

Respuesta de muestra

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.

Solicitud de ejemplo

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

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

Java

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),
            com.azure.core.util.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

Respuesta de muestra

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

Definiciones

Nombre	Description
DataMaskingPolicy	Una directiva de enmascaramiento de datos de base de datos.
DataMaskingPolicyName	Nombre de la base de datos para la que se aplica la directiva de enmascaramiento de datos.
DataMaskingState	El estado de la directiva de enmascaramiento de datos.

DataMaskingPolicy

Object

Una directiva de enmascaramiento de datos de base de datos.

Nombre	Tipo	Description
id	string	Identificador del recurso.
kind	string	El tipo de directiva de enmascaramiento de datos. Metadatos, usados para Azure Portal.
location	string	Ubicación de la directiva de enmascaramiento de datos.
name	string	Nombre del recurso.
properties.applicationPrincipals	string	Lista de las entidades de seguridad de la aplicación. Se trata de un parámetro heredado y ya no se usa.
properties.dataMaskingState	DataMaskingState	El estado de la directiva de enmascaramiento de datos.
properties.exemptPrincipals	string	Lista de las entidades de seguridad exentas. Especifica la lista separada por punto y coma de usuarios de base de datos para los que no se aplica la directiva de enmascaramiento de datos. Los usuarios especificados reciben resultados de datos sin enmascaramiento para todas las consultas de base de datos.
properties.maskingLevel	string	Nivel de enmascaramiento. Se trata de un parámetro heredado y ya no se usa.
type	string	Tipo de recurso.

DataMaskingPolicyName

Enumeration

Nombre de la base de datos para la que se aplica la directiva de enmascaramiento de datos.

Valor	Description
Default

DataMaskingState

Enumeration

El estado de la directiva de enmascaramiento de datos.

Valor	Description
Disabled
Enabled