Condividi tramite


Data Masking Rules - List By Database

Ottiene un elenco di regole di maschera dati del database.

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

Risposte

Nome Tipo Descrizione
200 OK

DataMaskingRuleListResult

È stato recuperato correttamente l'elenco degli stati di Advanced Threat Protection del server.

Other Status Codes

Risposte di errore:

Esempio

Gets a list of database data masking rules.

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
DataMaskingFunction

Funzione di mascheramento utilizzata per la regola di maschera dati.

DataMaskingPolicyName

Nome del database per il quale viene applicata la regola di maschera dati.

DataMaskingRule

Regola di maschera dati del database.

DataMaskingRuleListResult

Elenco di regole di maschera 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 impostato su abilitato, indipendentemente dal valore specificato di ruleState.

DataMaskingFunction

Funzione di mascheramento utilizzata per la regola di maschera dati.

Nome Tipo Descrizione
CCN

string

Default

string

Email

string

Number

string

SSN

string

Text

string

DataMaskingPolicyName

Nome del database per il quale viene applicata la regola di maschera dati.

Nome Tipo Descrizione
Default

string

DataMaskingRule

Regola di maschera dati del database.

Nome Tipo Descrizione
id

string

ID risorsa.

kind

string

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

location

string

Posizione della regola di maschera dati.

name

string

Nome risorsa.

properties.aliasName

string

Nome dell'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 dati.

properties.id

string

ID regola.

properties.maskingFunction

DataMaskingFunction

Funzione di mascheramento utilizzata per la regola di maschera 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 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 non mascherato all'inizio della stringa. In caso contrario, questo parametro verrà ignorato.

properties.replacementString

string

Se maskingFunction è impostato su Text, il carattere da utilizzare 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 impostato su abilitato, indipendentemente dal valore specificato di ruleState.

properties.schemaName

string

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

properties.suffixSize

string

Se maskingFunction è impostato su Testo, il numero di caratteri da visualizzare mascherato 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 dati.

type

string

Tipo di risorsa.

DataMaskingRuleListResult

Elenco di regole di maschera dati del database.

Nome Tipo Descrizione
nextLink

string

Collegamento per recuperare la pagina successiva dei risultati.

value

DataMaskingRule[]

Matrice di risultati.

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 impostato su abilitato, indipendentemente dal valore specificato di ruleState.

Nome Tipo Descrizione
Disabled

string

Enabled

string