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=2023-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
path True

string

Nome del database.

dataMaskingPolicyName
path True

DataMaskingPolicyName

Nome del database per cui si applica la regola di maschera dati.

resourceGroupName
path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager 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 l'elenco degli stati di Advanced Threat Protection del server.

Other Status Codes

ErrorResponse

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=2023-08-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 maschera utilizzata per la regola di maschera dati.

DataMaskingPolicyName

Nome del database per cui si applica la regola di maschera dati.

DataMaskingRule

Regola di maschera dati del database.

DataMaskingRuleListResult

Elenco delle regole di maschera dati del database.

DataMaskingRuleState

Stato della regola. Consente di 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.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

DataMaskingFunction

Funzione di maschera utilizzata per la regola di maschera dati.

Valore Descrizione
CCN
Default
Email
Number
SSN
Text

DataMaskingPolicyName

Nome del database per cui si applica la regola di maschera dati.

Valore Descrizione
Default

DataMaskingRule

Regola di maschera dati del database.

Nome Tipo Descrizione
id

string

ID risorsa.

kind

string

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

location

string

Posizione della regola di maschera 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 dati.

properties.id

string

ID regola.

properties.maskingFunction

DataMaskingFunction

Funzione di maschera 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. Consente di 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 non 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 delle 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. Consente di 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.

Valore Descrizione
Disabled
Enabled

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.