Otomatiskan Aturan Desensitisasi Data melalui API - DataWorks - Alibaba Cloud - DataWorks

Panggil API `DsgDesensPlanAddOrUpdate` untuk membuat atau mengedit aturan penyamaran data.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
DesensRules	array<object>	Yes	Koleksi aturan penyamaran data yang akan ditambahkan atau diperbarui.
	array<object>	No	Konfigurasi aturan penyamaran data.
Id	integer	No	ID aturan penyamaran data. Anda dapat memanggil operasi DsgDesensPlanQueryList untuk memperolehnya.	123
DataType	string	No	Jenis data sensitif.	phone
RuleName	string	Yes	Nama aturan penyamaran data.	phone_hash
Status	integer	No	Status aturan penyamaran data. Nilai yang valid: 0: Dinonaktifkan 1: Diaktifkan	1
SceneIds	array	Yes	Skenario penyamaran data sekunder.
	integer	No	ID skenario penyamaran data sekunder. Skenario ini tidak boleh memiliki aturan penyamaran data yang ada untuk jenis data sensitif yang ditentukan oleh parameter DataType. Untuk menemukan ID skenario, panggil operasi DsgSceneQuerySceneListByName.	123
Owner	string	Yes	Pemilik aturan penyamaran data.	test_user
CheckWatermark	boolean	No	Menentukan apakah akan menambahkan tanda air. Nilai yang valid: true: Menambahkan tanda air. false: Tidak menambahkan tanda air.	true
DesensPlan	object	Yes	Konfigurasi metode penyamaran data.
DesensPlanType	string	Yes	Metode penyamaran data. Nilai yang valid: hash: hashing mapping: pseudonimisasi mask: penyamaran charreplacement: penggantian karakter intervalselect: transformasi interval decimalpoint: pembulatan emptydesens: nullifikasi	hash
ExtParam	object	No	Parameter untuk metode penyamaran data.
	any	No	Parameter untuk metode penyamaran data yang dipilih. Parameter yang diperlukan bergantung pada nilai parameter DesensPlanType. Lihat contoh permintaan untuk detailnya.	{ "algo": "MD5", "salt":6 }
emptyNotDesens	boolean	No
columns	array<object>	No	Kolom terkait untuk penyamaran.
	object	No	Informasi tentang kolom.
dbType	string	Yes	Jenis sumber data.	ODPS.ODPS
project	string	Yes	Nama ruang kerja DataWorks.	test_dev
table	string	Yes	Nama tabel.	test_table_dev
column	string	Yes	Nama kolom.	test_col_dev

ExtParam adalah parameter dinamis. Konfigurasinya bergantung pada aturan penyamaran. Lihat contoh konfigurasi berikut:

Hash:
{
    "algo": "MD5",
    "salt": 6
}
Pseudonimisasi:
{
    "charset": "Aa",
    "salt": 6
}
Penyamaran:
{
    "before": 3,
    "after": 4
}
Penyamaran kustom:
{
    "separatorList": [
        {
            "desens": true,
            "left": 3
        },
        {
            "desens": false,
            "left": 6
        },
        {
            "desens": true,
            "left": -99
        }
    ]
}
Contoh penggantian karakter:
{
    "library": "test_library",
    "position": 3
}
Penggantian karakter tetap:
{
    "replace": "repData",
    "position": 3
}
Penggantian karakter acak:
{
    "replace": "repData"
}
Penggantian karakter kustom:
{
    "separatorList": [
        {
            "desensParam": {
                "replace": "repData"
            },
            "left": 3
        },
        {
            "desensParam": {
                "library": "test_library"
            },
            "left": 6
        },
        {
            "desensParam": {
            },
            "left": 99
        }
    ]
}
Transformasi interval:
{
    "intervalselects": [
        {
            "desens": "1",
            "interval": [
                "1",
                "100"
            ]
        }
    ]
}
Pembulatan:
{
"point":3
}
Nullifikasi:
{}

Untuk detail tentang metode penyamaran yang didukung dan aturannya, lihat API DsgQueryDefaultTemplates.

Elemen respons

Element	Type	Description	Example
	object	OpenApiResultModel
Success	boolean	Menunjukkan apakah permintaan berhasil. Nilai `true` menunjukkan bahwa permintaan berhasil. Nilai `false` menunjukkan bahwa permintaan gagal.	true
ErrorCode	string	Kode kesalahan.	1029030003
ErrorMessage	string	Pesan kesalahan.	param error
HttpStatusCode	integer	Kode status HTTP.	400
Data	boolean	Menunjukkan apakah operasi penambahan atau pembaruan berhasil.	true
RequestId	string	ID permintaan. Anda dapat menggunakan ID untuk melacak log dan memecahkan masalah.	102400001

Contoh

Respons sukses

JSONformat

{
  "Success": true,
  "ErrorCode": "1029030003",
  "ErrorMessage": "param error",
  "HttpStatusCode": 400,
  "Data": true,
  "RequestId": "102400001"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	PARAMS.ERROR	param error.
400	DESENSPLAN.DATATYPE.ERROR	Sensitive type already has a desensitization rule.
400	DESENSPLAN.DATATYPENOTEXIST.ERROR	Sensitive type not exist.
400	DESENSPLAN.ID.ERROR	Desensitization rule ID does not exist.
400	DESENSPLAN.PAGESIZE.ERROR	Page size is too large, maximum of 100.
400	DESENSPLAN.PARAM.ERROR	Desensitization rule parameter error.
400	DESENSPLAN.SCENECODE.ERROR	Scene code does not exist.
400	DESENSPLAN.SCENEID.ERROR	Scene ID does not exist.
400	DESENSPLAN.SCENEIDLEVEL.ERROR	The scene is not a secondary scene.
400	DESENSPLAN.SIZE.ERROR	The number of desens plan exceeds the limit.
500	UNKNOWN.ERROR	unknown error.
403	PERMISSION.DENIED.ERROR	Permission denied

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.