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

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:

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

Requisitos previos

• Una suscripción de Azure
• Instancia de Azure Data Manager for Energy creada en la suscripción de Azure

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:

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:

   

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.

Creación de una etiqueta legal

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

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

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

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

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

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

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

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

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

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:

• Introducción al Explorador de proyectos (slb.com)\
• Abrir un proyecto guardado en el Explorador de proyectos (slb.com)\
• Cargar datos ZGY de Petrel en el ecosistema de datos DELFI (slb.com)\
• Importar datos ZGY desde el ecosistema de datos DELFI a Petrel (slb.com)\
• Guardar un proyecto de Petrel en el Explorador de proyectos (slb.com)