Tutoriel : Utiliser des enregistrements de données Petrel à l’aide des API DDMS Petrel

Utilisez les API Petrel Domain Gestion des données Services (DDMS) pour utiliser des données Petrel dans votre instance d’Azure Data Manager for Energy.

Dans ce tutoriel, vous allez apprendre à :

  • Générez un jeton d’autorisation.
  • Utilisez les API DDMS Petrel pour utiliser des enregistrements et des projets de données Petrel.

Pour plus d’informations sur DDMS, consultez Concepts DDMS.

Prerequisites

Obtenir des détails pour l’instance Azure Data Manager for Energy

Pour ce tutoriel, vous avez besoin des paramètres suivants :

Parameter Valeur à utiliser Example Où trouver cette valeur
DNS URI <instance>.energy.azure.com Recherchez cette valeur dans la page vue d’ensemble de l’instance Azure Data Manager for Energy.
data-partition-id Partition des données <data-partition-id> Recherchez cette valeur dans la section Partition de données dans l’instance Azure Data Manager for Energy.
access_token Valeur du jeton d’accès 0.ATcA01-XWHdJ0ES-qDevC6r........... Suivez comment générer un jeton d’authentification pour créer un jeton d’accès et l’enregistrer.

Suivez le guide Gérer les utilisateurs pour ajouter les droits appropriés pour l’utilisateur qui exécute ce didacticiel.

Configurer votre environnement

Vérifiez que vous avez cURL installé sur votre système pour effectuer des appels d’API.

Utiliser les API DDMS Petrel pour travailler avec des projets Petrel

La réussite des appels d’API présents dans Swagger indique une interaction réussie avec vos projets Petrel enregistrés. Bien que l’API offre un moyen de charger des données, nous vous recommandons de charger vos projets via DELFI Petrel Project Explorer. Tous les appels d’API suivants supposent que vous avez un projet chargé dans l’Explorateur de projets Petrel.

Créez une balise légale que vous pouvez utiliser pour la conformité des données.

Exécutez la commande suivante cURL pour créer une balise légale :

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

Exemple de réponse :

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

Pour plus d’informations, consultez Gérer les balises légales.

Ajouter des utilisateurs à un groupe de droits d’utilisation

Pour que les utilisateurs disposent des autorisations appropriées pour effectuer des appels d’API Petrel DDMS, ils doivent faire partie du groupe de droits d’utilisation users.datalake.admins@{data-partition-id}.dataservices.energy . Cet appel ajoute un utilisateur au groupe approprié.

Dans ce cas, l’utilisateur est l’ID client ou l’OID dans le jeton utilisé pour l’authentification. Par exemple, si vous générez un jeton à l’aide d’un ID client de 8cdxxxxxxxxxxxx, vous devez ajouter 8cdxxxxxxxxxxxx au users.datalake.admins groupe. Suivez le guide Gérer les utilisateurs pour ajouter les droits appropriés pour l’utilisateur.

Obtenir un projet

Utilisez un ID de projet pour renvoyer l’enregistrement de projet Petrel correspondant dans votre instance Azure Data Manager for Energy.

API

Supprimer un projet

Utilisez un ID de projet pour supprimer un projet et les données d’enregistrement de projet Petrel associées dans votre instance Azure Data Manager for Energy.

API

Obtenir une version de projet

Utilisez un ID de projet et un ID de version pour obtenir l’enregistrement de version Petrel associé au projet et à la version dans votre instance Azure Data Manager for Energy.

API

Obtenir une URL de téléchargement de projet

Utilisez un ID de projet pour obtenir une URL de signature d’accès partagé (SAP) afin de pouvoir télécharger les données du projet correspondant à partir de votre instance Azure Data Manager for Energy.

API

Obtenir une URL de chargement de projet

Utilisez un ID de projet pour obtenir deux URL SAS. Une URL charge les données dans le projet correspondant dans votre instance Azure Data Manager for Energy. L’autre URL télécharge les données à partir du projet correspondant dans votre instance Azure Data Manager for Energy.

API

Votre URL de chargement SAS doit ressembler à cet exemple :

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

Vous pouvez modifier cette URL pour contenir le nom de fichier des données que vous souhaitez charger :

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

L’appel de PUT à cette URL entraîne le chargement du contenu de body vers le service Stockage Blob sous la valeur FILENAME fournie.

Mettre à jour un projet

Utilisez un ID de projet et une URL de chargement SAS pour mettre à jour un enregistrement de projet Petrel dans Azure Data Manager for Energy avec les nouvelles valeurs. Vous pouvez également charger des données dans un projet si vous le souhaitez.

API

Rechercher dans des projets

Vous pouvez effectuer des recherches dans des projets Petrel à l’aide de nombreux champs. L’appel retourne tous les ID de projet correspondants. L’API De recherche prend en charge :

  • Recherche en texte intégral sur les champs de chaîne.
  • Requêtes de plage basées sur des champs date, numérique ou chaîne.
  • Recherche géospatiale.

API

Contenu connexe

Utilisez les liens DELFI suivants pour lire d’autres didacticiels qui impliquent l’Explorateur de projets Petrel et les flux de travail Petrel :

  • Last updated on