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
Copy file name to clipboardExpand all lines: articles/energy-data-services/tutorial-petrel-ddms.md
+23-24Lines changed: 23 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,17 +1,17 @@
1
1
---
2
-
title: Tutorial - Work with petrel data records by using Petrel DDMS APIs
3
-
description: Learn how to work with petrel data records in your Microsoft Energy Data Services Preview instance by using Petrel Domain Data Management Services (Petrel DDMS) APIs in Postman.
4
-
author: Nick Karsky
2
+
title: Tutorial - Work with Petrel data records by using Petrel DDMS APIs in Azure Data Manager for Energy Preview
3
+
description: Learn how to work with Petrel data records in your Azure Data Manager for Energy Preview instance by using Petrel Domain Data Management Services (Petrel DDMS) APIs in Postman.
4
+
author: nikarsky
5
5
ms.author: nikarsky
6
6
ms.service: energy-data-services
7
7
ms.topic: tutorial
8
8
ms.date: 2/07/2023
9
9
ms.custom: template-tutorial
10
10
---
11
11
12
-
# Tutorial: Work with petrel data records by using Petrel DDMS APIs
12
+
# Tutorial: Work with Petrel data records by using Petrel DDMS APIs
13
13
14
-
Use Petrel Domain Data Management Services (Petrel DDMS) APIs in Postman to work with well data in your instance of Microsoft Energy Data Services Preview.
14
+
Use Petrel Domain Data Management Services (Petrel DDMS) APIs in Postman to work with Petrel data in your instance of Azure Data Manager for Energy Preview.
15
15
16
16
In this tutorial, you'll learn how to:
17
17
> [!div class="checklist"]
@@ -29,11 +29,11 @@ For more information about DDMS, see [DDMS concepts](concepts-ddms.md).
29
29
## Prerequisites
30
30
31
31
- An Azure subscription
32
-
- An instance of [Microsoft Energy Data Services Preview](quickstart-create-microsoft-energy-data-services-instance.md) created in your Azure subscription.
32
+
- An instance of [Azure Data Manager for Energy Preview](quickstart-create-microsoft-energy-data-services-instance.md) created in your Azure subscription.
33
33
34
-
## Get your Microsoft Energy Data Services instance details
34
+
## Get your Azure Data Manager for Energy Services instance details
35
35
36
-
The first step is to get the following information from your [Microsoft Energy Data Services Preview instance](quickstart-create-microsoft-energy-data-services-instance.md) in the [Azure portal](https://portal.azure.com/?microsoft_azure_marketplace_ItemHideKey=Microsoft_Azure_OpenEnergyPlatformHidden):
36
+
The first step is to get the following information from your [Azure Data Manager for Energy Preview instance](quickstart-create-microsoft-energy-data-services-instance.md) in the [Azure portal](https://portal.azure.com/?microsoft_azure_marketplace_ItemHideKey=Microsoft_Azure_OpenEnergyPlatformHidden):
The Postman collection for Petrel DDMS contains requests you can use to interact with your Petrel Projects. It also contains a request to query current Petrel projects and records in your Microsoft Energy Data Services instance.
67
+
The Postman collection for Petrel DDMS contains requests you can use to interact with your Petrel Projects. It also contains a request to query current Petrel projects and records in your Azure Data Manager for Energy instance.
68
68
69
69
1. In Postman, in the left menu, select **Collections**, and then select **Petrel DDMS**. Under **Setup**, select **Get Token**.
70
70
@@ -89,7 +89,7 @@ In order to use this cURL generated token, you must update `access_token` in you
89
89
90
90
## Use Petrel DDMS APIs to work with Petrel Projects
91
91
92
-
Successfully completing the Postman requests described in the following Petrel DDMS API allows you to interact with your save petrel projects. While the API does provide a means of uploading data, we recommended that you upload your projects via the Delfi Petrel Explorer. All of the following API calls assume you have a project uploaded to Petrel Explorer.
92
+
Successfully completing the Postman requests described in the following Petrel DDMS API allows you to interact with your save Petrel projects. While the API does provide a means of uploading data, we recommended that you upload your projects via the DELFI Petrel Explorer. All of the following API calls assume you have a project uploaded to Petrel Explorer.
93
93
94
94
### Create a legal tag
95
95
@@ -107,7 +107,7 @@ For more information, see [Manage legal tags](how-to-manage-legal-tags.md).
107
107
108
108
In order to ensure the user has the proper permissions to make the Petrel DDMS API calls, the user must be apart of the `users.datalake.admins@{data-partition-id}.dataservices.energy` entitlements group. This call adds the user to the proper groups.
109
109
110
-
The **USER** in this case is the Client ID/OID contained in the token used for authentication. For example, if I generate my token using a client ID of `8cdxxxxxxxxxxxx`, I must add `8cdxxxxxxxxxxxx` to the **users.datalake.admins** group.
110
+
The **USER** in this case is the Client ID/OID contained in the token used for authentication. For example, if you generate a token using a client ID of `8cdxxxxxxxxxxxx`, you must add `8cdxxxxxxxxxxxx` to the **users.datalake.admins** group.
111
111
112
112
API: **Setup** > **Add User to DATALAKE Admins**
113
113
@@ -117,7 +117,7 @@ Method: POST
117
117
118
118
### Get Project
119
119
120
-
Given a Project ID, returns the corresponding Petrel Project record in your Microsoft Energy Data Services instance.
120
+
Given a Project ID, returns the corresponding Petrel Project record in your Azure Data Manager for Energy instance.
121
121
122
122
API: **Project** > **Get Project**.
123
123
@@ -127,7 +127,7 @@ Method: GET
127
127
128
128
### Delete Project
129
129
130
-
Given a Project ID, deletes the project and the associated Petrel Project record data in your Microsoft Energy Data Services instance.
130
+
Given a Project ID, deletes the project and the associated Petrel Project record data in your Azure Data Manager for Energy instance.
131
131
132
132
API: **Project** > **Delete Project**
133
133
@@ -137,7 +137,7 @@ Method: DELETE
137
137
138
138
### Get Project Version
139
139
140
-
Given a Project ID and a Version ID, gets the Petrel Version record associated with that project/version ID in your Microsoft Energy Data Services instance.
140
+
Given a `Project ID` and a `Version ID`, gets the Petrel Version record associated with that project/version ID in your Microsoft Energy Data Services instance.
141
141
142
142
API: **Project** > **Project Version**
143
143
@@ -147,7 +147,7 @@ Method: GET
147
147
148
148
### Get a Project Download URL
149
149
150
-
Given a Project ID, returns a SAS URL to download the data of the corresponding project from your Microsoft Energy Data Services instance.
150
+
Given a Project ID, returns a SAS URL to download the data of the corresponding project from your Azure Data Manager for Energy instance.
151
151
152
152
API: **Project** > **Download URL**
153
153
@@ -157,7 +157,7 @@ Method: GET
157
157
158
158
### Get a Project Upload URL
159
159
160
-
Given a Project ID, returns two SAS URLs. One to upload data to and one to download data from the corresponding project in your Microsoft Energy Data Services instance.
160
+
Given a Project ID, returns two SAS URLs. One to upload data to and one to download data from the corresponding project in your Azure Data Manager for Energy instance.
161
161
162
162
API: **Project** > **Upload URL**
163
163
@@ -197,11 +197,10 @@ Method: POST
197
197
:::image type="content" source="media/tutorial-petrel-ddms/search-projects-pdsv2.png" alt-text="Screenshot that shows the API that deletes a well record." lightbox="media/tutorial-petrel-ddms/search-projects-pdsv2.png":::
198
198
199
199
## Next Steps
200
-
201
-
Visit the following DELFI links for further tutorials involving Petrel Explorer and Petrel Workflows:
202
-
203
-
- Browse existing Petrel projects in Petrel - [Get started with Project Explorer (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/299EC605-5CC6-4CD9-9B07-482B16426769)
204
-
- Open Petrel project from PDS Project Explorer - [Open a project saved in Project Explorer (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/20AACC1C-E501-4436-9FC9-03427C21B12E)
205
-
- In Petrel, upload seismic data to Project Oak SDMS - [Upload ZGY data from Petrel to the DELFI Data Ecosystem (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/9F76FDB2-7817-491A-995F-A18D558A191C)
206
-
- Consume seismic data from SDMS (converted ZGY) in Petrel - [Import ZGY data from the DELFI Data Ecosystem to Petrel (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/B0B8DA1A-74B6-4109-B80D-25FF4A75C57D)
207
-
- Upload Petrel.PET project file to PDS - [Save a Petrel project in Project Explorer (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/C86C74BE-6FF9-4962-AEBF-887897B95D4B)
200
+
> [!div class="nextstepaction"]
201
+
> Visit the following DELFI links for further tutorials involving Petrel Explorer and Petrel Workflows:\
202
+
> [Get started with Project Explorer (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/299EC605-5CC6-4CD9-9B07-482B16426769)\
203
+
> [Open a project saved in Project Explorer (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/20AACC1C-E501-4436-9FC9-03427C21B12E)\
204
+
> [Upload ZGY data from Petrel to the DELFI Data Ecosystem (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/9F76FDB2-7817-491A-995F-A18D558A191C)\
205
+
> [Import ZGY data from the DELFI Data Ecosystem to Petrel (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/B0B8DA1A-74B6-4109-B80D-25FF4A75C57D)\
206
+
> [Save a Petrel project in Project Explorer (slb.com)](https://guru.delfi.slb.com/content/1015/help/1/en-US/C86C74BE-6FF9-4962-AEBF-887897B95D4B)
0 commit comments