Edit

Tutorial: Work with well data records by using Wellbore DDMS APIs

  • Article

Use Wellbore Domain Data Management Services (Wellbore DDMS) APIs in Postman to work with well data in your instance of Azure Data Manager for Energy.

In this tutorial, you'll learn how to:

  • Set up Postman to use a Wellbore DDMS collection.
  • Set up Postman to use a Wellbore DDMS environment.
  • Send requests via Postman.
  • Generate an authorization token.
  • Use Wellbore DDMS APIs to work with well data records.

For more information about DDMS, see DDMS concepts.

Prerequisites

Get your Azure Data Manager for Energy instance details

The first step is to get the following information from your Azure Data Manager for Energy instance in the Azure portal:

Parameter Value Example
client_id Application (client) ID 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
client_secret Client secrets _fl******************
tenant_id Directory (tenant) ID 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL https://<instance>.energy.azure.com
data-partition-id Data Partition(s) <data-partition-name>

You'll use this information later in the tutorial.

Set up Postman

Next, set up Postman:

  1. Download and install the Postman desktop app.

  2. Import the following files in Postman:

    To import the files:

    1. Select Import in Postman.

      Screenshot that shows the import button in Postman.

    2. Paste the URL of each file into the search box.

      Screenshot that shows importing collection and environment files in Postman via URL.

  3. In the Postman environment, update CURRENT VALUE with the information from your Azure Data Manager for Energy instance details

    1. In Postman, in the left menu, select Environments, and then select Wellbore DDMS Environment.

    2. In the CURRENT VALUE column, enter the information that's described in the table in 'Get your Azure Data Manager for Energy instance details'.

    Screenshot that shows where to enter current values in the Wellbore DDMS environment.

Send an example Postman request

The Postman collection for Wellbore DDMS contains requests you can use to interact with data about wells, wellbores, well logs, and well trajectory data in your Azure Data Manager for Energy instance.

  1. In Postman, in the left menu, select Collections, and then select Wellbore DDMS. Under Setup, select Get an SPN Token.

  2. In the environment dropdown in the upper-right corner, select Wellbore DDMS Environment.

    Screenshot that shows the Get an SPN Token setup and selecting the environment.

  3. To send the request, select Send.

    Screenshot that shows the Send button for a request in Postman.

  4. The request validates the actual API response code against the expected response code. Select the Test Results tab to see whether the request succeeded or failed.

    Example of a successful Postman call:

    Screenshot that shows success for a Postman call.

    Example of a failed Postman call:

    Screenshot that shows failure for a Postman call.

Use Wellbore DDMS APIs to work with well data records

Successfully completing the Postman requests that are described in the following Wellbore DDMS APIs indicates successful ingestion and retrieval of well records in your Azure Data Manager for Energy instance.

Create a legal tag that's automatically added to your Wellbore DDMS environment for data compliance.

API: Setup > Create Legal Tag for WDMS

Method: POST

Screenshot that shows the API that creates a legal tag.

For more information, see Manage legal tags.

Create a well

Create a well record in your Azure Data Manager for Energy instance.

API: Well > Create Well

Method: POST

Screenshot that shows the API that creates a well.

Get a well record

Get the well record data for your Azure Data Manager for Energy instance.

API: Well > Well by ID

Method: GET

Screenshot that shows the API that gets a well by ID.

Get well versions

Get the versions of each ingested well record in your Azure Data Manager for Energy instance.

API: Well > Well Versions

Method: GET

Screenshot that shows the API that gets all well versions.

Get a specific well version

Get the details of a specific version for a specific well record in your Azure Data Manager for Energy instance.

API: Well > Well Specific Version

Method: GET

Screenshot that shows the API that gets a specific well version.

Delete a well record

Delete a specific well record from your Azure Data Manager for Energy instance.

API: Clean up > Well Record

Method: DELETE

Screenshot that shows the API that deletes a well record.

Next steps

Go to the Seismic Store DDMS sdutil tutorial to learn how to use sdutil to load seismic data into Seismic Store:

Tutorial: Seismic Store DDMS sdutil