Tutorial: Arbeiten mit Bohrlochdatensätzen mithilfe der Wellbore DDMS-APIs
Verwenden Sie die APIs für Wellbore Domain Data Management Services (DDMS) in Postman, um in Ihrer Azure Data Manager for Energy-Instanz mit Bohrlochdaten zu arbeiten.
In diesem Tutorial lernen Sie Folgendes:
- Einrichten von Postman zur Verwendung einer Wellbore DDMS-Sammlung
- Einrichten von Postman zur Verwendung einer Wellbore DDMS-Umgebung
- Senden von Anforderungen über Postman
- Generieren eines Autorisierungstokens
- Verwenden der Wellbore DDMS-APIs zum Arbeiten mit Bohrlochdatensätzen
Weitere Informationen zu DDMS finden Sie unter DDMS-Konzepte.
Voraussetzungen
- Ein Azure-Abonnement
- Eine Instanz von Azure Data Manager for Energy, die in Ihrem Azure-Abonnement erstellt wurde
Abrufen der Instanzdetails für Azure Data Manager for Energy
Der erste Schritt besteht darin, die folgenden Informationen aus Ihrer Instanz von Azure Data Manager for Energy im Azure-Portal abzurufen:
| Parameter | Wert | Beispiel |
|---|---|---|
client_id |
Anwendungs-ID (Client) | 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx |
client_secret |
Geheime Clientschlüssel | _fl****************** |
tenant_id |
Verzeichnis-ID (Mandant) | 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx |
base_url |
URL | https://<instance>.energy.azure.com |
data-partition-id |
Datenpartitionen | <data-partition-name> |
Sie werden diese Informationen später im Tutorial verwenden.
Einrichten von Postman
Laden Sie die Postman-Desktop-App herunter, und installieren Sie sie.
Importieren Sie die folgenden Dateien in Postman:
So importieren Sie die Dateien:
Wählen Sie in Postman Importieren aus.
Fügen Sie die URL jeder Datei in das Suchfeld ein.
Aktualisieren Sie in der Postman-Umgebung die Option Aktueller Wert mit den Informationen aus den Details zu Ihrer Azure Data Manager for Energy-Instanz:
Wählen Sie in Postman im Menü auf der linken Seite die Option Umgebungen und dann Wellbore DDMS-Umgebung aus.
Geben Sie in der Spalte Aktueller Wert die Informationen aus der Tabelle im Abschnitt Abrufen von Azure Data Manager for Energy-Instanzdetails dieses Tutorials ein.
Senden einer Postman-Beispielanforderung
Die Postman-Sammlung für Wellbore DDMS enthält Anforderungen, die Sie verwenden können, um mit Daten zu Bohrungen, Bohrlöchern, Bohrlochprotokollen und Bohrlochverläufe in Ihrer Azure Data Manager for Energy-Instanz zu interagieren.
Wählen Sie in Postman im Menü auf der linken Seite Sammlungen und dann Wellbore DDMS aus. Wählen Sie unter Setup die Option Get an SPN Token (SPN-Token abrufen) aus.
Wählen Sie in der Dropdownliste „Umgebung“ in der oberen rechten Ecke Wellbore DDMS-Umgebung aus.
Wählen Sie Senden aus, um die Anforderung zu senden.
Die Anforderung vergleicht den tatsächlichen API-Antwortcode mit dem erwarteten Antwortcode. Wählen Sie die Registerkarte Testergebnisse aus, um anzuzeigen, ob die Anforderung erfolgreich war oder fehlgeschlagen ist.
Hier finden Sie ein Beispiel für einen erfolgreichen Postman-Aufruf:
Dies ist ein Beispiel für einen fehlgeschlagenen Postman-Aufruf:
Verwenden der Wellbore DDMS-APIs zum Arbeiten mit Bohrlochdatensätzen
Der erfolgreiche Abschluss der Postman-Anforderungen, die in den folgenden Wellbore DDMS-APIs beschrieben sind, zeigt die erfolgreiche Erfassung und den Abruf von Bohrlochdatensätzen in Ihrer Instanz von Azure Data Manager for Energy an.
Erstellen eines rechtlichen Tags
Erstellen Sie ein rechtliches Tag, das automatisch zu Ihrer Wellbore DDMS-Umgebung hinzugefügt wird, um die Datencompliance zu gewährleisten.
API: Setup>Create Legal Tag for WDMS (Rechtliches Tag für WDMS erstellen)
Methode: POST
Weitere Informationen finden Sie unter Verwalten von rechtlichen Tags.
Erstellen eines Bohrlochdatensatzes
Erstellen Sie einen Bohrlochdatensatz in Ihrer Instanz von Azure Data Manager for Energy.
API: Well>Create Well
Methode: POST
Abrufen eines Bohrlochdatensatzes
Rufen Sie die Daten des Bohrlochdatensatzes für Ihre Instanz von Azure Data Manager for Energy ab.
API: Well>Well by ID
Methode: GET
Abrufen der Versionen des Bohrlochdatensatzes
Rufen Sie die Versionen der einzelnen erfassten Bohrlochdatensätze in Ihrer Instanz von Azure Data Manager for Energy ab.
API: Well>Well Versions
Methode: GET
Abrufen einer bestimmten Version des Bohrlochdatensatzes
Rufen Sie die Informationen zu einer bestimmten Version eines spezifischen Bohrlochdatensatzes in Ihrer Instanz von Azure Data Manager for Energy ab.
API: Well>Well Specific Version
Methode: GET
Löschen eines Bohrlochdatensatzes
Löschen Sie einen bestimmten Bohrlochdatensatz aus Ihrer Instanz von Azure Data Manager for Energy.
API: Clean up (Bereinigen)>Well Record (Bohrlochdatensatz)
Methode: DELETE
Nächster Schritt
Sehen Sie sich das folgende Tutorial an, um zu erfahren, wie Sie das Befehlszeilentool „sdutil“ zum Hochladen seismischer Daten in Seismic Store verwenden: