Data Masking Rules - Create Or Update
Membuat atau memperbarui aturan penyamaran data database.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default/rules/{dataMaskingRuleName}?api-version=2025-01-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
database
|
path | True |
string |
Nama database. |
|
data
|
path | True |
Nama database tempat kebijakan penyamaran data berlaku. |
|
|
data
|
path | True |
string |
Nama aturan penyamaran data. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
server
|
path | True |
string |
Nama server. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
Isi Permintaan
| Nama | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|
| properties.columnName | True |
string |
Nama kolom tempat aturan masking data diterapkan. |
| properties.maskingFunction | True |
Fungsi masking yang digunakan untuk aturan masking data. |
|
| properties.schemaName | True |
string |
Nama skema tempat aturan masking data diterapkan. |
| properties.tableName | True |
string |
Nama tabel tempat aturan masking data diterapkan. |
| properties.aliasName |
string |
Nama alias. Ini adalah parameter warisan dan tidak lagi digunakan. |
|
| properties.numberFrom |
string |
Properti numberFrom dari aturan masking. Diperlukan jika maskingFunction diatur ke Angka, jika tidak, parameter ini akan diabaikan. |
|
| properties.numberTo |
string |
Properti numberTo dari aturan masking data. Diperlukan jika maskingFunction diatur ke Angka, jika tidak, parameter ini akan diabaikan. |
|
| properties.prefixSize |
string |
Jika maskingFunction diatur ke Teks, jumlah karakter untuk ditampilkan tanpa kemasan di awal string. Jika tidak, parameter ini akan diabaikan. |
|
| properties.replacementString |
string |
Jika maskingFunction diatur ke Teks, karakter yang akan digunakan untuk menutupi bagian untai (karakter) yang tidak diekspos. Jika tidak, parameter ini akan diabaikan. |
|
| properties.ruleState |
Status aturan. Digunakan untuk menghapus aturan. Untuk menghapus aturan yang ada, tentukan schemaName, tableName, columnName, maskingFunction, dan tentukan ruleState sebagai dinonaktifkan. Namun, jika aturan belum ada, aturan akan dibuat dengan seperangkat ruleState untuk diaktifkan, terlepas dari nilai ruleState yang disediakan. |
||
| properties.suffixSize |
string |
Jika maskingFunction diatur ke Teks, jumlah karakter untuk ditampilkan tanpa kemasan di akhir string. Jika tidak, parameter ini akan diabaikan. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi Azure berhasil diselesaikan. |
|
| 201 Created |
Resource 'DataMaskingRule' membuat operasi berhasil |
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
| Create/Update data masking rule for default max. |
| Create/Update data masking rule for default min. |
| Create/Update data masking rule for numbers. |
| Create/Update data masking rule for text. |
Create/Update data masking rule for default max.
Permintaan sampel
PUT 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/rule1?api-version=2025-01-01
{
"properties": {
"aliasName": "nickname",
"columnName": "test1",
"maskingFunction": "Default",
"ruleState": "Enabled",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Respon sampel
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": "nickname",
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": "nickname",
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
Create/Update data masking rule for default min.
Permintaan sampel
PUT 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/rule1?api-version=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Default",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Respon sampel
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Default",
"numberFrom": null,
"numberTo": null,
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
Create/Update data masking rule for numbers.
Permintaan sampel
PUT 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/rule1?api-version=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Number",
"numberFrom": "0",
"numberTo": "2",
"schemaName": "dbo",
"tableName": "Table_1"
}
}
Respon sampel
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Number",
"numberFrom": "0",
"numberTo": "2",
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Number",
"numberFrom": "0",
"numberTo": "2",
"prefixSize": null,
"replacementString": null,
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": null,
"tableName": "Table_1"
}
}
Create/Update data masking rule for text.
Permintaan sampel
PUT 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/rule1?api-version=2025-01-01
{
"properties": {
"columnName": "test1",
"maskingFunction": "Text",
"prefixSize": "1",
"replacementString": "asdf",
"schemaName": "dbo",
"suffixSize": "0",
"tableName": "Table_1"
}
}
Respon sampel
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Text",
"numberFrom": null,
"numberTo": null,
"prefixSize": "1",
"replacementString": "asdf",
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": "0",
"tableName": "Table_1"
}
}
{
"name": null,
"type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
"kind": null,
"location": "Central US",
"properties": {
"aliasName": null,
"columnName": "test1",
"id": "dbo_Table_1_test1",
"maskingFunction": "Text",
"numberFrom": null,
"numberTo": null,
"prefixSize": "1",
"replacementString": "asdf",
"ruleState": "Enabled",
"schemaName": "dbo",
"suffixSize": "0",
"tableName": "Table_1"
}
}
Definisi
| Nama | Deskripsi |
|---|---|
|
created |
Jenis identitas yang membuat sumber daya. |
|
Data |
Fungsi masking yang digunakan untuk aturan masking data. |
|
Data |
|
|
Data |
Aturan penyamaran data database. |
|
Data |
Status aturan. Digunakan untuk menghapus aturan. Untuk menghapus aturan yang ada, tentukan schemaName, tableName, columnName, maskingFunction, dan tentukan ruleState sebagai dinonaktifkan. Namun, jika aturan belum ada, aturan akan dibuat dengan seperangkat ruleState untuk diaktifkan, terlepas dari nilai ruleState yang disediakan. |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
|
Error |
Detail kesalahan. |
|
Error |
Tanggapan kesalahan |
|
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
createdByType
Jenis identitas yang membuat sumber daya.
| Nilai | Deskripsi |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataMaskingFunction
Fungsi masking yang digunakan untuk aturan masking data.
| Nilai | Deskripsi |
|---|---|
| Default |
Default |
| CCN |
CCN |
|
|
|
| Number |
Angka |
| SSN |
Nomor Jaminan Sosial |
| Text |
Teks |
DataMaskingPolicyName
| Nilai | Deskripsi |
|---|---|
| Default |
Default |
DataMaskingRule
Aturan penyamaran data database.
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string (arm-id) |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| kind |
string |
Jenis Aturan Penyamaran Data. Metadata, digunakan untuk portal Azure. |
| location |
string |
Lokasi aturan penyamaran data. |
| name |
string |
Nama sumber daya |
| properties.aliasName |
string |
Nama alias. Ini adalah parameter warisan dan tidak lagi digunakan. |
| properties.columnName |
string |
Nama kolom tempat aturan masking data diterapkan. |
| properties.id |
string |
Aturan Id. |
| properties.maskingFunction |
Fungsi masking yang digunakan untuk aturan masking data. |
|
| properties.numberFrom |
string |
Properti numberFrom dari aturan masking. Diperlukan jika maskingFunction diatur ke Angka, jika tidak, parameter ini akan diabaikan. |
| properties.numberTo |
string |
Properti numberTo dari aturan masking data. Diperlukan jika maskingFunction diatur ke Angka, jika tidak, parameter ini akan diabaikan. |
| properties.prefixSize |
string |
Jika maskingFunction diatur ke Teks, jumlah karakter untuk ditampilkan tanpa kemasan di awal string. Jika tidak, parameter ini akan diabaikan. |
| properties.replacementString |
string |
Jika maskingFunction diatur ke Teks, karakter yang akan digunakan untuk menutupi bagian untai (karakter) yang tidak diekspos. Jika tidak, parameter ini akan diabaikan. |
| properties.ruleState |
Status aturan. Digunakan untuk menghapus aturan. Untuk menghapus aturan yang ada, tentukan schemaName, tableName, columnName, maskingFunction, dan tentukan ruleState sebagai dinonaktifkan. Namun, jika aturan belum ada, aturan akan dibuat dengan seperangkat ruleState untuk diaktifkan, terlepas dari nilai ruleState yang disediakan. |
|
| properties.schemaName |
string |
Nama skema tempat aturan masking data diterapkan. |
| properties.suffixSize |
string |
Jika maskingFunction diatur ke Teks, jumlah karakter untuk ditampilkan tanpa kemasan di akhir string. Jika tidak, parameter ini akan diabaikan. |
| properties.tableName |
string |
Nama tabel tempat aturan masking data diterapkan. |
| systemData |
Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy. |
|
| type |
string |
Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan" |
DataMaskingRuleState
Status aturan. Digunakan untuk menghapus aturan. Untuk menghapus aturan yang ada, tentukan schemaName, tableName, columnName, maskingFunction, dan tentukan ruleState sebagai dinonaktifkan. Namun, jika aturan belum ada, aturan akan dibuat dengan seperangkat ruleState untuk diaktifkan, terlepas dari nilai ruleState yang disediakan.
| Nilai | Deskripsi |
|---|---|
| Enabled |
Enabled |
| Disabled |
Nonaktif |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| info |
object |
Info tambahan. |
| type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| additionalInfo |
Info tambahan kesalahan. |
|
| code |
string |
Kode kesalahan. |
| details |
Rincian kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Sasaran kesalahan. |
ErrorResponse
Tanggapan kesalahan
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Objek kesalahan. |
systemData
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| createdAt |
string (date-time) |
Tanda waktu pembuatan sumber daya (UTC). |
| createdBy |
string |
Identitas yang membuat sumber daya. |
| createdByType |
Jenis identitas yang membuat sumber daya. |
|
| lastModifiedAt |
string (date-time) |
Stempel waktu modifikasi terakhir sumber daya (UTC) |
| lastModifiedBy |
string |
Identitas yang terakhir mengubah sumber daya. |
| lastModifiedByType |
Jenis identitas yang terakhir memodifikasi sumber daya. |