Compartir vía

Tutorial: Trabajo con los registros de datos de Petrel mediante las API de Petrel DDMS

  • Artículo

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

En este tutorial, aprenderá a:

  • Configurar Postman para usar una colección de Petrel DDMS.
  • Configurar Postman para usar un entorno de Petrel DDMS.
  • Enviar solicitudes a través de Postman.
  • Generar un token de autorización.
  • Use las API de Petrel DDMS para trabajar con los registros y proyectos de datos de Petrel.

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

Requisitos previos

Obtener los detalles de la instancia de Azure Data Manager for Energy

El primer paso es obtener la siguiente información de la instancia de Azure Data Manager for Energy en Azure Portal:

Parámetro Valor Ejemplo
CLIENT_ID Id. de aplicación (cliente) 3dfxxxxxxxxxxxxxxxxxxxxxx
CLIENT_SECRET Secretos de cliente _fl******************
TENANT_ID Id. de directorio (inquilino) 72fxxxxxxxxxxxx
SCOPE Id. de aplicación (cliente) 3dfxxxxxxxxxxxxxxxxxxxxxxx
HOSTNAME URI <instance>.energy.azure.com
DATA_PARTITION_ID Particiones de datos <instance>-<data-partition-name>

Esta información se usará más adelante en el tutorial.

Configuración de Postman

  1. Descargue e instale la aplicación de escritorio Postman.

  2. Importe el siguiente archivo en Postman: colección de Postman Petrel DDMS.

  3. Cree un entorno de Postman mediante los valores obtenidos anteriormente. El entorno debería ser similar al que se muestra en este ejemplo:

    Screenshot that shows an example Postman environment.

Generación de un token que se va a usar en las API

La colección Postman para Petrel DDMS contiene solicitudes que puede usar para interactuar con los proyectos de Petrel. También contiene una solicitud para consultar los proyectos y registros actuales de Petrel en la instancia de Azure Data Manager for Energy.

  1. En Postman, en el menú de la izquierda, seleccione Colecciones y, a continuación, seleccione Petrel DDMS. En Configuración, seleccione Obtener un token.

  2. En la lista desplegable de entornos de la esquina superior derecha, seleccione Entorno Petrel DDMS.

  3. Para enviar la solicitud, seleccione Enviar.

Esta solicitud generará un token de acceso y lo asignará como método de autorización para solicitudes futuras.

También puede generar un token mediante el comando cURL en Postman o un terminal para generar un token de portador. Use los valores de la instancia de Azure Data Manager for Energy.

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

Para usar este token generado por cURL, debe actualizar access_token en las variables Collection con el valor después de Bearer en la respuesta.

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

Completar correctamente las solicitudes de Postman que se describen en las siguientes API de Petrel DDMS 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 Petrel Project Explorer.

Cree una etiqueta legal que se agregue automáticamente al entorno de Petrel DDMS para el cumplimiento de datos.

API: Configurar>Crear etiqueta legal para PDS

Método: POST

Screenshot that shows the API that creates a legal tag.

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

Adición de 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 grupo de derechos users.datalake.admins@{data-partition-id}.dataservices.energy. Esta llamada agrega un usuario a los grupos adecuados.

El usuario en este caso es el identificador de cliente u 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 grupo users.datalake.admins.

API: Configuración>Agregar usuario a Administradores de DATALAKE

Método: POST

Screenshot that shows the API that adds user to entitlements.

Obtener un proyecto

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

API: Proyecto>Obtener proyecto

Método: GET

Screenshot that shows the API that gets a project.

Eliminar un proyecto

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

API: Proyecto>Eliminar proyecto

Método: DELETE

Screenshot that shows the API that deletes a project.

Obtención de 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: Proyecto>Obtener versión de proyecto

Método: GET

Screenshot that shows the API that gets a project version.

Obtención de 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: Proyecto>Obtener descarga de proyecto

Método: GET

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

Obtención de una dirección URL de carga de 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: Proyecto>Obtener dirección URL de carga firmada

Método: POST

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

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 llamada PUT a esta dirección URL, se carga el contenido de body en el almacenamiento de 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: Proyecto>Actualizar proyecto

Método: PUT

Screenshot that shows the API that updates a project.

Búsqueda en proyectos

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

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

API: Proyecto>Buscar proyectos

Método: POST

Screenshot that shows the API that deletes a well record.

Contenido relacionado

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