Руководство. Работа с хорошо записями данных с помощью API-интерфейсов Wellbore DDMS

Используйте API Службы управления доменными данными (DDMS) Wellbore для работы с хорошо данными в экземпляре Azure Data Manager для энергетики.

В этом руководстве вы узнаете, как:

  • Используйте API-интерфейсы Wellbore DDMS для работы с хорошой записью данных.

Для получения дополнительной информации о DDMS см. концепции DDMS.

Prerequisites

Узнайте подробности об экземпляре Azure Data Manager для энергетики

Для работы с этим руководством вам потребуются следующие параметры:

Parameter Значение для использования Example Где найти это значение
DNS URI <instance>.energy.azure.com Найдите это значение на странице обзора экземпляра Azure Data Manager для энергетики.
data-partition-id Data partition <data-partition-id> Найдите это значение в разделе секции данных в экземпляре Azure Data Manager для энергетики.
access_token Значение токена доступа 0.ATcA01-XWHdJ0ES-qDevC6r........... Следуйте инструкциям по созданию маркера проверки подлинности , чтобы создать маркер доступа и сохранить его.

Следуйте руководству по управлению пользователями, чтобы добавить соответствующие права для пользователя, выполняющего это руководство.

Настройка среды

Убедитесь, что вы установили cURL в системе, чтобы выполнять вызовы API.

Использование API-интерфейсов Wellbore DDMS для работы с хорошо записями данных

Успешное завершение запросов cURL, описанных в следующих API Wellbore DDMS, указывает на успешное прием и извлечение хорошо записей в экземпляре Azure Data Manager для энергетики. Если вы заинтересованы в проверке всех API, вы можете проверить наш 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 для энергетики.

Метод: 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 для энергетики.

Метод: 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 для энергетики.

Метод: 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 для энергетики.

Метод: 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