Condividi tramite


Data Masking Rules - Create Or Update

Crea o aggiorna una regola di maschera dati del database.

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

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 dei dati.

dataMaskingRuleName
path True

string

Nome della regola 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.columnName True

string

Nome della colonna in cui viene applicata la regola di maschera dei dati.

properties.maskingFunction True

DataMaskingFunction

Funzione di maschera usata per la regola di maschera dei dati.

properties.schemaName True

string

Nome dello schema in cui viene applicata la regola di maschera dei dati.

properties.tableName True

string

Nome della tabella in cui viene applicata la regola di maschera dei dati.

properties.aliasName

string

Nome alias. Si tratta di un parametro legacy e non viene più usato.

properties.numberFrom

string

Proprietà numberFrom della regola di mascheramento. Obbligatorio se maskingFunction è impostato su Number, in caso contrario questo parametro verrà ignorato.

properties.numberTo

string

Proprietà numberTo della regola di maschera dei dati. Obbligatorio se maskingFunction è impostato su Number, in caso contrario questo parametro verrà ignorato.

properties.prefixSize

string

Se maskingFunction è impostato su Testo, il numero di caratteri da visualizzare senza maschera nell'inizio della stringa. In caso contrario, questo parametro verrà ignorato.

properties.replacementString

string

Se maskingFunction è impostato su Testo, il carattere da usare per mascherare la parte non esposta della stringa. In caso contrario, questo parametro verrà ignorato.

properties.ruleState

DataMaskingRuleState

Stato della regola. Usato per eliminare una regola. Per eliminare una regola esistente, specificare schemaName, tableName, columnName, maskingFunction e specificare ruleState come disabilitato. Tuttavia, se la regola non esiste già, la regola verrà creata con ruleState impostata su abilitata, indipendentemente dal valore specificato di ruleState.

properties.suffixSize

string

Se maskingFunction è impostato su Testo, il numero di caratteri da visualizzare senza maschera alla fine della stringa. In caso contrario, questo parametro verrà ignorato.

Risposte

Nome Tipo Descrizione
200 OK

DataMaskingRule

Impostare correttamente una regola di maschera dati del database.

201 Created

DataMaskingRule

È stata creata correttamente una regola di maschera dei dati del database.

Other Status Codes

Risposte agli errori: **

Esempio

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.

Esempio di richiesta

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

Risposta di esempio

{
  "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.

Esempio di richiesta

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

Risposta di esempio

{
  "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.

Esempio di richiesta

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

Risposta di esempio

{
  "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.

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
DataMaskingFunction

Funzione di maschera usata per la regola di maschera dei dati.

DataMaskingPolicyName

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

DataMaskingRule

Regola di maschera dei dati del database.

DataMaskingRuleState

Stato della regola. Usato per eliminare una regola. Per eliminare una regola esistente, specificare schemaName, tableName, columnName, maskingFunction e specificare ruleState come disabilitato. Tuttavia, se la regola non esiste già, la regola verrà creata con ruleState impostata su abilitata, indipendentemente dal valore specificato di ruleState.

DataMaskingFunction

Funzione di maschera usata per la regola di maschera dei dati.

Nome Tipo Descrizione
CCN

string

Default

string

Email

string

Number

string

SSN

string

Text

string

DataMaskingPolicyName

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

Nome Tipo Descrizione
Default

string

DataMaskingRule

Regola di maschera dei dati del database.

Nome Tipo Descrizione
id

string

ID risorsa.

kind

string

Tipo di regola di maschera dati. Metadati usati per portale di Azure.

location

string

Posizione della regola di maschera dei dati.

name

string

Nome risorsa.

properties.aliasName

string

Nome alias. Si tratta di un parametro legacy e non viene più usato.

properties.columnName

string

Nome della colonna in cui viene applicata la regola di maschera dei dati.

properties.id

string

ID regola.

properties.maskingFunction

DataMaskingFunction

Funzione di maschera usata per la regola di maschera dei dati.

properties.numberFrom

string

Proprietà numberFrom della regola di mascheramento. Obbligatorio se maskingFunction è impostato su Number, in caso contrario questo parametro verrà ignorato.

properties.numberTo

string

Proprietà numberTo della regola di maschera dei dati. Obbligatorio se maskingFunction è impostato su Number, in caso contrario questo parametro verrà ignorato.

properties.prefixSize

string

Se maskingFunction è impostato su Testo, il numero di caratteri da visualizzare senza maschera nell'inizio della stringa. In caso contrario, questo parametro verrà ignorato.

properties.replacementString

string

Se maskingFunction è impostato su Testo, il carattere da usare per mascherare la parte non esposta della stringa. In caso contrario, questo parametro verrà ignorato.

properties.ruleState

DataMaskingRuleState

Stato della regola. Usato per eliminare una regola. Per eliminare una regola esistente, specificare schemaName, tableName, columnName, maskingFunction e specificare ruleState come disabilitato. Tuttavia, se la regola non esiste già, la regola verrà creata con ruleState impostata su abilitata, indipendentemente dal valore specificato di ruleState.

properties.schemaName

string

Nome dello schema in cui viene applicata la regola di maschera dei dati.

properties.suffixSize

string

Se maskingFunction è impostato su Testo, il numero di caratteri da visualizzare senza maschera alla fine della stringa. In caso contrario, questo parametro verrà ignorato.

properties.tableName

string

Nome della tabella in cui viene applicata la regola di maschera dei dati.

type

string

Tipo di risorsa.

DataMaskingRuleState

Stato della regola. Usato per eliminare una regola. Per eliminare una regola esistente, specificare schemaName, tableName, columnName, maskingFunction e specificare ruleState come disabilitato. Tuttavia, se la regola non esiste già, la regola verrà creata con ruleState impostata su abilitata, indipendentemente dal valore specificato di ruleState.

Nome Tipo Descrizione
Disabled

string

Enabled

string