Cara mengelola tag hukum
Dalam artikel ini, Anda akan tahu cara mengelola tag hukum di instans Azure Data Manager for Energy Anda. Tag Legal adalah entitas yang mewakili status hukum data dalam instans Azure Data Manager for Energy. Tag legal adalah kumpulan properti yang mengatur bagaimana data dapat diserap dan digunakan. Tag hukum diperlukan agar data diserap ke dalam instans Azure Data Manager for Energy Anda. Ini juga diperlukan untuk konsumsi data dari Instans Azure Data Manager for Energy Anda. Tag hukum didefinisikan pada tingkat partisi data satu per satu.
Sementara di Instans Azure Data Manager for Energy, layanan pemberian hak menentukan akses ke data untuk pengguna tertentu, tag hukum menentukan akses keseluruhan ke data di seluruh pengguna. Pengguna mungkin memiliki akses untuk mengelola data dalam partisi data namun, mereka mungkin tidak dapat melakukannya hingga persyaratan hukum tertentu terpenuhi.
Membuat tag hukum
Jalankan perintah curl di bawah ini di Azure Cloud Bash untuk membuat tag hukum untuk partisi data tertentu dari instans Azure Data Manager for Energy Anda.
curl --location --request POST 'https://<URI>/api/legal/v1/legaltags' \
--header 'data-partition-id: <data-partition-id>' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "<legal-tag-name>",
"description": "<legal-tag-description>",
"properties": {
"contractId": "<contract-id>",
"countryOfOrigin": ["<country-of-origin>"],
"dataType": "<data-type>",
"expirationDate": "<expiration-ID>",
"exportClassification": "<export-classification>",
"originator": "<originator>",
"personalData": "<personal-data>",
"securityClassification": "Public"
}
}'
Permintaan sampel
Pertimbangkan instans Azure Data Manager for Energy bernama "medstest" dengan partisi data bernama "dp1"
curl --location --request POST 'https://medstest.energy.azure.com/api/legal/v1/legaltags' \
--header 'data-partition-id: medstest-dp1' \
--header 'Authorization: Bearer eyxxxxxxx.........................' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "medstest-dp1-legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"contractId": "A1234",
"countryOfOrigin": ["US"],
"dataType": "Public Domain Data",
"expirationDate": "2099-01-25",
"exportClassification": "EAR99",
"originator": "MyCompany",
"personalData": "No Personal Data",
"securityClassification": "Public"
}
}'
Respon sampel
{
"name": "medsStest-dp1-legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"countryOfOrigin": [
"US"
],
"contractId": "A1234",
"expirationDate": "2099-01-25",
"originator": "MyCompany",
"dataType": "Public Domain Data",
"securityClassification": "Public",
"personalData": "No Personal Data",
"exportClassification": "EAR99"
}
}
Negara asal harus mengikuti format ISO Alpha2.
Api Buat Tag Hukum, secara internal menambahkan data-partition-id ke nama tag legal jika belum ada. Misalnya, jika permintaan memiliki nama sebagai: legal-tag, maka nama tag hukum buat akan menjadi <instancename>-<data-partition-id>-legal-tag
curl --location --request POST 'https://medstest.energy.azure.com/api/legal/v1/legaltags' \
--header 'data-partition-id: medstest-dp1' \
--header 'Authorization: Bearer eyxxxxxxx.........................' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"contractId": "A1234",
"countryOfOrigin": ["US"],
"dataType": "Public Domain Data",
"expirationDate": "2099-01-25",
"exportClassification": "EAR99",
"originator": "MyCompany",
"personalData": "No Personal Data",
"securityClassification": "Public"
}
}'
Respons sampel akan memiliki data-partition-id yang ditambahkan ke nama tag hukum dan respons sampel adalah:
{
"name": "medstest-dp1-legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"countryOfOrigin": [
"US"
],
"contractId": "A1234",
"expirationDate": "2099-01-25",
"originator": "MyCompany",
"dataType": "Public Domain Data",
"securityClassification": "Public",
"personalData": "No Personal Data",
"exportClassification": "EAR99"
}
}
Mendapatkan tag hukum
Jalankan perintah curl di bawah ini di Azure Cloud Bash untuk mendapatkan tag hukum yang terkait dengan partisi data instans Azure Data Manager for Energy Anda.
curl --location --request GET 'https://<URI>/api/legal/v1/legaltags/<legal-tag-name>' \
--header 'data-partition-id: <data-partition-id>' \
--header 'Authorization: Bearer <access_token>'
Permintaan sampel
Pertimbangkan instans Azure Data Manager for Energy bernama "medstest" dengan partisi data bernama "dp1"
curl --location --request GET 'https://medstest.energy.azure.com/api/legal/v1/legaltags/medstest-dp1-legal-tag' \
--header 'data-partition-id: medstest-dp1' \
--header 'Authorization: Bearer eyxxxxxxx.........................'
Respon sampel
{
"name": "medstest-dp1-legal-tag",
"description": "Azure Data Manager for Energy Legal Tag",
"properties": {
"countryOfOrigin": [
"US"
],
"contractId": "A1234",
"expirationDate": "2099-01-25",
"originator": "MyCompany",
"dataType": "Public Domain Data",
"securityClassification": "Public",
"personalData": "No Personal Data",
"exportClassification": "EAR99"
}
}