Data Masking Rules - List By Database

Reference

Služba:: SQL Database

Verze rozhraní API:: 2023-08-01

Získá seznam pravidel maskování dat databáze.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
dataMaskingPolicyName	path	True	DataMaskingPolicyName	Název databáze, pro kterou platí pravidlo maskování dat.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	DataMaskingRuleListResult	Úspěšně se načetl seznam stavů rozšířené ochrany před internetovými útoky serveru.
Other Status Codes	ErrorResponse	Chybové odpovědi: ***

Příklady

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/DataMaskingRuleListByDatabase.json
// this example is just showing the usage of "DataMaskingRules_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DataMaskingPolicyResource created on azure
// for more information of creating DataMaskingPolicyResource, please refer to the document of DataMaskingPolicyResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-6852";
string serverName = "sqlcrudtest-2080";
string databaseName = "sqlcrudtest-331";
DataMaskingPolicyName dataMaskingPolicyName = DataMaskingPolicyName.Default;
ResourceIdentifier dataMaskingPolicyResourceId = DataMaskingPolicyResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, dataMaskingPolicyName);
DataMaskingPolicyResource dataMaskingPolicy = client.GetDataMaskingPolicyResource(dataMaskingPolicyResourceId);

// invoke the operation and iterate over the result
await foreach (DataMaskingRule item in dataMaskingPolicy.GetDataMaskingRulesAsync())
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:: 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
      }
    }
  ]
}

Definice

Name	Description
DataMaskingFunction	Funkce maskování, která se používá pro pravidlo maskování dat.
DataMaskingPolicyName	Název databáze, pro kterou platí pravidlo maskování dat.
DataMaskingRule	Pravidlo maskování dat databáze.
DataMaskingRuleListResult	Seznam pravidel maskování dat databáze.
DataMaskingRuleState	Stav pravidla. Slouží k odstranění pravidla. Pokud chcete odstranit existující pravidlo, zadejte schemaName, tableName, columnName, maskingFunction a zadejte ruleState jako zakázané. Pokud však pravidlo ještě neexistuje, pravidlo se vytvoří s povolenou hodnotou ruleState bez ohledu na zadanou hodnotu ruleState.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď

DataMaskingFunction

Výčet

Funkce maskování, která se používá pro pravidlo maskování dat.

Hodnota	Description
CCN
Default
Email
Number
SSN
Text

DataMaskingPolicyName

Výčet

Název databáze, pro kterou platí pravidlo maskování dat.

Hodnota	Description
Default

DataMaskingRule

Objekt

Pravidlo maskování dat databáze.

Name	Typ	Description
id	string	ID prostředku.
kind	string	Druh pravidla maskování dat. Metadata používaná pro Azure Portal.
location	string	Umístění pravidla maskování dat.
name	string	Název prostředku
properties.aliasName	string	Název aliasu. Jedná se o starší parametr a už se nepoužívá.
properties.columnName	string	Název sloupce, na kterém se použije pravidlo maskování dat.
properties.id	string	ID pravidla.
properties.maskingFunction	DataMaskingFunction	Funkce maskování, která se používá pro pravidlo maskování dat.
properties.numberFrom	string	NumberFrom vlastnost masking rule. Vyžaduje se, pokud je maskingFunction nastaven na Number, jinak bude tento parametr ignorován.
properties.numberTo	string	Vlastnost numberTo pravidla maskování dat. Vyžaduje se, pokud je maskingFunction nastaven na Number, jinak bude tento parametr ignorován.
properties.prefixSize	string	Pokud je maskováníFunction nastaveno na Text, počet znaků, které se mají zobrazit na začátku řetězce. Jinak se tento parametr bude ignorovat.
properties.replacementString	string	Pokud je maskováníFunction nastaveno na Text, znak, který se má použít k maskování nevyexponované části řetězce. Jinak se tento parametr bude ignorovat.
properties.ruleState	DataMaskingRuleState	Stav pravidla. Slouží k odstranění pravidla. Pokud chcete odstranit existující pravidlo, zadejte schemaName, tableName, columnName, maskingFunction a zadejte ruleState jako zakázané. Pokud však pravidlo ještě neexistuje, pravidlo se vytvoří s povolenou hodnotou ruleState bez ohledu na zadanou hodnotu ruleState.
properties.schemaName	string	Název schématu, na kterém je použito pravidlo maskování dat.
properties.suffixSize	string	Pokud je maskingFunction nastaven na Text, počet znaků, které se mají zobrazit odmaskované na konci řetězce. Jinak se tento parametr bude ignorovat.
properties.tableName	string	Název tabulky, na kterém je použito pravidlo maskování dat.
type	string	Typ prostředku.

DataMaskingRuleListResult

Objekt

Seznam pravidel maskování dat databáze.

Name	Typ	Description
nextLink	string	Odkaz na načtení další stránky výsledků
value	DataMaskingRule[]	Pole výsledků

DataMaskingRuleState

Výčet

Stav pravidla. Slouží k odstranění pravidla. Pokud chcete odstranit existující pravidlo, zadejte schemaName, tableName, columnName, maskingFunction a zadejte ruleState jako zakázané. Pokud však pravidlo ještě neexistuje, pravidlo se vytvoří s povolenou hodnotou ruleState bez ohledu na zadanou hodnotu ruleState.

Hodnota	Description
Disabled
Enabled

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Sdílet prostřednictvím

Data Masking Rules - List By Database

Parametry identifikátoru URI

Odpovědi

Příklady

Gets a list of database data masking rules.

Ukázkový požadavek

Ukázková odpověď

Definice

DataMaskingFunction

DataMaskingPolicyName

DataMaskingRule

DataMaskingRuleListResult

DataMaskingRuleState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse