你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Data Masking Rules - List By Database

参考

服务:: SQL Database

API 版本:: 2023-08-01

获取数据库数据掩码规则的列表。

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

URI 参数

名称	在	必需	类型	说明
databaseName	path	True	string	数据库的名称。
dataMaskingPolicyName	path	True	DataMaskingPolicyName	应用数据掩码规则的数据库的名称。
resourceGroupName	path	True	string	包含资源的资源组的名称。可以从 Azure 资源管理器 API 或门户获取此值。
serverName	path	True	string	服务器的名称。
subscriptionId	path	True	string	标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。

响应

名称	类型	说明
200 OK	DataMaskingRuleListResult	已成功检索服务器的高级威胁防护状态列表。
Other Status Codes	ErrorResponse	错误响应： ***

示例

Gets a list of database data masking rules.

示例请求

HTTP

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

示例响应

状态代码:: 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
      }
    }
  ]
}

定义

名称	说明
DataMaskingFunction	用于数据掩码规则的掩码函数。
DataMaskingPolicyName	应用数据掩码规则的数据库的名称。
DataMaskingRule	数据库数据掩码规则。
DataMaskingRuleListResult	数据库数据掩码规则的列表。
DataMaskingRuleState	规则状态。用于删除规则。若要删除现有规则，请指定 schemaName、tableName、columnName、maskingFunction，并将 ruleState 指定为已禁用。但是，如果规则尚不存在，则将创建规则，并将 ruleState 设置为启用，而不考虑 ruleState 提供的值。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应

DataMaskingFunction

枚举

用于数据掩码规则的掩码函数。

值	说明
CCN
Default
Email
Number
SSN
Text

DataMaskingPolicyName

枚举

应用数据掩码规则的数据库的名称。

值	说明
Default

DataMaskingRule

Object

数据库数据掩码规则。

名称	类型	说明
id	string	资源 ID。
kind	string	数据掩码规则的类型。用于 Azure 门户的元数据。
location	string	数据掩码规则的位置。
name	string	资源名称。
properties.aliasName	string	别名。这是一个旧参数，不再使用。
properties.columnName	string	应用数据掩码规则的列名。
properties.id	string	规则 ID。
properties.maskingFunction	DataMaskingFunction	用于数据掩码规则的掩码函数。
properties.numberFrom	string	掩码规则的 numberFrom 属性。如果 maskingFunction 设置为 Number，则是必需的，否则将忽略此参数。
properties.numberTo	string	数据掩码规则的 numberTo 属性。如果 maskingFunction 设置为 Number，则是必需的，否则将忽略此参数。
properties.prefixSize	string	如果 maskingFunction 设置为 Text，则表示在字符串开头未屏蔽的字符数。否则，将忽略此参数。
properties.replacementString	string	如果 maskingFunction 设置为 Text，则用于屏蔽字符串未公开部分的字符。否则，将忽略此参数。
properties.ruleState	DataMaskingRuleState	规则状态。用于删除规则。若要删除现有规则，请指定 schemaName、tableName、columnName、maskingFunction，并将 ruleState 指定为已禁用。但是，如果规则尚不存在，则将创建规则，并将 ruleState 设置为启用，而不考虑 ruleState 提供的值。
properties.schemaName	string	应用数据掩码规则的架构名称。
properties.suffixSize	string	如果 maskingFunction 设置为 Text，则表示在字符串末尾取消屏蔽的字符数。否则，将忽略此参数。
properties.tableName	string	应用数据掩码规则的表名。
type	string	资源类型。

DataMaskingRuleListResult

Object

数据库数据掩码规则的列表。

名称	类型	说明
nextLink	string	用于检索下一页结果的链接。
value	DataMaskingRule[]	结果数组。

DataMaskingRuleState

枚举

规则状态。用于删除规则。若要删除现有规则，请指定 schemaName、tableName、columnName、maskingFunction，并将 ruleState 指定为已禁用。但是，如果规则尚不存在，则将创建规则，并将 ruleState 设置为启用，而不考虑 ruleState 提供的值。

值	说明
Disabled
Enabled

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

通过

Data Masking Rules - List By Database

URI 参数

响应

示例

Gets a list of database data masking rules.

示例请求

示例响应

定义

DataMaskingFunction

DataMaskingPolicyName

DataMaskingRule

DataMaskingRuleListResult

DataMaskingRuleState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

其他资源