Gunakan API AddRecognizeRule untuk menambahkan aturan pengenalan data sensitif - DataWorks - Alibaba Cloud - DataWorks

Menambahkan bidang sensitif yang didefinisikan berdasarkan kategori dan tingkat sensitivitas data di Data Security Guard.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

dataworks:AddRecognizeRule

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
TenantId	string	Yes	ID penyewa. Untuk mendapatkan ID penyewa, lakukan langkah-langkah berikut: Masuk ke konsol DataWorks. Temukan ruang kerja Anda dan buka halaman DataStudio. Pada halaman DataStudio, klik nama pengguna yang sedang login di sudut kanan atas dan klik Info Pengguna di bagian Menu.	10241024
AccountName	string	Yes	Akun Alibaba Cloud yang digunakan untuk membuat aturan identifikasi data sensitif. Masukkan nama pengguna akun Alibaba Cloud.	dsg-uat
SensitiveName	string	Yes	Nama bidang sensitif kustom. Masukkan string yang panjangnya kurang dari 128 karakter.	name
TemplateId	string	Yes	ID template. Anda dapat memanggil operasi QueryDefaultTemplate untuk mendapatkan ID template.	e1970541-6cf5-4d23-b101-d5b66f6e1024
NodeId	string	Yes	ID kategori data. Anda dapat memanggil operasi QuerySensClassification untuk meng-query ID dari semua kategori data. Kemudian, Anda dapat memilih sebuah kategori data untuk membuat bidang sensitif. Masukkan ID dari kategori data yang dipilih.	0ce67949-0810-400f-a24a-cc5ffafe1024
NodeParent	string	Yes	Informasi tentang kategori data induk dari kategori data saat ini. Anda dapat memanggil operasi QuerySensClassification untuk mendapatkan ID kategori data.	Customer/personal/personal_Natural _Information/personal basic_profile_information
Level	string	Yes	Tingkat sensitivitas dari bidang sensitif. Anda dapat memilih salah satu dari semua tingkat sensitivitas yang didefinisikan dalam sebuah template sebagai tingkat sensitivitas bidang sensitif, seperti level 1 hingga level 10.	1
LevelName	string	No	Nama tingkat sensitivitas. Anda dapat memanggil operasi QueryDefaultTemplate untuk mendapatkan nama tingkat sensitivitas dalam template terkait.	Confidential
SensitiveDescription	string	No	Deskripsi dari bidang sensitif. Masukkan string yang panjangnya kurang dari 128 karakter.	This is a sensitive field that identifies the name.
OperationType	integer	Yes	Jenis operasi aritmatika. Nilai yang valid: 0: OR 1: AND	0
RecognizeRulesType	string	No	Jenis aturan identifikasi data sensitif. Nilai yang valid: 1: ekspresi reguler 2: aturan bawaan 3: pustaka sampel 4: model identifikasi data yang dibuat sendiri	1
RecognizeRules	string	No	Konten dari aturan identifikasi data sensitif. Anda dapat memanggil operasi QuerySensNodeInfo untuk meng-query nilai parameter saat ini untuk bidang sensitif bawaan.	{"contentRule":{"_clazz":"com.alipay.dsgclient.sdk.dsg.fastscan.engine.cond.GenderCond"},"_clazz":"com.alipay.dsg.dal.model.RuleContent"}
ContentScan	string	No	Mengidentifikasi konten. Anda dapat memanggil operasi QuerySensNodeInfo untuk meng-query nilai parameter saat ini untuk bidang sensitif bawaan.	{"_clazz":"com.alipay.dsgclient.sdk.dsg.fastscan.engine.cond.NationalityCond"}
HitThreshold	integer	No	Ambang batas rasio hit. Jika lebih dari 60%, yang merupakan ambang batas rasio hit sampel, dari semua catatan data sampel mengenai model Name Entity Recognition (NER), maka bidang sensitif tersebut dianggap hit. Nilai dapat berupa bilangan bulat dari 0 hingga 100.	50
ColScan	string	No	Memindai bidang. Sistem hanya mengidentifikasi bidang yang diberi nilai. Nilai harus dalam format ${Project name}.${Table name}.${Field name} atau ${Project name}.${Schema name}.${Table name}.${Field name}. Wildcard didukung. Misalnya, tanda bintang () pada default.table.column1* dapat digunakan untuk mencocokkan konten apa pun yang mengikuti default.table.column1, seperti default.table.column10.	default.qujian.*
ColExclude	string	No	Mengecualikan bidang. Sistem tidak mengidentifikasi bidang yang diberi nilai. Nilai harus dalam format ${Project name}.${Table name}.${Field name} atau ${Project name}.${Schema name}.${Table name}.${Field name}. Wildcard didukung. Misalnya, tanda bintang () pada default.table.column1* dapat digunakan untuk mencocokkan konten apa pun yang mengikuti default.table.column1, seperti default.table.column10.	default.qujian.*6
CommentScan	string	No	Memindai konten. Nilainya adalah teks dari setiap komentar bidang dalam aset data Anda. Pencocokan fuzzy didukung.	test
Status	integer	No	Status dari bidang sensitif. Nilai yang valid: 0: draf 1: efektif	0

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
Success	boolean	Menunjukkan apakah permintaan berhasil. true false	true
ErrorCode	string	Kode kesalahan.	9990030003
ErrorMessage	string	Pesan kesalahan.	Missing parameter
HttpStatusCode	integer	Kode status HTTP.	200
Data	any	Hasil yang dikembalikan dalam format JSON.	{ "HttpStatusCode": 200, "Success": true }
RequestId	string	ID permintaan.	10000001

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	BADPARAMETERS	Parameters are missing or in the wrong format.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.