مشاركة عبر

كيفية إدارة العلامات القانونية

  • مقالة

في هذه المقالة، ستعرف ما هي العلامات القانونية وكيفية إدارتها في Azure Data Manager لمثيل الطاقة.

العلامة القانونية هي الكيان الذي يمثل الحالة القانونية لخدمة استيعاب البيانات والاستحقاق تحدد وصول المستخدم إلى البيانات. قد يكون لدى المستخدم حق الوصول لإدارة البيانات باستخدام الاستحقاقات ولكنه يحتاج إلى استيفاء متطلبات قانونية معينة باستخدام العلامات القانونية. العلامة القانونية هي مجموعة من الخصائص المطلوبة التي تحكم كيفية استيعاب البيانات في Azure Data Manager لمثيل الطاقة.

يسمح Azure Data Manager لمثيل الطاقة بإنشاء علامات قانونية فقط لتلك countryOfOrigin المسموح بها وفقا لملف التكوين DefaultCountryCodes.json على مستوى قسم البيانات. قامت OSDU بتعريف هذا الملف ولا يمكنك تحريره.

قم بتشغيل الأمر curl في Azure Cloud Bash لإنشاء علامة قانونية لقسم بيانات معين من Azure Data Manager لمثيل الطاقة.

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

نموذج الطلب

خذ بعين الاعتبار Azure Data Manager لمثيل الطاقة المسمى medstest بقسم بيانات يسمى "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"
        }
    }'

استجابة العينة

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

يجب أن يتبع بلد المنشأ تنسيق ISO Alpha2.

تلحق واجهة برمجة التطبيقات هذه داخليا باسم العلامة data-partition-id القانونية إذا لم تكن موجودة بالفعل. على سبيل المثال، إذا كان الطلب له اسم كما يلي: legal-tag، فسيكون <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"
        }
    }'

تم data-partition-id إلحاق نموذج الاستجابة باسم العلامة القانونية.

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

قم بتشغيل الأمر curl في Azure Cloud Bash للحصول على العلامة القانونية المقترنة بقسم بيانات Azure Data Manager لمثيل الطاقة.

    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>'

نموذج الطلب

خذ بعين الاعتبار Azure Data Manager لمثيل الطاقة المسمى medstest بقسم بيانات يسمى "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.........................'

استجابة العينة

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

الخطوات التالية

كيفية إضافة المزيد من أقسام البيانات