全部產品
Search
文件中心

DataWorks:EditRecognizeRule

更新時間:Oct 09, 2026

呼叫 EditRecognizeRule 介面編輯資料保護傘分類分級定義的敏感欄位。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:EditRecognizeRule

update

*全部資源。

*

無 無

請求參數

名稱

類型

必填

描述

樣本值

TenantId

string

是

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

102410000

AccountName

string

是

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

dsg-uat

SensitiveId

string

是

敏感欄位 ID。可呼叫 QuerySensNodeInfo 介面取得全量敏感欄位 ID,或呼叫 QueryRecognizeRuleDetail 介面查詢特定敏感欄位 ID。

1a928de7-3962-4e07-93ac-e1973baa1024

SensitiveName

string

是

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

name

NodeId

string

是

分類節點 ID。可呼叫 QuerySensClassification 介面取得所有節點 ID,選擇一個節點建立敏感欄位。此處輸入所選的節點 ID。

0ce67949-0810-400f-a24a-cc5ffafe1024

NodeParent

string

是

分類節點的父節點資訊。可呼叫 QuerySensClassification 介面取得。

Customer/personal/personal_Natural_Information/personal_basic_profile_information

TemplateId

string

是

範本 ID。呼叫 QueryDefaultTemplate 介面取得目前預設的範本 ID。

e1970541-6cf5-4d23-b101-d5b66f6e1024

level

string

是

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

1

LevelName

string

否

分級名稱。可呼叫 QueryDefaultTemplate 介面,取得所選分級在範本中對應的分級名稱。 注意:目前服務實際要求提供此參數;省略時回傳 400(InternalError.Bad.Parameters:levelName not empty)。

Confidential

SensitiveDescription

string

否

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

This is a sensitive field that identifies the name.

Status

integer

否

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

  • 0:草稿。

  • 1:生效。

0

OperationType

integer

是

運算類型。取值如下:

  • 0:或

  • 1:與

0

RecognizeRulesType

string

否

敏感資料識別規則類型:

  • 1:正規表示式。

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

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

HitThreshold

integer

否

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

50

返回參數

名稱

類型

描述

樣本值

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.

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

變更歷史

更多資訊,參考變更詳情。