Skip to content

Commit 7390acd

Browse files
authored
Update tutorial-petrel-ddms.md
1 parent 4a3807b commit 7390acd

File tree

1 file changed

+23
-24
lines changed

1 file changed

+23
-24
lines changed

articles/energy-data-services/tutorial-petrel-ddms.md

Lines changed: 23 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
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
55
ms.author: nikarsky
66
ms.service: energy-data-services
77
ms.topic: tutorial
88
ms.date: 2/07/2023
99
ms.custom: template-tutorial
1010
---
1111

12-
# Tutorial: Work with petrel data records by using Petrel DDMS APIs
12+
# Tutorial: Work with Petrel data records by using Petrel DDMS APIs
1313

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.
1515

1616
In this tutorial, you'll learn how to:
1717
> [!div class="checklist"]
@@ -29,11 +29,11 @@ For more information about DDMS, see [DDMS concepts](concepts-ddms.md).
2929
## Prerequisites
3030

3131
- 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.
3333

34-
## Get your Microsoft Energy Data Services instance details
34+
## Get your Azure Data Manager for Energy Services instance details
3535

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):
3737

3838
| Parameter | Value | Example |
3939
| ------------------ | ------------------------ |-------------------------------------- |
@@ -64,7 +64,7 @@ Next, set up Postman:
6464

6565
## Generate a token to use in APIs
6666

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 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.
6868

6969
1. In Postman, in the left menu, select **Collections**, and then select **Petrel DDMS**. Under **Setup**, select **Get Token**.
7070

@@ -89,7 +89,7 @@ In order to use this cURL generated token, you must update `access_token` in you
8989

9090
## Use Petrel DDMS APIs to work with Petrel Projects
9191

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.
9393

9494
### Create a legal tag
9595

@@ -107,7 +107,7 @@ For more information, see [Manage legal tags](how-to-manage-legal-tags.md).
107107

108108
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.
109109

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.
111111

112112
API: **Setup** > **Add User to DATALAKE Admins**
113113

@@ -117,7 +117,7 @@ Method: POST
117117

118118
### Get Project
119119

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.
121121

122122
API: **Project** > **Get Project**.
123123

@@ -127,7 +127,7 @@ Method: GET
127127

128128
### Delete Project
129129

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.
131131

132132
API: **Project** > **Delete Project**
133133

@@ -137,7 +137,7 @@ Method: DELETE
137137

138138
### Get Project Version
139139

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.
141141

142142
API: **Project** > **Project Version**
143143

@@ -147,7 +147,7 @@ Method: GET
147147

148148
### Get a Project Download URL
149149

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.
151151

152152
API: **Project** > **Download URL**
153153

@@ -157,7 +157,7 @@ Method: GET
157157

158158
### Get a Project Upload URL
159159

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.
161161

162162
API: **Project** > **Upload URL**
163163

@@ -197,11 +197,10 @@ Method: POST
197197
:::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":::
198198

199199
## 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

Comments
 (0)