全部產品
Search
文件中心

DataWorks:AddRecognizeRule - 新增分類分級定義的敏感欄位

更新時間:Mar 21, 2026

調用AddRecognizeRule介面新增資料保護傘分類分級定義的敏感欄位。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:AddRecognizeRule

create

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

TenantId

string

租戶 ID。您可登入 DataWorks 控制台,進入資料開發(DataStudio)頁面,單擊右上方當前登入使用者名稱稱,選擇菜單 > 使用者資訊,擷取租戶 ID。

10241024

AccountName

string

建立敏感性資料識別規則的阿里雲使用者。此處填寫使用者名稱稱。

dsg-uat

SensitiveName

string

自訂的敏感欄位名稱。輸入長度小於 128 的字串。

name

TemplateId

string

模板 ID。調用 QueryDefaultTemplate 介面擷取當前預設的模板 ID。

e1970541-6cf5-4d23-b101-****

NodeId

string

分類結點 ID。可調用 QuerySensClassification 介面擷取所有結點 ID,選擇一個結點建立敏感欄位。此處輸入所選的結點 ID。

0ce67949-0810-400f-a24a-****

NodeParent

string

分類結點的父結點資訊。可調用 QuerySensClassification 介面擷取。

Customer/personal/personal_Natural _Information/personal basic_profile_information

Level

string

敏感欄位分級。根據模板定義的分級資訊,選擇其中一級作為新增敏感欄位的等級。例如 1~10 級。

1

LevelName

string

分級名稱。可調用 QueryDefaultTemplate 介面,擷取所選分級在模板中對應的分級名稱。

Confidential

SensitiveDescription

string

敏感欄位描述。長度小於 128 的字串。

This is a sensitive field that identifies the name.

OperationType

integer

運算類型。取值如下:

  • 0:或

  • 1:與

0

RecognizeRulesType

string

敏感性資料識別規則類型:

  • 1:Regex。

  • 2:內建規則。

  • 3:樣本庫。

  • 4:自產生模型。

1

RecognizeRules

string

敏感性資料識別規則內容。可調用 QuerySensNodeInfo 介面,參考內建規則同欄位的配置。

{"contentRule":{"_clazz":"com.alipay.dsgclient.sdk.dsg.fastscan.engine.cond.GenderCond"},"_clazz":"com.alipay.dsg.dal.model.RuleContent"}

ContentScan

string

內容識別。可通過調用 QuerySensNodeInfo 介面,參考內建規則的同欄位配置。

{"_clazz":"com.alipay.dsgclient.sdk.dsg.fastscan.engine.cond.NationalityCond"}

HitThreshold

integer

命中閾值。若抽樣資料中,超過閾值百分比(例如,60%)的資料命中 NER 模型,則認為命中該敏感欄位。取值:0~100 之間的整數。

50

ColScan

string

欄位掃描,僅識別賦值的欄位。

  • 取值格式:${專案空間}.${表名}.${欄位名}或${專案空間}.${SCHEMA}.${表名}.${欄位名}。

  • 支援萬用字元,如 default.table.column1可以匹配 default.table.column10 等*後面的任意內容。

default.qujian.*

ColExclude

string

欄位排除,即不識別賦值的欄位。

  • 取值格式:${專案空間}.${表名}.${欄位名}或${專案空間}.${SCHEMA}.${表名}.${欄位名}。

  • 支援萬用字元,如 default.table.column1可以匹配 default.table.column10 等*後面的任意內容。

default.qujian.*6

CommentScan

string

內容掃描。取值為您的資料資產中每個欄位注釋資訊的文本,支援模糊比對。

test

Status

integer

敏感欄位的生效狀態。取值如下:

  • 0:草稿。

  • 1:生效。

0

返回參數

名稱

類型

描述

樣本值

object

返回資料。

Success

boolean

調用是否成功。

  • true:成功。

  • false:失敗。

true

ErrorCode

string

錯誤碼。

9990030003

ErrorMessage

string

錯誤資訊。

Missing parameter

HttpStatusCode

integer

HTTP 狀態代碼。

200

Data

any

返回結果,JSON 格式資料。

{ "HttpStatusCode": 200, "Success": true }

RequestId

string

請求 ID,一次請求的唯一標識。

10000001

樣本

正常返回樣本

JSON格式

{
  "Success": true,
  "ErrorCode": "9990030003",
  "ErrorMessage": "Missing parameter",
  "HttpStatusCode": 200,
  "Data": "{   \"HttpStatusCode\": 200,   \"Success\": true }",
  "RequestId": "10000001"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 BADPARAMETERS Parameters are missing or in the wrong format.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情