Data Masking Rules - Create Or Update

Erstellt oder aktualisiert eine Datenbankdatenformatierungsregel.

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

URI-Parameter

Name In Required Type Description
databaseName
path True
  • string

Der Name der Datenbank.

dataMaskingPolicyName
path True

Der Name der Datenbank, für die die Datenformatierungsregel gilt.

dataMaskingRuleName
path True
  • string

Der Name der Datenformatierungsregel.

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

serverName
path True
  • string

Name des Servers

subscriptionId
path True
  • string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True
  • string

API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name Required Type Description
properties.columnName True
  • string

Der Spaltenname, auf den die Datenformatierungsregel angewendet wird.

properties.maskingFunction True

Die Maskierungsfunktion, die für die Datenformatierungsregel verwendet wird.

properties.schemaName True
  • string

Der Schemaname, auf den die Datenformatierungsregel angewendet wird.

properties.tableName True
  • string

Der Tabellenname, auf den die Datenformatierungsregel angewendet wird.

properties.aliasName
  • string

Der Aliasname. Dies ist ein Legacyparameter und wird nicht mehr verwendet.

properties.numberFrom
  • string

Die NumberFrom-Eigenschaft der Maskierungsregel. Erforderlich, wenn "MaskingFunction" auf "Zahl" festgelegt ist, andernfalls wird dieser Parameter ignoriert.

properties.numberTo
  • string

Die NumberTo-Eigenschaft der Datenformatierungsregel. Erforderlich, wenn "MaskingFunction" auf "Zahl" festgelegt ist, andernfalls wird dieser Parameter ignoriert.

properties.prefixSize
  • string

Wenn "MaskingFunction" auf "Text" festgelegt ist, wird die Anzahl der Zeichen, die am Anfang der Zeichenfolge unmasket angezeigt werden sollen. Andernfalls wird dieser Parameter ignoriert.

properties.replacementString
  • string

Wenn "maskingFunction" auf "Text" festgelegt ist, wird das Zeichen zum Maskieren des nicht exponierten Teils der Zeichenfolge verwendet. Andernfalls wird dieser Parameter ignoriert.

properties.ruleState

Der Regelzustand. Wird verwendet, um eine Regel zu löschen. Um eine vorhandene Regel zu löschen, geben Sie den schemaName, tableName, columnName, maskingFunction an, und geben Sie "ruleState" als deaktiviert an. Wenn die Regel jedoch noch nicht vorhanden ist, wird die Regel mit "ruleState" erstellt, die aktiviert ist, unabhängig vom bereitgestellten Wert von ruleState.

properties.suffixSize
  • string

Wenn "MaskingFunction" auf "Text" festgelegt ist, wird die Anzahl der Zeichen, die am Ende der Zeichenfolge unmasket angezeigt werden sollen. Andernfalls wird dieser Parameter ignoriert.

Antworten

Name Type Description
200 OK

OK

201 Created

Erstellt

Beispiele

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

Sample Request

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=2014-04-01

{
  "properties": {
    "aliasName": "nickname",
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "maskingFunction": "Default",
    "ruleState": "Enabled"
  }
}

Sample Response

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

Sample Request

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=2014-04-01

{
  "properties": {
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "maskingFunction": "Default"
  }
}

Sample Response

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

Sample Request

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=2014-04-01

{
  "properties": {
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "maskingFunction": "Number",
    "numberFrom": "0",
    "numberTo": "2"
  }
}

Sample Response

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

Sample Request

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=2014-04-01

{
  "properties": {
    "schemaName": "dbo",
    "tableName": "Table_1",
    "columnName": "test1",
    "maskingFunction": "Text",
    "prefixSize": "1",
    "suffixSize": "0",
    "replacementString": "asdf"
  }
}

Sample Response

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

Definitionen

DataMaskingFunction

Die Maskierungsfunktion, die für die Datenformatierungsregel verwendet wird.

DataMaskingPolicyName

Der Name der Datenbank, für die die Datenformatierungsregel gilt.

DataMaskingRule

Stellt eine Datenbankdatenformatierungsregel dar.

DataMaskingRuleState

Der Regelzustand. Wird verwendet, um eine Regel zu löschen. Um eine vorhandene Regel zu löschen, geben Sie den schemaName, tableName, columnName, maskingFunction an, und geben Sie "ruleState" als deaktiviert an. Wenn die Regel jedoch noch nicht vorhanden ist, wird die Regel mit "ruleState" erstellt, die aktiviert ist, unabhängig vom bereitgestellten Wert von ruleState.

DataMaskingFunction

Die Maskierungsfunktion, die für die Datenformatierungsregel verwendet wird.

Name Type Description
CCN
  • string
Default
  • string
Email
  • string
Number
  • string
SSN
  • string
Text
  • string

DataMaskingPolicyName

Der Name der Datenbank, für die die Datenformatierungsregel gilt.

Name Type Description
Default
  • string

DataMaskingRule

Stellt eine Datenbankdatenformatierungsregel dar.

Name Type Description
id
  • string

Ressourcen-ID

kind
  • string

Die Art der Datenformatierungsregel. Metadaten, die für Azure-Portal verwendet werden.

location
  • string

Der Speicherort der Datenformatierungsregel.

name
  • string

Name der Ressource.

properties.aliasName
  • string

Der Aliasname. Dies ist ein Legacyparameter und wird nicht mehr verwendet.

properties.columnName
  • string

Der Spaltenname, auf den die Datenformatierungsregel angewendet wird.

properties.id
  • string

Die Regel-ID.

properties.maskingFunction

Die Maskierungsfunktion, die für die Datenformatierungsregel verwendet wird.

properties.numberFrom
  • string

Die NumberFrom-Eigenschaft der Maskierungsregel. Erforderlich, wenn "MaskingFunction" auf "Zahl" festgelegt ist, andernfalls wird dieser Parameter ignoriert.

properties.numberTo
  • string

Die NumberTo-Eigenschaft der Datenformatierungsregel. Erforderlich, wenn "MaskingFunction" auf "Zahl" festgelegt ist, andernfalls wird dieser Parameter ignoriert.

properties.prefixSize
  • string

Wenn "MaskingFunction" auf "Text" festgelegt ist, wird die Anzahl der Zeichen, die am Anfang der Zeichenfolge unmasket angezeigt werden sollen. Andernfalls wird dieser Parameter ignoriert.

properties.replacementString
  • string

Wenn "maskingFunction" auf "Text" festgelegt ist, wird das Zeichen zum Maskieren des nicht exponierten Teils der Zeichenfolge verwendet. Andernfalls wird dieser Parameter ignoriert.

properties.ruleState

Der Regelzustand. Wird verwendet, um eine Regel zu löschen. Um eine vorhandene Regel zu löschen, geben Sie den schemaName, tableName, columnName, maskingFunction an, und geben Sie "ruleState" als deaktiviert an. Wenn die Regel jedoch noch nicht vorhanden ist, wird die Regel mit "ruleState" erstellt, die aktiviert ist, unabhängig vom bereitgestellten Wert von ruleState.

properties.schemaName
  • string

Der Schemaname, auf den die Datenformatierungsregel angewendet wird.

properties.suffixSize
  • string

Wenn "MaskingFunction" auf "Text" festgelegt ist, wird die Anzahl der Zeichen, die am Ende der Zeichenfolge unmasket angezeigt werden sollen. Andernfalls wird dieser Parameter ignoriert.

properties.tableName
  • string

Der Tabellenname, auf den die Datenformatierungsregel angewendet wird.

type
  • string

Der Ressourcentyp.

DataMaskingRuleState

Der Regelzustand. Wird verwendet, um eine Regel zu löschen. Um eine vorhandene Regel zu löschen, geben Sie den schemaName, tableName, columnName, maskingFunction an, und geben Sie "ruleState" als deaktiviert an. Wenn die Regel jedoch noch nicht vorhanden ist, wird die Regel mit "ruleState" erstellt, die aktiviert ist, unabhängig vom bereitgestellten Wert von ruleState.

Name Type Description
Disabled
  • string
Enabled
  • string