Data Masking Rules - Create Or Update
Crea o actualiza una regla 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/rules/{dataMaskingRuleName}?api-version=2021-11-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
database
|
path | True |
string |
El nombre de la base de datos. |
data
|
path | True |
Nombre de la base de datos para la que se aplica la directiva de enmascaramiento de datos. |
|
data
|
path | True |
string |
Nombre de la regla de enmascaramiento de datos. |
resource
|
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. |
server
|
path | True |
string |
El nombre del servidor. |
subscription
|
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.columnName | True |
string |
Nombre de columna en el que se aplica la regla de enmascaramiento de datos. |
properties.maskingFunction | True |
Función de enmascaramiento que se usa para la regla de enmascaramiento de datos. |
|
properties.schemaName | True |
string |
Nombre de esquema en el que se aplica la regla de enmascaramiento de datos. |
properties.tableName | True |
string |
Nombre de tabla en el que se aplica la regla de enmascaramiento de datos. |
properties.aliasName |
string |
Nombre del alias. Se trata de un parámetro heredado y ya no se usa. |
|
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 |
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.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. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Establezca correctamente una regla de enmascaramiento de datos de base de datos. |
|
201 Created |
Creó correctamente una regla de enmascaramiento de datos de base de datos. |
|
Other Status Codes |
Respuestas de error: *** |
Ejemplos
Create/Update data masking rule for default max. |
Create/Update data masking rule for default min. |
Create/Update data masking rule for numbers. |
Create/Update data masking rule for text. |
Create/Update data masking rule for default max.
Solicitud de ejemplo
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/rules/rule1?api-version=2021-11-01
{
"properties": {
"aliasName": "nickname",
"schemaName": "dbo",
"tableName": "Table_1",
"columnName": "test1",
"maskingFunction": "Default",
"ruleState": "Enabled"
}
}
Respuesta de muestra
{
"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": "nickname",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"suffixSize": null,
"replacementString": null
}
}
{
"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": "nickname",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"suffixSize": null,
"replacementString": null
}
}
Create/Update data masking rule for default min.
Solicitud de ejemplo
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/rules/rule1?api-version=2021-11-01
{
"properties": {
"schemaName": "dbo",
"tableName": "Table_1",
"columnName": "test1",
"maskingFunction": "Default"
}
}
Respuesta de muestra
{
"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": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"suffixSize": null,
"replacementString": null
}
}
{
"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": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"suffixSize": null,
"replacementString": null
}
}
Create/Update data masking rule for numbers.
Solicitud de ejemplo
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/rules/rule1?api-version=2021-11-01
{
"properties": {
"schemaName": "dbo",
"tableName": "Table_1",
"columnName": "test1",
"maskingFunction": "Number",
"numberFrom": "0",
"numberTo": "2"
}
}
Respuesta de muestra
{
"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
}
}
{
"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
}
}
Create/Update data masking rule for text.
Solicitud de ejemplo
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/rules/rule1?api-version=2021-11-01
{
"properties": {
"schemaName": "dbo",
"tableName": "Table_1",
"columnName": "test1",
"maskingFunction": "Text",
"prefixSize": "1",
"suffixSize": "0",
"replacementString": "asdf"
}
}
Respuesta de muestra
{
"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": "Text",
"numberFrom": null,
"numberTo": null,
"prefixSize": "1",
"suffixSize": "0",
"replacementString": "asdf"
}
}
Definiciones
Nombre | Description |
---|---|
Data |
Función de enmascaramiento que se usa para la regla de enmascaramiento de datos. |
Data |
Nombre de la base de datos para la que se aplica la directiva de enmascaramiento de datos. |
Data |
Una regla de enmascaramiento de datos de base de datos. |
Data |
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 |
|
string |
||
Number |
string |
|
SSN |
string |
|
Text |
string |
DataMaskingPolicyName
Nombre de la base de datos para la que se aplica la directiva 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 |
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 |
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. |
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 |