Oktatóanyag: Petrel-adatrekordok használata Petrel DDMS API-k használatával

  • Cikk

A Postman Petrel Domain adatkezelés Services (DDMS) API-jaival dolgozhat Petrel-adatokkal az Azure Data Manager for Energy példányában.

Ebben az oktatóanyagban az alábbiakkal fog megismerkedni:

  • Állítsa be a Postmant egy Petrel DDMS-gyűjtemény használatára.
  • A Postman beállítása Petrel DDMS-környezet használatára.
  • Kérések küldése a Postmanen keresztül.
  • Hozzon létre egy engedélyezési jogkivonatot.
  • A Petrel DDMS API-kkal együttműködhet a Petrel-adatrekordokkal és -projektekkel.

A DDMS-ről további információt a DDMS-fogalmakban talál.

Előfeltételek

  • Azure-előfizetés
  • Az Azure Data Manager for Energy egy példánya, amelyet az Azure-előfizetésben hoztak létre

Az Azure Data Manager for Energy-példány részleteinek lekérése

Az első lépés a következő információk lekérése az Azure Data Manager for Energy-példányból az Azure Portalon:

Paraméter Érték Példa
CLIENT_ID Alkalmazás (ügyfél) azonosítója 3dfxxxxxxxxxxxxxxxxxxxxxx
CLIENT_SECRET Ügyfél titkos kódja _fl******************
TENANT_ID Címtár (bérlő) azonosítója 72fxxxxxxxxxxxx
SCOPE Alkalmazás (ügyfél) azonosítója 3dfxxxxxxxxxxxxxxxxxxxxxxx
HOSTNAME URI <instance>.energy.azure.com
DATA_PARTITION_ID Adatpartíciók <instance>-<data-partition-name>

Ezeket az információkat az oktatóanyag későbbi részében fogja használni.

A Postman beállítása

  1. Töltse le és telepítse az asztali Postman alkalmazást.

  2. Importálja a következő fájlt a Postmanben: Petrel DDMS Postman gyűjtemény.

  3. Hozzon létre egy Postman-környezetet a korábban beszerzett értékek használatával. A környezetnek a következő példához hasonlóan kell kinéznie:

    Screenshot that shows an example Postman environment.

Api-kban használandó jogkivonat létrehozása

A Petrel DDMS Postman-gyűjteménye olyan kéréseket tartalmaz, amelyekkel kezelheti a Petrel-projekteket. Emellett egy kérést is tartalmaz az Aktuális Petrel-projektek és -rekordok lekérdezésére az Azure Data Manager for Energy-példányban.

  1. A Postman bal oldali menüjében válassza a Gyűjtemények, majd a Petrel DDMS lehetőséget. A Beállítás területen válassza a Jogkivonat lekérése lehetőséget.

  2. A jobb felső sarokban található környezet legördülő listájában válassza a Petrel DDMS Environment lehetőséget.

  3. A kérés elküldéséhez válassza a Küldés lehetőséget.

Ez a kérés létrehoz egy hozzáférési jogkivonatot, és a jövőbeli kérések engedélyezési módszereként rendeli hozzá.

Jogkivonatot a Postman cURL parancsával vagy egy terminállal is létrehozhat egy tulajdonosi jogkivonat létrehozásához. Használja az Azure Data Manager for Energy-példány értékeit.

      curl --location --request POST 'https://login.microsoftonline.com/{{TENANT_ID}}/oauth2/v2.0/token' \
          --header 'Content-Type: application/x-www-form-urlencoded' \
          --data-urlencode 'grant_type=client_credentials' \
          --data-urlencode 'client_id={{CLIENT_ID}}' \
          --data-urlencode 'client_secret={{CLIENT_SECRET}}' \
          --data-urlencode 'scope={{SCOPE}}'

A cURL által létrehozott jogkivonat használatához frissítenie access_token kell a Collection változókban a válasz utáni Bearer értékkel.

Petrel DDMS API-k használata Petrel-projektek használatához

Az alábbi Petrel DDMS API-kban leírt Postman-kérések sikeres végrehajtása a mentett Petrel-projektekkel való sikeres interakciót jelzi. Bár az API lehetővé teszi az adatok feltöltését, javasoljuk, hogy töltse fel projektjeit a DELFI Petrel Project Explorer használatával. Az alábbi API-hívások mindegyike feltételezi, hogy egy projektet töltött fel a Petrel Project Explorerbe.

Hozzon létre egy jogi címkét, amely automatikusan hozzáadódik a Petrel DDMS-környezethez az adatmegfelelőség érdekében.

API: Jogi címke létrehozása>a PDS-hez

Módszer: POST

Screenshot that shows the API that creates a legal tag.

További információ: Jogi címkék kezelése.

Felhasználók hozzáadása jogosultsági csoporthoz

Ahhoz, hogy a felhasználók megfelelő engedélyekkel rendelkezzenek a Petrel DDMS API-hívások indításához, a users.datalake.admins@{data-partition-id}.dataservices.energy jogosultsági csoporthoz kell tartozniuk. Ez a hívás hozzáad egy felhasználót a megfelelő csoporthoz.

Ebben az esetben a felhasználó a hitelesítéshez használt jogkivonat ügyfélazonosítója vagy OID-azonosítója. Ha például egy jogkivonatot az ügyfélazonosító 8cdxxxxxxxxxxxxhasználatával hoz létre, hozzá kell adnia 8cdxxxxxxxxxxxx a users.datalake.admins csoporthoz.

API: Felhasználó hozzáadása a DATALAKE-Rendszergazda-hoz beállítás>

Módszer: POST

Screenshot that shows the API that adds user to entitlements.

Projekt lekérése

A projektazonosítóval visszaadhatja a megfelelő Petrel-projektrekordot az Azure Data Manager for Energy-példányban.

API: Project>Get Project

Módszer: GET

Screenshot that shows the API that gets a project.

Projektek törlése

Projektazonosító használatával törölhet egy projektet és a kapcsolódó Petrel-projektrekord adatait az Azure Data Manager for Energy-példányban.

API: Projekt>törlése projekt

Módszer: DELETE

Screenshot that shows the API that deletes a project.

Projektverzió lekérése

A projektazonosító és a verzióazonosító segítségével lekérheti a projekthez társított Petrel-verziórekordot az Azure Data Manager for Energy-példányban.

API: Project>Get Project Version

Módszer: GET

Screenshot that shows the API that gets a project version.

Projekt letöltési URL-címének lekérése

A projektazonosítóval lekérheti a közös hozzáférésű jogosultságkód (SAS) URL-címét, hogy letölthesse a megfelelő projekt adatait az Azure Data Manager for Energy-példányból.

API: Project>Get Project Download

Módszer: GET

Screenshot that shows the API that gets a project download URL.

Projektfeltöltési URL-cím lekérése

Használjon projektazonosítót két SAS-URL-cím lekéréséhez. Egy URL-cím adatokat tölt fel a megfelelő projektbe az Azure Data Manager for Energy-példányban. A másik URL-cím adatokat tölt le a megfelelő projektből az Azure Data Manager for Energy-példányban.

API: Project>Get Signed Upload URL-cím

Módszer: POST

Screenshot that shows the API that gets a project upload URL.

A SAS feltöltési URL-címének a következő példához hasonlóan kell kinéznie:

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

Ezt az URL-címet úgy módosíthatja, hogy tartalmazza a feltölteni kívánt adatok fájlnevét:

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

PUT Ennek az URL-címnek a meghívása feltölti body a blobtároló tartalmát a megadott FILENAME érték alatt.

Egy projekt frissítése

Egy projektazonosítóval és egy SAS-feltöltési URL-címmel frissíthet egy Petrel-projektrekordot az Azure Data Manager for Energy-ben az új értékekkel. Ha szeretné, adatokat is feltölthet egy projektbe.

API: Project>Update Project

Módszer: PUT

Screenshot that shows the API that updates a project.

Keresés projekteken keresztül

A Petrel-projektekben számos mező használatával kereshet. A hívás visszaadja az összes egyező projektazonosítót. Az API a következőket támogatja:

  • Teljes szöveges keresés sztringmezőkön.
  • Tartomány lekérdezései dátum, numerikus vagy sztringmezők alapján.
  • Térinformatikai keresés.

API: Projektkeresési>projektek

Módszer: POST

Screenshot that shows the API that deletes a well record.

Kapcsolódó tartalom

Az alábbi DELFI-hivatkozások segítségével további, Petrel Project Explorer- és Petrel-munkafolyamatokat tartalmazó oktatóanyagokat olvashat: