Poradnik: Praca z danymi rekordów Petrel przy użyciu interfejsów API Petrel DDMS

Użyj interfejsów API Petrel Domain Zarządzanie danymi Services (DDMS), aby pracować z danymi Petrel w swoim wystąpieniu usługi Azure Data Manager for Energy.

Z tego samouczka nauczysz się:

  • Generowanie tokenu autoryzacji.
  • Interfejsy API petrel DDMS umożliwiają pracę z rekordami i projektami danych Petrel.

Aby uzyskać więcej informacji na temat DDMS, zobacz Pojęcia dotyczące DDMS.

Prerequisites

  • Subskrypcja platformy Azure
  • Wystąpienie usługi Azure Data Manager for Energy utworzone w ramach subskrypcji platformy Azure
  • Narzędzie wiersza polecenia cURL zainstalowane na maszynie
  • Token dostępu głównej jednostki usługi do wywołania interfejsów API Petrel. Zobacz Jak wygenerować token uwierzytelniania.

Uzyskiwanie szczegółów dla wystąpienia usługi Azure Data Manager for Energy

Na potrzeby tego samouczka potrzebne są następujące parametry:

Parameter Wartość do użycia Example Gdzie znaleźć tę wartość
DNS URI <instance>.energy.azure.com Znajdź tę wartość na stronie przeglądowej wystąpienia Azure Data Manager for Energy.
data-partition-id Podział danych <data-partition-id> Znajdź tę wartość w sekcji „Data Partition” w wystąpieniu usługi Azure Data Manager for Energy.
access_token Wartość tokenu dostępu 0.ATcA01-XWHdJ0ES-qDevC6r........... Postępuj zgodnie z instrukcjami generowania tokenu uwierzytelniania, aby utworzyć token dostępu i zapisać go.

Postępuj zgodnie z przewodnikiem Zarządzanie użytkownikami , aby dodać odpowiednie uprawnienia dla użytkownika, który uruchamia ten samouczek.

Konfigurowanie środowiska

Upewnij się, że zainstalowano cURL w systemie, aby wykonywać wywołania interfejsu API.

Korzystanie z interfejsów API programu Petrel DDMS do pracy z projektami Petrel

Pomyślne wykonanie wywołań interfejsu API obecnych w Swagger oznacza udaną interakcję z zapisanymi projektami Petrel. Mimo że interfejs API umożliwia przekazywanie danych, zalecamy przekazywanie projektów za pośrednictwem Eksploratora projektów DELFI Petrel. Wszystkie poniższe wywołania interfejsu API zakładają, że projekt został przekazany do Eksploratora projektu Petrel.

Utwórz tag prawny, którego można użyć na potrzeby zgodności danych.

Uruchom następujące cURL polecenie, aby utworzyć tag prawny:

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

Przykładowa odpowiedź:

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

Aby uzyskać więcej informacji, zobacz Zarządzanie tagami prawnymi.

Dodawanie użytkowników do grupy uprawnień

Aby użytkownicy mieli odpowiednie uprawnienia do wykonywania wywołań API Petrel DDMS, muszą należeć do grupy uprawnień users.datalake.admins@{data-partition-id}.dataservices.energy. To wywołanie dodaje użytkownika do odpowiedniej grupy.

Użytkownik w tym przypadku to identyfikator klienta lub OID w tokenie używanym do uwierzytelniania. Jeśli na przykład wygenerujesz token przy użyciu identyfikatora 8cdxxxxxxxxxxxx, musisz dodać 8cdxxxxxxxxxxxx do grupy users.datalake.admins. Postępuj zgodnie z przewodnikiem Zarządzanie użytkownikami , aby dodać odpowiednie uprawnienia dla użytkownika .

Zdobądź projekt

Użyj identyfikatora projektu, aby zwrócić odpowiedni zapis projektu Petrel w platformie Azure Data Manager for Energy.

API

Usuwanie projektu

Użyj identyfikatora projektu, aby usunąć projekt i skojarzone dane rekordu projektu Petrel w wystąpieniu usługi Azure Data Manager for Energy.

API

Pobieranie wersji projektu

Użyj identyfikatora projektu i identyfikatora wersji, aby uzyskać rekord Petrel dla wersji skojarzony z projektem i wersją w usłudze Azure Data Manager for Energy.

API

Uzyskaj adres URL projektu

Użyj identyfikatora projektu, aby uzyskać adres URL z sygnaturą współdzielonego dostępu (SAS), co umożliwi pobranie danych odpowiedniego projektu z wystąpienia usługi Azure Data Manager for Energy.

API

Uzyskaj adres URL przesyłania projektu

Użyj identyfikatora projektu, aby uzyskać dwa SAS URL-e. Jeden adres URL przekazuje dane do odpowiedniego projektu w wystąpieniu usługi Azure Data Manager for Energy. Drugi adres URL pobiera dane z odpowiedniego projektu w wystąpieniu usługi Azure Data Manager for Energy.

API

Adres URL przesyłania SAS powinien wyglądać na przykład tak:

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

Możesz zmodyfikować ten adres URL tak, aby zawierał nazwę pliku danych, które chcesz przekazać:

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

Wywołanie tego adresu URL powoduje przekazanie zawartości PUT do magazynu obiektów blob zgodnie z podaną body wartością.

Aktualizacja projektu

Użyj identyfikatora projektu i adresu URL przesyłania SAS, aby zaktualizować rekord projektu Petrel w usłudze Azure Data Manager for Energy nowymi wartościami. Możesz również przekazać dane do projektu, jeśli chcesz.

API

Wyszukiwanie w projektach

Możesz przeszukiwać projekty Petrel przy użyciu wielu pól. Wywołanie zwraca wszystkie pasujące ID projektów. Interfejs API wyszukiwania obsługuje:

  • Wyszukiwanie pełnotekstowe w polach tekstowych.
  • Zakres zapytań opartych na polach daty, liczbowych lub ciągów.
  • Wyszukiwanie geoprzestrzenne.

API

Treści powiązane

Skorzystaj z poniższych linków DELFI, aby przeczytać inne samouczki dotyczące Eksploratora projektów Petrel oraz przepływów pracy w Petrel.

  • Ostatnia aktualizacja o