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:
- 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.
- Una suscripción de Azure
- Instancia de Azure Data Manager for Energy creada en la suscripción de Azure
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.
Descargue e instale la aplicación de escritorio Postman.
Importe el siguiente archivo en Postman: colección de Postman Petrel DDMS.
Cree un entorno de Postman mediante los valores obtenidos anteriormente. El entorno debería ser similar al que se muestra en este ejemplo:
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.
En Postman, en el menú de la izquierda, seleccione Colecciones y, a continuación, seleccione Petrel DDMS. En Configuración, seleccione Obtener un token.
En la lista desplegable de entornos de la esquina superior derecha, seleccione Entorno Petrel DDMS.
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.
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
Para obtener más información, vea Administración de etiquetas legales.
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
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
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
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
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
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
.
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
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
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)