Lernprogramm: Arbeiten mit Petrel-Datensätzen mithilfe von Petrel DDMS-APIs

Verwenden Sie Petrel Domain Datenverwaltung Services (DDMS)-APIs, um mit Petrel-Daten in Ihrer Instanz von Azure Data Manager for Energy zu arbeiten.

In diesem Lernprogramm lernen Sie:

  • Generieren eines Autorisierungstokens
  • Verwenden Sie Petrel DDMS-APIs, um mit Petrel-Datensätzen und -Projekten zu arbeiten.

Weitere Informationen zu DDMS finden Sie unter DDMS-Konzepte.

Prerequisites

Abrufen von Details zur Instanz von Azure Data Manager for Energy

Für dieses Lernprogramm benötigen Sie die folgenden Parameter:

Parameter Zu verwendender Wert Example Wo dieser Wert gefunden werden soll
DNS URI <instance>.energy.azure.com Diesen Wert finden Sie auf der Übersichtsseite des Azure Data Manager für Energieinstanz.
data-partition-id Datenpartition <data-partition-id> Suchen Sie diesen Wert im Abschnitt "Datenpartition" im Azure Data Manager für Energieinstanz.
access_token Zugriffstokenwert 0.ATcA01-XWHdJ0ES-qDevC6r........... Folgen Sie , wie Sie Authentifizierungstoken generieren , um ein Zugriffstoken zu erstellen und zu speichern.

Folgen Sie dem Leitfaden " Benutzer verwalten" , um dem Benutzer, der dieses Lernprogramm ausführt, geeignete Berechtigungen hinzuzufügen.

Richten Sie Ihre Umgebung ein

Stellen Sie sicher, dass cURL auf Ihrem System installiert ist, um API-Aufrufe zu machen.

Verwenden von Petrel DDMS-APIs für die Arbeit mit Petrel-Projekten

Erfolgreiches Abschließen der API-Aufrufe, die in swagger vorhanden sind, bedeutet eine erfolgreiche Interaktion mit Ihren gespeicherten Petrel-Projekten. Obwohl die API eine Möglichkeit zum Hochladen von Daten bietet, empfehlen wir, Ihre Projekte über DELFI Petrel Project Explorer hochzuladen. Bei allen folgenden API-Aufrufen wird davon ausgegangen, dass Sie ein Projekt in Den Petrel-Projekt-Explorer hochgeladen haben.

Erstellen Sie ein rechtliches Etikett, das Sie für die Datenkonformität verwenden können.

Führen Sie den folgenden cURL-Befehl aus, um ein rechtliches Tag zu erstellen:

curl -X POST "https://<DNS>/api/legal/v1/legaltags" \
     -H "Authorization: Bearer <access_token>" \
     -H "Content-Type: application/json" \
     -H "data-partition-id: <data-partition-id>" \
     -d '{
           "name": "LegalTagName",
           "description": "Legal Tag added for Well",
           "properties": {
               "contractId": "123456",
               "countryOfOrigin": ["US", "CA"],
               "dataType": "Third Party Data",
               "exportClassification": "EAR99",
               "originator": "xyz",
               "personalData": "No Personal Data",
               "securityClassification": "Private",
               "expirationDate": "2025-12-25"
           }
       }'

Beispielantwort:

{
  "name": "LegalTagName",
  "status": "Created"
}

Weitere Informationen finden Sie unter Verwalten rechtlicher Tags.

Hinzufügen von Benutzern zu einer Berechtigungsgruppe

Damit Benutzer über die richtigen Berechtigungen zum Ausführen von Petrel DDMS-API-Aufrufen verfügen, müssen sie Teil der users.datalake.admins@{data-partition-id}.dataservices.energy Berechtigungsgruppe sein. Mit diesem Aufruf wird der richtigen Gruppe ein Benutzer hinzugefügt.

Der Benutzer in diesem Fall ist die Client-ID oder OID im Token, das für die Authentifizierung verwendet wird. Wenn Sie z. B. ein Token mithilfe einer Client-ID von 8cdxxxxxxxxxxxx generieren, müssen Sie 8cdxxxxxxxxxxxx der users.datalake.admins Gruppe hinzufügen. Folgen Sie dem Leitfaden " Benutzer verwalten" , um dem Benutzer entsprechende Berechtigungen hinzuzufügen.

Abrufen eines Projekts

Verwenden Sie eine Projekt-ID, um den entsprechenden Petrel-Projektdatensatz in Ihrem Azure Data Manager für Energieinstanz zurückzugeben.

API

Löschen eines Projekts

Verwenden Sie eine Projekt-ID, um ein Projekt und die zugeordneten Petrel-Projektdaten in Ihrem Azure Data Manager für Energieinstanz zu löschen.

API

Abrufen einer Projektversion

Verwenden Sie eine Projekt-ID und eine Versions-ID, um den Petrel-Versionsdatensatz abzurufen, der dem Projekt und der Version in Ihrem Azure Data Manager für Energieinstanz zugeordnet ist.

API

URL zum Herunterladen eines Projekts abrufen

Verwenden Sie eine Projekt-ID, um eine SAS-URL (Shared Access Signature) abzurufen, damit Sie die Daten des entsprechenden Projekts aus Ihrem Azure Data Manager für Energieinstanz herunterladen können.

API

Abrufen einer Projektupload-URL

Verwenden Sie eine Projekt-ID, um zwei SAS-URLs abzurufen. Eine URL lädt Daten in das entsprechende Projekt in Ihrem Azure Data Manager für Energieinstanz hoch. Die andere URL lädt Daten aus dem entsprechenden Projekt in Ihrem Azure Data Manager für Energieinstanz herunter.

API

Ihre SAS-Upload-URL sollte etwa wie in diesem Beispiel aussehen:

https://{storage-account}.z15.blob.storage.azure.net/projects/{data-partition-id}/{projectID}.staging/{versionID}?{SAS-token-info}

Sie können diese URL so ändern, dass sie den Dateinamen der Daten enthält, die Sie hochladen möchten:

https://{storage-account}.z15.blob.storage.azure.net/projects/{data-partition-id}/{projectID}.staging/{versionID}/{FILENAME}?{SAS-token-info}

Durch einen PUT-Aufruf an diese URL wird der Inhalt von body in den Blobspeicher unter dem bereitgestellten FILENAME-Wert hochgeladen.

Aktualisieren eines Projekts

Verwenden Sie eine Projekt-ID und eine SAS-Upload-URL, um einen Petrel-Projektdatensatz in Azure Data Manager for Energy mit den neuen Werten zu aktualisieren. Sie können bei Bedarf auch Daten in ein Projekt hochladen.

API

Durchsuchen von Projekten

Sie können Petrel-Projekte mit vielen Feldern durchsuchen. Der Aufruf gibt alle übereinstimmenden Projekt-IDs zurück. Die Such-API unterstützt Folgendes:

  • Volltextsuche in Zeichenfolgenfeldern.
  • Bereichsabfragen basierend auf Datums-, Numerischen oder Zeichenfolgenfeldern.
  • Geospatiale Suche.

API

Verwandte Inhalte

Verwenden Sie die folgenden DELFI-Links, um andere Lernprogramme zu lesen, die Petrel-Projekt-Explorer und Petrel-Workflows umfassen:

  • Zuletzt aktualisiert um