البرنامج التعليمي: العمل مع سجلات بيانات البئر باستخدام واجهات برمجة تطبيقات Wellbore DDMS

استخدم واجهات برمجة تطبيقات Wellbore Domain Data Management Services (DDMS) للعمل مع بيانات البئر في مثيل Azure Data Manager for Energy.

في هذا البرنامج التعليمي، تتعلم كيفية:

  • استخدم واجهات برمجة تطبيقات Wellbore DDMS للعمل مع سجلات بيانات البئر.

لمزيد من المعلومات حول DDMS، راجع مفاهيم DDMS.

Prerequisites

الحصول على تفاصيل Azure Data Manager لمثيل الطاقة

لهذا البرنامج التعليمي، تحتاج إلى المعلمات التالية:

Parameter القيمة المراد استخدامها Example مكان العثور على هذه القيمة
DNS URI <instance>.energy.azure.com ابحث عن هذه القيمة في صفحة النظرة العامة لمثيل Azure Data Manager for Energy.
data-partition-id Data partition <data-partition-id> ابحث عن هذه القيمة في قسم قسم البيانات داخل مثيل Azure Data Manager for Energy.
access_token قيمة الرمز المميز للوصول 0.ATcA01-XWHdJ0ES-qDevC6r........... اتبع كيفية إنشاء رمز المصادقة لإنشاء رمز مميز للوصول وحفظه.

اتبع دليل إدارة المستخدمين لإضافة الاستحقاقات المناسبة للمستخدم الذي يقوم بتشغيل هذا البرنامج التعليمي.

إعداد بيئتك

تأكد من تثبيت cURL النظام الخاص بك لإجراء استدعاءات واجهة برمجة التطبيقات.

استخدم واجهات برمجة تطبيقات Wellbore DDMS للعمل مع سجلات بيانات الآبار

يشير إكمال طلبات cURL الموضحة في واجهات برمجة تطبيقات DDMS التالية بنجاح إلى استيعاب واسترداد سجلات البئر بنجاح في مثيل Azure Data Manager for Energy. إذا كنت مهتما بالتحقق من جميع واجهات برمجة التطبيقات ، فيمكنك التحقق من Swagger الخاص بنا

إنشاء علامة قانونية للامتثال للبيانات.

قم بتشغيل الأمر التالي cURL لإنشاء علامة قانونية:

curl -X POST "https://<DNS>/api/legal/v1/legaltags" \
     -H "Authorization: Bearer <access_token>" \
     -H "Content-Type: application/json" \
     -H "data-partition-id: <data-partition-id>" \
     -d '{
           "name": "LegalTagName",
           "description": "Legal Tag added for Well",
           "properties": {
               "contractId": "123456",
               "countryOfOrigin": ["US", "CA"],
               "dataType": "Third Party Data",
               "exportClassification": "EAR99",
               "originator": "xyz",
               "personalData": "No Personal Data",
               "securityClassification": "Private",
               "expirationDate": "2025-12-25"
           }
       }'

Sample Response:

{
  "name": "LegalTagName",
  "status": "Created"
}

لمزيد من المعلومات، راجع إدارة العلامات القانونية.

إنشاء سجل جيد

إنشاء سجل جيد في Azure Data Manager لمثيل الطاقة.

أسلوب: POST

curl -X POST "https://<DNS>/api/os-wellbore-ddms/ddms/v3/wells/<well_id>" \
   -H "Authorization: Bearer <access_token>" \
   -H "data-partition-id: <data-partition-id>" \
   -H "Content-Type: application/json" \
   -d '[
         {
            "acl": {
               "owners": [
               "data.default.owners@{{entitlement_domain}}"
               ],
               "viewers": [
               "data.default.viewers@{{entitlement_domain}}"
               ]
            },
            "data": {
               "ExtensionProperties": {},
               "FacilityName": "{{wellbore_well_name}}",
               "FacilityNameAliases": [
               {
                  "AliasName": "20-000-00000-00",
                  "AliasNameTypeID": "{{DATA_PARTITION_ID}}:reference-data--AliasNameType:UniqueIdentifier:"
               }
               ]
            },
            "id": "{{DATA_PARTITION_ID}}:master-data--Well:{{wellbore_well_id}}",
            "kind": "osdu:wks:master-data--Well:1.1.0",
            "legal": {
               "legaltags": [
               "{{legal_dafault_tag}}"
               ],
               "otherRelevantDataCountries": [
               "FR",
               "US"
               ],
               "status": "compliant"
            }
         }
   ]'

Sample Response:

{
  "recordCount": 1,
  "recordIdVersions": [
    "opendes:master-data--Well:122:1753292228903506"
  ],
  "recordIds": [
    "opendes:master-data--Well:122"
  ],
  "skippedRecordIds": []
}

احصل على سجل جيد

احصل على بيانات سجل البئر لمثيل Azure Data Manager for Energy.

أسلوب: GET

curl -X GET "https://<DNS>/api/os-wellbore-ddms/ddms/v3/wells/<well_id>" \
   -H "Authorization: Bearer <access_token>" \
   -H "data-partition-id: <data-partition-id>" \
   -H 'accept: application/json'

Sample Response:

{
  "id": "opendes:master-data--Well:122",
  "version": 1753292228903506,
  "kind": "osdu:wks:master-data--Well:1.1.0",
  "acl": {
    "viewers": [
      "data.default.viewers@opendes.dataservices.energy"
    ],
    "owners": [
      "data.default.owners@opendes.dataservices.energy"
    ]
  },
  "legal": {
    "legaltags": [
      "opendes-welltesttag"
    ],
    "otherRelevantDataCountries": [
      "FR",
      "US"
    ]
  },
  "meta": null,
  "data": {
    "ExtensionProperties": {},
    "FacilityName": "opendes:master-data--Well:123",
    "FacilityNameAliases": [
      {
        "AliasName": "20-000-00000-00",
        "AliasNameTypeID": "opendes:reference-data--AliasNameType:UniqueIdentifier:"
      }
    ]
  },
  "createTime": "2025-07-23T17:37:09.290000+00:00",
  "createUser": "3046ab2b-b04c-4933-8afd-***********"
}

احصل على إصدارات جيدة

احصل على إصدارات كل سجل بئر تم استيعابه في مثيل Azure Data Manager for Energy.

أسلوب: GET

curl -X GET "https://<DNS>/api/os-wellbore-ddms/ddms/v3/wells/<well_id>/versions" \
   -H "Authorization: Bearer <access_token>" \
   -H "data-partition-id: <data-partition-id>" \
   -H 'accept: application/json' \

Sample Response:

{
  "recordId": "opendes:master-data--Well:122",
  "versions": [
    1753292228903506
  ]
}

احصل على إصدار بئر محدد

احصل على تفاصيل إصدار معين لسجل بئر معين في مثيل Azure Data Manager for Energy.

أسلوب: GET

curl -X GET "https://<DNS>/api/os-wellbore-ddms/ddms/v3/wells/<well_id>/versions/<version>" \
   -H "Authorization: Bearer <access_token>" \
   -H "data-partition-id: <data-partition-id>" \
   -H 'accept: application/json' \

Sample Response:

{
  "id": "opendes:master-data--Well:122",
  "version": 1753292228903506,
  "kind": "osdu:wks:master-data--Well:1.1.0",
  "acl": {
    "viewers": [
      "data.default.viewers@opendes.dataservices.energy"
    ],
    "owners": [
      "data.default.owners@opendes.dataservices.energy"
    ]
  },
  "legal": {
    "legaltags": [
      "opendes-welltesttag"
    ],
    "otherRelevantDataCountries": [
      "FR",
      "US"
    ]
  },
  "meta": null,
  "data": {
    "ExtensionProperties": {},
    "FacilityName": "opendes:master-data--Well:123",
    "FacilityNameAliases": [
      {
        "AliasName": "20-000-00000-00",
        "AliasNameTypeID": "opendes:reference-data--AliasNameType:UniqueIdentifier:"
      }
    ]
  },
  "createTime": "2025-07-23T17:37:09.290000+00:00",
  "createUser": "3046ab2b-b04c-4933-8afd-***********"
}

حذف سجل جيد

احذف سجل بئر معين من مثيل Azure Data Manager for Energy.

أسلوب: DELETE

curl -X DELETE "https://<DNS>/api/os-wellbore-ddms/ddms/v3/wells/<well_id>" \
   -H "Authorization: Bearer <access_token>" \
   -H "data-partition-id: <data-partition-id>"

رمز الاستجابة: 204 لا يوجد محتوى

Next step

اقرأ البرنامج التعليمي التالي لمعرفة كيفية استخدام أداة سطر الأوامر sdutil لتحميل البيانات الزلزالية في المخزن الزلزالي:

البرنامج التعليمي: استخدام sdutil لتحميل البيانات في المخزن الزلزالي

  • Last updated on