Data Masking Rules - List By Database

Referencia

Service:: SQL Database

API Version:: 2021-11-01

Obtiene una lista de reglas de enmascaramiento de datos de base de datos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default/rules?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 regla 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.

Respuestas

Nombre	Tipo	Description
200 OK	DataMaskingRuleListResult	Recuperó correctamente la lista de estados de Advanced Threat Protection del servidor.
Other Status Codes		Respuestas de error: ***

Ejemplos

Gets a list of database data masking rules.

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules?api-version=2021-11-01


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

/** Samples for DataMaskingRules ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DataMaskingRuleListByDatabase.json
     */
    /**
     * Sample code: Gets a list of database data masking rules.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getsAListOfDatabaseDataMaskingRules(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDataMaskingRules().listByDatabase("sqlcrudtest-6852",
            "sqlcrudtest-2080", "sqlcrudtest-331", DataMaskingPolicyName.DEFAULT, 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

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
      "name": null,
      "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
      "location": "Central US",
      "kind": null,
      "properties": {
        "id": "dbo_Table_1_test1",
        "ruleState": "Enabled",
        "schemaName": "dbo",
        "tableName": "Table_1",
        "columnName": "test1",
        "aliasName": null,
        "maskingFunction": "Text",
        "numberFrom": null,
        "numberTo": null,
        "prefixSize": "1",
        "suffixSize": "0",
        "replacementString": "asdf"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/",
      "name": null,
      "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
      "location": "Central US",
      "kind": null,
      "properties": {
        "id": "dbo_Table_1_test1",
        "ruleState": "Enabled",
        "schemaName": "dbo",
        "tableName": "Table_1",
        "columnName": "test1",
        "aliasName": null,
        "maskingFunction": "Number",
        "numberFrom": "0",
        "numberTo": "2",
        "prefixSize": null,
        "suffixSize": null,
        "replacementString": null
      }
    }
  ]
}

Definiciones

Nombre	Description
DataMaskingFunction	Función de enmascaramiento que se usa para la regla de enmascaramiento de datos.
DataMaskingPolicyName	Nombre de la base de datos para la que se aplica la regla de enmascaramiento de datos.
DataMaskingRule	Una regla de enmascaramiento de datos de base de datos.
DataMaskingRuleListResult	Lista de reglas de enmascaramiento de datos de base de datos.
DataMaskingRuleState	Estado de la regla. Se usa para eliminar una regla. Para eliminar una regla existente, especifique schemaName, tableName, columnName, maskingFunction y especifique ruleState como deshabilitado. Sin embargo, si la regla aún no existe, la regla se creará con ruleState establecido en habilitado, independientemente del valor proporcionado de ruleState.

DataMaskingFunction

Función de enmascaramiento que se usa para la regla de enmascaramiento de datos.

Nombre	Tipo	Description
CCN	string
Default	string
Email	string
Number	string
SSN	string
Text	string

DataMaskingPolicyName

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

Nombre	Tipo	Description
Default	string

DataMaskingRule

Una regla de enmascaramiento de datos de base de datos.

Nombre	Tipo	Description
id	string	Identificador del recurso.
kind	string	El tipo de regla de enmascaramiento de datos. Metadatos, usados para Azure Portal.
location	string	Ubicación de la regla de enmascaramiento de datos.
name	string	Nombre del recurso.
properties.aliasName	string	Nombre del alias. Se trata de un parámetro heredado y ya no se usa.
properties.columnName	string	Nombre de columna en el que se aplica la regla de enmascaramiento de datos.
properties.id	string	Identificador de regla.
properties.maskingFunction	DataMaskingFunction	Función de enmascaramiento que se usa para la regla de enmascaramiento de datos.
properties.numberFrom	string	La propiedad numberFrom de la regla de enmascaramiento. Obligatorio si maskingFunction está establecido en Number; de lo contrario, se omitirá este parámetro.
properties.numberTo	string	La propiedad numberTo de la regla de enmascaramiento de datos. Obligatorio si maskingFunction está establecido en Number; de lo contrario, se omitirá este parámetro.
properties.prefixSize	string	Si maskingFunction se establece en Text, el número de caracteres que se van a mostrar sin máscara al principio de la cadena. De lo contrario, se omitirá este parámetro.
properties.replacementString	string	Si maskingFunction se establece en Text, el carácter que se va a usar para enmascarar la parte no expuesta de la cadena. De lo contrario, se omitirá este parámetro.
properties.ruleState	DataMaskingRuleState	Estado de la regla. Se usa para eliminar una regla. Para eliminar una regla existente, especifique schemaName, tableName, columnName, maskingFunction y especifique ruleState como deshabilitado. Sin embargo, si la regla aún no existe, la regla se creará con ruleState establecido en habilitado, independientemente del valor proporcionado de ruleState.
properties.schemaName	string	Nombre de esquema en el que se aplica la regla de enmascaramiento de datos.
properties.suffixSize	string	Si maskingFunction se establece en Text, el número de caracteres que se mostrarán sin máscara al final de la cadena. De lo contrario, se omitirá este parámetro.
properties.tableName	string	Nombre de tabla en el que se aplica la regla de enmascaramiento de datos.
type	string	Tipo de recurso.

DataMaskingRuleListResult

Lista de reglas de enmascaramiento de datos de base de datos.

Nombre	Tipo	Description
nextLink	string	Vínculo para recuperar la página siguiente de resultados.
value	DataMaskingRule[]	Matriz de resultados.

DataMaskingRuleState

Estado de la regla. Se usa para eliminar una regla. Para eliminar una regla existente, especifique schemaName, tableName, columnName, maskingFunction y especifique ruleState como deshabilitado. Sin embargo, si la regla aún no existe, la regla se creará con ruleState establecido en habilitado, independientemente del valor proporcionado de ruleState.

Nombre	Tipo	Description
Disabled	string
Enabled	string