Öğretici: Wellbore DDMS API'lerini kullanarak iyi veri kayıtlarıyla çalışma

Enerji için Azure Data Manager örneğinizdeki iyi verilerle çalışmak için Wellbore Etki Alanı Veri Yönetimi Hizmetleri (DDMS) API'lerini kullanın.

Bu eğitimde şunları öğreniyorsunuz:

  • İyi veri kayıtlarıyla çalışmak için Wellbore DDMS API'lerini kullanın.

DDMS hakkında daha fazla bilgi için bkz. DDMS kavramları.

Prerequisites

Enerji için Azure Data Manager örneğinin ayrıntılarını alma

Bu öğretici için aşağıdaki parametrelere ihtiyacınız vardır:

Parameter Kullanılacak değer Example Bu değer nerede bulunur?
DNS URI <instance>.energy.azure.com Bu değeri Enerji için Azure Data Manager örneğinin genel bakış sayfasında bulabilirsiniz.
data-partition-id Data partition <data-partition-id> Bu değeri Enerji için Azure Veri Yöneticisi örneğinin Veri Bölümü bölümünde bulabilirsiniz.
access_token Erişim belirteci değeri 0.ATcA01-XWHdJ0ES-qDevC6r........... Kimlik doğrulama belirteci oluşturma adımlarını izleyerek bir erişim belirteci oluşturun ve kaydedin.

Bu öğreticiyi çalıştıran kullanıcıya uygun yetkilendirmeler eklemek için Kullanıcıları yönetme kılavuzunu izleyin.

Ortamınızı ayarlama

cURL API çağrıları yapmak için sisteminize yüklediğinizden emin olun.

Wellbore DDMS API'lerini kullanarak iyi veri kayıtlarıyla çalışma

Aşağıdaki Wellbore DDMS API'lerinde açıklanan cURL isteklerinin başarıyla tamamlanması, Enerji için Azure Data Manager örneğinizdeki iyi kayıtların başarıyla alındığını ve alındığını gösterir. Tüm API'leri kontrol etmek istiyorsanız Swagger'ı kontrol edebilirsiniz

Veri uyumluluğu için bir yasal etiket oluşturun.

Yasal etiket oluşturmak için aşağıdaki cURL komutu çalıştırın:

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

Daha fazla bilgi için bkz. Yasal etiketleri yönetme.

İyi kayıt oluşturma

Enerji için Azure Data Manager örneğinizde iyi bir kayıt oluşturun.

Yöntem: 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": []
}

İyi bir kayıt alın

Enerji için Azure Data Manager örneğine ilişkin iyi kayıt verilerini alın.

Yöntem: 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-***********"
}

İyi sürümler edinin

Alınan her iyi kaydın sürümlerini Enerji için Azure Data Manager örneğinize alın.

Yöntem: 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
  ]
}

Belirli bir iyi sürümü alma

Enerji için Azure Data Manager örneğinizde belirli bir iyi kayıt için belirli bir sürümün ayrıntılarını alın.

Yöntem: 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-***********"
}

Kuyu kaydını silme

Enerji için Azure Data Manager örneğinizden belirli bir kuyu kaydını silin.

Yöntem: 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>"

Yanıt kodu: 204 İçerik yok

Next step

Sismik Depo'ya sismik veri yüklemek için sdutil komut satırı aracını kullanmayı öğrenmek için aşağıdaki öğreticiyi okuyun:

Öğretici: Sismik Depoya veri yüklemek için sdutil kullanma

  • Last updated on