Zelfstudie: Werken met Petrel-gegevensrecords met behulp van Petrel DDMS-API's

Gebruik Petrel Domain Gegevensbeheer Services (DDMS)-API's om te werken met Petrel-gegevens in uw exemplaar van Azure Data Manager for Energy.

In deze zelfstudie leert u het volgende:

Zie DDMS-concepten voor meer informatie over DDMS.

Prerequisites

• Een Azure-abonnement
• Een exemplaar van Azure Data Manager for Energy dat is gemaakt in uw Azure-abonnement
• cURL-opdrachtregelprogramma geïnstalleerd op uw computer
• Het toegangstoken van de service-principal om de Petrel-API's aan te roepen. Zie Hoe u een verificatietoken genereert.

Verkrijg details van het Azure Data Manager for Energy-exemplaar

Voor deze zelfstudie hebt u de volgende parameters nodig:

Volg de handleiding Gebruikers beheren om de juiste rechten toe te voegen voor de gebruiker die deze zelfstudie uitvoert.

Uw omgeving instellen

Zorg ervoor dat u op uw systeem hebt cURL geïnstalleerd om API-aanroepen uit te voeren.

Petrel DDMS-API's gebruiken om met Petrel-projecten te werken

Het voltooien van de API-aanroepen die aanwezig zijn in swagger geeft aan dat de interactie met uw opgeslagen Petrel-projecten is geslaagd. Hoewel de API een manier biedt om gegevens te uploaden, raden we u aan uw projecten te uploaden via DELFI Petrel Project Explorer. Bij alle volgende API-aanroepen wordt ervan uitgegaan dat u een project hebt geüpload naar Petrel Project Explorer.

Een juridische tag maken

Maak een juridische tag die u kunt gebruiken voor gegevenscompatibiliteit.

Voer de volgende cURL opdracht uit om een juridische tag te maken:

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"
           }
       }'

Voorbeeldantwoord:

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

Zie Juridische tags beheren voor meer informatie.

Gebruikers toevoegen aan een toegangsrechten-groep

Als gebruikers over de juiste machtigingen beschikken om Petrel DDMS API-aanroepen te maken, moeten ze deel uitmaken van de users.datalake.admins@{data-partition-id}.dataservices.energy rechtengroep. Met deze aanroep wordt een gebruiker toegevoegd aan de juiste groep.

De gebruiker in dit geval is de client-id of OID in het token dat wordt gebruikt voor verificatie. Als u bijvoorbeeld een token genereert met behulp van een client-id van 8cdxxxxxxxxxxxx, moet u toevoegen 8cdxxxxxxxxxxxx aan de users.datalake.admins groep. Volg de handleiding Gebruikers beheren om de juiste rechten voor de gebruiker toe te voegen.

Een project krijgen

Gebruik een project-id om de bijbehorende Petrel-projectrecord in uw Azure Data Manager for Energy-exemplaar te retourneren.

API

Een project verwijderen

Gebruik een project-id om een project en de bijbehorende Petrel-projectrecordgegevens te verwijderen in uw Azure Data Manager for Energy-exemplaar.

API

Een projectversie ophalen

Gebruik een project-id en een versie-id om de Petrel-versierecord op te halen die is gekoppeld aan het project en de versie in uw Azure Data Manager for Energy-exemplaar.

API

Download-URL voor een project ophalen

Gebruik een project-id om een SAS-URL (Shared Access Signature) op te halen, zodat u de gegevens van het bijbehorende project kunt downloaden van uw Azure Data Manager for Energy-exemplaar.

API

Een upload-URL voor een project ophalen

Gebruik een project-id om twee SAS-URL's op te halen. Met één URL worden gegevens geüpload naar het bijbehorende project in uw Azure Data Manager for Energy-exemplaar. De andere URL downloadt gegevens uit het bijbehorende project in uw Azure Data Manager for Energy-exemplaar.

API

Uw SAS-upload-URL moet er ongeveer als volgt uitzien:

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

U kunt deze URL wijzigen zodat deze de bestandsnaam bevat van de gegevens die u wilt uploaden:

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

Als u een PUT aanroep naar deze URL maakt, wordt de inhoud van body naar de blobopslag geüpload met de opgegeven FILENAME waarde.

Een project bijwerken

Gebruik een project-id en een SAS-upload-URL om een Petrel-projectrecord bij te werken in Azure Data Manager for Energy met de nieuwe waarden. U kunt desgewenst ook gegevens uploaden naar een project.

API

Projecten doorzoeken

U kunt door Petrel-projecten zoeken met behulp van veel velden. De aanroep retourneert alle overeenkomende project-id's. De Search-API ondersteunt:

• Zoeken in volledige tekst op tekenreeksvelden.
• Bereikqueries op basis van datum-, numeriek of tekenvelden.
• Geospatiaal zoeken.

API

Verwante onderwerpen

Gebruik de volgende DELFI-koppelingen om andere zelfstudies te lezen die betrekking hebben op Petrel Project Explorer en Petrel-werkstromen:

• Aan de slag met Project Explorer (slb.com)
• Een project openen dat is opgeslagen in Projectverkenner (slb.com)\
• ZGY-gegevens uploaden van Petrel naar het DELFI-gegevensecosysteem (slb.com)\
• ZGY-gegevens importeren uit het DELFI-gegevensecosysteem naar Petrel (slb.com)\
• Een Petrel-project opslaan in Projectverkenner (slb.com)