Tutorial: Work with seismic data by using Seismic DDMS APIs

Use Seismic Domain Data Management Services (DDMS) APIs in Postman to work with seismic data in an Azure Data Manager for Energy instance.

In this tutorial, you learn how to:

  • Register a data partition for seismic data.
  • Use Seismic DDMS APIs to store and retrieve seismic data.

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 partitions <data-partition-name>

Set up Postman

  1. Download and install the Postman desktop app.

  2. Import the following files into 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. Update CURRENT_VALUE in the Postman environment with the information that you obtained in the Azure Data Manager for Energy instance details.

Use Seismic DDMS APIs to store and retrieve seismic data

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

API: Setup > Create Legal Tag for SDMS

Method: POST

Screenshot that shows the API that creates a legal tag.

For more information, see Manage legal tags.

Verify the service

Run basic service connection and status tests in your Azure Data Manager for Energy instance.

API: Service Verification > Check Status

Method: GET

Screenshot that shows the API that checks the service's status.

Tenant

Create a tenant in your Azure Data Manager for Energy instance.

Note

You must register a data partition as a tenant before using it with the Seismic DDMS.

API: Tenant > Register a seismic-dms tenant

Method: POST

Screenshot that shows the API that registers a tenant.

Create a subproject

Create a subproject in your Azure Data Manager for Energy instance.

API: Subproject > Create a new subproject

Method: POST

Screenshot that shows the API that creates a subproject.

Register a dataset

Register a dataset in your Azure Data Manager for Energy instance.

API: Dataset > Register a new dataset

Method: POST

Screenshot that shows the API that creates a dataset.

Register applications

Register applications in your Azure Data Manager for Energy instance.

API: Applications > Register a new application

Method: POST

Screenshot that shows the API that registers an application.

Next step

As an alternative user experience to Postman, you can use the sdutil command-line Python tool to directly interact with Seismic Store. Use the following tutorial to get started: