Compartir a través de

Tutorial: Trabajar con registros de datos de Petrel mediante las API de Petrel DDMS

Use las API de Petrel Domain Data Management Services (DDMS) para trabajar con datos de Petrel en la instancia de Azure Data Manager for Energy.

En este tutorial, aprenderá a :

  • Generar un token de autorización.
  • Use las API de Petrel DDMS para trabajar con los registros de datos y los proyectos de Petrel.

Para más información sobre DDMS, consulte Conceptos de DDMS.

Prerequisites

Obtención de detalles para la instancia de Azure Data Manager for Energy

Para este tutorial, necesitarás los parámetros siguientes:

Parameter Valor que se usará Example Dónde encontrar este valor
DNS URI <instance>.energy.azure.com Busca este valor en la página de información general de la instancia de Azure Data Manager for Energy.
data-partition-id Data partition <data-partition-id> Busque este valor en la sección Partición de datos dentro de la instancia de Azure Data Manager for Energy.
access_token Valor del token de acceso 0.ATcA01-XWHdJ0ES-qDevC6r........... Siga Cómo generar el token de autenticación para crear un token de acceso y guardarlo.

Sigue la guía de Administración de usuarios para agregar los derechos adecuados para el usuario que ejecuta este tutorial.

Configuración del entorno

Asegúrese de que ha cURL instalado en el sistema para realizar llamadas API.

Uso de las API de Petrel DDMS para trabajar con proyectos de Petrel

Completar correctamente las llamadas API que están presentes en swagger indica una interacción correcta con los proyectos de Petrel guardados. Aunque la API proporciona una manera de cargar datos, se recomienda cargar los proyectos mediante ELFI Petrel Project Explorer. Todas las siguientes llamadas API suponen que tiene un proyecto cargado en el Explorador de proyectos de Petrel.

Cree una etiqueta legal que pueda usar para el cumplimiento de datos.

Ejecute el comando siguiente cURL para crear una etiqueta legal:

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

Sample Response:

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

Para obtener más información, consulte Administración de etiquetas legales.

Agregar usuarios a un grupo de derechos

Para que los usuarios tengan los permisos adecuados para realizar llamadas API de Petrel DDMS, deben formar parte del users.datalake.admins@{data-partition-id}.dataservices.energy grupo de derechos. Esta llamada agrega un usuario al grupo adecuado.

El usuario en este caso es el identificador de cliente o OID en el token que se usa para la autenticación. Por ejemplo, si genera un token mediante un identificador de cliente de 8cdxxxxxxxxxxxx, debe agregar 8cdxxxxxxxxxxxx al users.datalake.admins grupo. Siga la guía Administrar usuarios para agregar los derechos adecuados para el usuario.

Obtener un proyecto

Use un identificador de proyecto para devolver el registro de proyecto de Petrel correspondiente en la instancia de Azure Data Manager for Energy.

API

Eliminación de un proyecto

Use un identificador de proyecto para eliminar un proyecto y los datos de registro de proyecto de Petrel asociados en la instancia de Azure Data Manager for Energy.

API

Obtener una versión del proyecto

Use un identificador de proyecto y un identificador de versión para obtener el registro de versión de Petrel asociado al proyecto y la versión de la instancia de Azure Data Manager for Energy.

API

Obtener una dirección URL de descarga del proyecto

Use un identificador de proyecto para obtener una dirección URL de firma de acceso compartido (SAS) para que pueda descargar los datos del proyecto correspondiente desde la instancia de Azure Data Manager for Energy.

API

Obtener una dirección URL de carga del proyecto

Use un identificador de proyecto para obtener dos direcciones URL de SAS. Una dirección URL carga datos en el proyecto correspondiente en la instancia de Azure Data Manager for Energy. La otra dirección URL descarga datos del proyecto correspondiente en la instancia de Azure Data Manager for Energy.

API

La dirección URL de carga de SAS debe tener un aspecto similar al de este ejemplo:

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

Puede modificar esta dirección URL para que contenga el nombre de archivo de los datos que desea cargar:

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

Al realizar una PUT llamada a esta dirección URL, se carga el contenido de en el almacenamiento de body blobs en el valor proporcionado FILENAME .

Actualizar un proyecto

Use un identificador de proyecto y una dirección URL de carga de SAS para actualizar un registro de proyecto de Petrel en Azure Data Manager for Energy con los nuevos valores. También puede cargar datos en un proyecto si lo desea.

API

Buscar en proyectos

Puede buscar en proyectos de Petrel mediante muchos campos. La llamada devuelve todos los identificadores de proyecto coincidentes. Search API admite:

  • Búsqueda de texto completo en campos de cadena.
  • Consultas de intervalo basadas en campos de fecha, numérico o cadena.
  • Geospatial search.

API

Related content

Use los siguientes vínculos DELFI para leer otros tutoriales que implican el Explorador de proyectos de Petrel y los flujos de trabajo de Petrel:

  • Last updated on