Cara mengelola tag hukum

Dalam artikel ini, Anda akan mengetahui apa itu tag hukum dan cara mengelolanya di instans Azure Data Manager for Energy Anda.

Tag hukum adalah entitas yang mewakili status hukum penyerapan data dan layanan pemberian hak menentukan akses pengguna ke data. Pengguna mungkin memiliki akses untuk mengelola data menggunakan hak tetapi perlu memenuhi persyaratan hukum tertentu menggunakan tag hukum. Tag hukum adalah kumpulan properti yang diperlukan yang mengatur bagaimana data dapat diserap ke dalam instans Azure Data Manager for Energy Anda.

Instans Azure Data Manager for Energy memungkinkan pembuatan tag hukum hanya untuk countryOfOrigin yang diizinkan sesuai file konfigurasi DefaultCountryCodes.json pada tingkat partisi data. OSDU telah menentukan file ini dan Anda tidak dapat mengeditnya.

Membuat tag hukum

Jalankan perintah curl 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/wilayah asal harus mengikuti format ISO Alpha2.

API ini 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 adalah <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 telah data-partition-id ditambahkan ke nama tag hukum.

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

Langkah berikutnya