You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: "Tutorial: Work with seismic data by using Seismic DDMS APIs"
3
3
titleSuffix: Microsoft Azure Data Manager for Energy
4
4
description: This tutorial shows sample steps for interacting with the Seismic DDMS APIs in Azure Data Manager for Energy.
5
-
author: elizabethhalper
6
-
ms.author: elhalper
5
+
author: akshatjoshi
6
+
ms.author: akshatjoshi
7
7
ms.service: azure-data-manager-energy
8
8
ms.topic: tutorial
9
-
ms.date: 3/16/2022
9
+
ms.date: 3/10/2025
10
10
ms.custom: template-tutorial
11
11
12
12
#Customer intent: As a developer, I want to learn how to use the Seismic DDMS APIs so that I can store and retrieve similar kinds of data.
13
13
---
14
14
15
15
# Tutorial: Work with seismic data by using Seismic DDMS APIs
16
16
17
-
Use Seismic Domain Data Management Services (DDMS) APIs in Postman to work with seismic data in an Azure Data Manager for Energy instance.
17
+
This tutorial demonstrates how to utilize Seismic Domain Data Management Services (DDMS) APIs with cURL to manage seismic data within an Azure Data Manager for Energy instance.
18
18
19
-
In this tutorial, you learn how to:
19
+
In this tutorial, you will learn how to:
20
20
21
21
> [!div class="checklist"]
22
22
>
23
23
> * Register a data partition for seismic data.
24
-
> *Use Seismic DDMS APIs to store and retrieve seismic data.
24
+
> *Utilize Seismic DDMS APIs to store and retrieve seismic data.
25
25
26
26
For more information about DDMS, see [DDMS concepts](concepts-ddms.md).
27
27
28
28
## Prerequisites
29
-
30
29
* An Azure subscription
31
30
* An instance of [Azure Data Manager for Energy](quickstart-create-microsoft-energy-data-services-instance.md) created in your Azure subscription
31
+
* cURL command-line tool installed on your machine
32
+
* Generate the service principal access token to call the Seismic APIs. See [How to generate auth token](how-to-generate-auth-token.md).
32
33
33
34
## Get your Azure Data Manager for Energy instance details
34
35
35
-
The first step is to get the following information from your [Azure Data Manager for Energy instance](quickstart-create-microsoft-energy-data-services-instance.md) in the [Azure portal](https://portal.azure.com/?microsoft_azure_marketplace_ItemHideKey=Microsoft_Azure_OpenEnergyPlatformHidden):
:::image type="content" source="media/tutorial-ddms/postman-import-button.png" alt-text="Screenshot that shows the Import button in Postman." lightbox="media/tutorial-ddms/postman-import-button.png":::
36
+
To proceed, gather the following details from your [Azure Data Manager for Energy instance](quickstart-create-microsoft-energy-data-services-instance.md) via the [Azure portal](https://portal.azure.com/?microsoft_azure_marketplace_ItemHideKey=Microsoft_Azure_OpenEnergyPlatformHidden):
58
37
59
-
1. Paste the URL of each file into the search box.
60
-
61
-
:::image type="content" source="media/tutorial-ddms/postman-import-search.png" alt-text="Screenshot that shows importing collection and environment files in Postman via URL." lightbox="media/tutorial-ddms/postman-import-search.png":::
62
-
63
-
3. Update `CURRENT_VALUE` in the Postman environment with the information that you obtained in the Azure Data Manager for Energy instance details.
:::image type="content" source="media/tutorial-seismic-ddms/postman-api-create-legal-tag.png" alt-text="Screenshot that shows the API that creates a legal tag." lightbox="media/tutorial-seismic-ddms/postman-api-create-legal-tag.png":::
76
99
77
100
For more information, see [Manage legal tags](how-to-manage-legal-tags.md).
78
101
@@ -82,9 +105,19 @@ Run basic service connection and status tests in your Azure Data Manager for Ene
:::image type="content" source="media/tutorial-seismic-ddms/postman-api-check-service-status.png" alt-text="Screenshot that shows the API that checks the service's status." lightbox="media/tutorial-seismic-ddms/postman-api-check-service-status.png":::
115
+
**Sample Response:**
116
+
```json
117
+
service OK
118
+
```
119
+
120
+
88
121
89
122
### Tenant
90
123
@@ -95,39 +128,152 @@ Create a tenant in your Azure Data Manager for Energy instance.
95
128
96
129
API: **Tenant** > **Register a seismic-dms tenant**
97
130
98
-
Method: `POST`
99
131
100
-
:::image type="content" source="media/tutorial-seismic-ddms/postman-api-register-tenant.png" alt-text="Screenshot that shows the API that registers a tenant." lightbox="media/tutorial-seismic-ddms/postman-api-register-tenant.png":::
Create a subproject in your Azure Data Manager for Energy instance.
105
161
106
162
API: **Subproject** > **Create a new subproject**
107
163
108
-
Method: `POST`
109
-
110
-
:::image type="content" source="media/tutorial-seismic-ddms/postman-api-create-subproject.png" alt-text="Screenshot that shows the API that creates a subproject." lightbox="media/tutorial-seismic-ddms/postman-api-create-subproject.png":::
:::image type="content" source="media/tutorial-seismic-ddms/postman-api-create-dataset.png" alt-text="Screenshot that shows the API that creates a dataset." lightbox="media/tutorial-seismic-ddms/postman-api-create-dataset.png":::
121
261
122
262
### Register applications
123
263
124
264
Register applications in your Azure Data Manager for Energy instance.
125
265
126
266
API: **Applications** > **Register a new application**
127
267
128
-
Method: `POST`
129
-
130
-
:::image type="content" source="media/tutorial-seismic-ddms/postman-api-register-application.png" alt-text="Screenshot that shows the API that registers an application." lightbox="media/tutorial-seismic-ddms/postman-api-register-application.png":::
0 commit comments