Data Masking Rules - List By Database

Odwołanie

Service:: SQL Database

API Version:: 2021-11-01

Pobiera listę reguł maskowania danych bazy danych.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default/rules?api-version=2021-11-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych.
dataMaskingPolicyName	path	True	DataMaskingPolicyName	Nazwa bazy danych, dla której ma zastosowanie reguła maskowania danych.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DataMaskingRuleListResult	Pomyślnie pobrano listę stanów usługi Advanced Threat Protection serwera.
Other Status Codes		Odpowiedzi na błędy: ***

Przykłady

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

Definicje

Nazwa	Opis
DataMaskingFunction	Funkcja maskowania używana dla reguły maskowania danych.
DataMaskingPolicyName	Nazwa bazy danych, dla której ma zastosowanie reguła maskowania danych.
DataMaskingRule	Reguła maskowania danych bazy danych.
DataMaskingRuleListResult	Lista reguł maskowania danych bazy danych.
DataMaskingRuleState	Stan reguły. Służy do usuwania reguły. Aby usunąć istniejącą regułę, określ wartość schemaName, tableName, columnName, maskingFunction i określ wartość ruleState jako wyłączoną. Jeśli jednak reguła jeszcze nie istnieje, reguła zostanie utworzona z ustawioną wartością ruleState ustawioną na włączoną, niezależnie od podanej wartości ruleState.

DataMaskingFunction

Funkcja maskowania używana dla reguły maskowania danych.

Nazwa	Typ	Opis
CCN	string
Default	string
Email	string
Number	string
SSN	string
Text	string

DataMaskingPolicyName

Nazwa bazy danych, dla której ma zastosowanie reguła maskowania danych.

Nazwa	Typ	Opis
Default	string

DataMaskingRule

Reguła maskowania danych bazy danych.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
kind	string	Rodzaj reguły maskowania danych. Metadane używane do Azure Portal.
location	string	Lokalizacja reguły maskowania danych.
name	string	Nazwa zasobu.
properties.aliasName	string	Nazwa aliasu. Jest to starszy parametr i nie jest już używany.
properties.columnName	string	Nazwa kolumny, na której jest stosowana reguła maskowania danych.
properties.id	string	Identyfikator reguły.
properties.maskingFunction	DataMaskingFunction	Funkcja maskowania używana dla reguły maskowania danych.
properties.numberFrom	string	Właściwość numberFrom reguły maskowania. Wymagane, jeśli ustawienie maskowaniaFunction ma wartość Liczba, w przeciwnym razie ten parametr zostanie zignorowany.
properties.numberTo	string	Właściwość numberTo reguły maskowania danych. Wymagane, jeśli ustawienie maskowaniaFunction ma wartość Liczba, w przeciwnym razie ten parametr zostanie zignorowany.
properties.prefixSize	string	Jeśli maskowanieFunction jest ustawione na Tekst, liczba znaków do wyświetlenia niezamaskowanych na początku ciągu. W przeciwnym razie ten parametr zostanie zignorowany.
properties.replacementString	string	Jeśli maskowanieFunction jest ustawione na Tekst, znak używany do maskowania nieeksponowanej części ciągu. W przeciwnym razie ten parametr zostanie zignorowany.
properties.ruleState	DataMaskingRuleState	Stan reguły. Służy do usuwania reguły. Aby usunąć istniejącą regułę, określ wartość schemaName, tableName, columnName, maskingFunction i określ wartość ruleState jako wyłączoną. Jeśli jednak reguła jeszcze nie istnieje, reguła zostanie utworzona z ustawioną wartością ruleState ustawioną na włączoną, niezależnie od podanej wartości ruleState.
properties.schemaName	string	Nazwa schematu, na którym jest stosowana reguła maskowania danych.
properties.suffixSize	string	Jeśli ustawienie maskowaniaFunction ma wartość Text, liczba znaków do wyświetlenia niemaskowanych na końcu ciągu. W przeciwnym razie ten parametr zostanie zignorowany.
properties.tableName	string	Nazwa tabeli, w której jest stosowana reguła maskowania danych.
type	string	Typ zasobu.

DataMaskingRuleListResult

Lista reguł maskowania danych bazy danych.

Nazwa	Typ	Opis
nextLink	string	Link, aby pobrać następną stronę wyników.
value	DataMaskingRule[]	Tablica wyników.

DataMaskingRuleState

Stan reguły. Służy do usuwania reguły. Aby usunąć istniejącą regułę, określ wartość schemaName, tableName, columnName, maskingFunction i określ wartość ruleState jako wyłączoną. Jeśli jednak reguła jeszcze nie istnieje, reguła zostanie utworzona z ustawioną wartością ruleState ustawioną na włączoną, niezależnie od podanej wartości ruleState.

Nazwa	Typ	Opis
Disabled	string
Enabled	string