Compartir vía

Tutorial: Uso de registros de datos de pozos mediante las API de Wellbore DDMS

  • Artículo

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

En este tutorial, aprenderá a:

  • Configurar Postman para usar una colección de Wellbore DDMS.
  • Configurar Postman para usar entorno de Wellbore DDMS.
  • Enviar solicitudes a través de Postman.
  • Generar un token de autorización.
  • Usar las API de Wellbore DDMS para trabajar con registros de datos de pozos.

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) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
client_secret Secretos de cliente _fl******************
tenant_id Id. de directorio (inquilino) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL https://<instance>.energy.azure.com
data-partition-id Particiones de datos <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 los archivos siguientes a Postman:

    Para importar los archivos:

    1. Seleccione Importar en Postman.

      Screenshot that shows the Import button in Postman.

    2. Pegar la dirección URL de cada archivo en el cuadro de búsqueda.

      Screenshot that shows importing collection and environment files in Postman via URL.

  3. En el entorno de Postman, actualice Valor actual con la información de los detalles de la instancia de Azure Data Manager for Energy:

    1. En Postman, en el menú de la izquierda, seleccione Entornos y, luego, elija Entorno Wellbore DDMS.

    2. En la columna Valor actual, escriba la información de la tabla en la sección Obtención de los detalles de la instancia de Azure Data Manager for Energy de este tutorial.

    Screenshot that shows where to enter current values in the Wellbore DDMS environment.

Envío de una solicitud de Postman de ejemplo

La colección de Postman para Wellbore DDMS contiene solicitudes que puede usar para interactuar con los datos sobre pozos, recintos de pozos, registros de pozos y trayectoria de los pozos en la instancia de Azure Data Manager for Energy.

  1. En Postman, en el menú de la izquierda, seleccione Colecciones y, luego, elija Wellbore DDMS. En Configuración, seleccione Obtener un token de SPN.

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

    Screenshot that shows selections for getting an SPN token and choosing an environment.

  3. Para enviar la solicitud, seleccione Enviar.

    Screenshot that shows the Send button for a request in Postman.

  4. La solicitud valida el código de respuesta de la API real en el código de respuesta esperado. Seleccione la pestaña Resultados de la prueba para ver si la solicitud se realizó correctamente o no.

    Ejemplo de una llamada a Postman correcta:

    Screenshot that shows success for a Postman call.

    Ejemplo de una llamada a Postman errónea:

    Screenshot that shows failure for a Postman call.

Uso de las API de Wellbore DDMS para trabajar con registros de datos de pozos

La finalización correcta de las solicitudes de Postman que se describen en las siguientes API de Wellbore DDMS indica una ingesta y una recuperación correctas de los registros de pozos en la instancia de Azure Data Manager for Energy.

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

API: Configurar>Crear etiqueta legal para WDMS

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.

Creación de un registro de pozo

Cree un registro de los pozos en la instancia de Azure Data Manager for Energy.

API: Pozo>Crear pozo

Método: POST

Screenshot that shows the API that creates a well record.

Obtención de un registro de pozo

Obtenga los datos de registro del pozo para la instancia de Azure Data Manager for Energy.

API: Pozo>Pozo por id.

Método: GET

Screenshot that shows the API that gets a well record by ID.

Obtención de versiones de pozos

Obtenga las versiones de cada registro de pozo ingerido en la instancia de Azure Data Manager for Energy.

API: Pozo>Versiones de pozo

Método: GET

Screenshot that shows the API that gets all well versions.

Obtención de una versión de pozo específica

Obtenga los detalles de una versión específica de un registro de pozo específico en la instancia de Azure Data Manager for Energy.

API: Pozo>Versión específica de pozo

Método: GET

Screenshot that shows the API that gets a specific well version.

Eliminación de un registro de pozo

Elimine un registro de pozo específico de la instancia de Azure Data Manager for Energy.

API: Limpiar>Registro de pozo

Método: DELETE

Screenshot that shows the API that deletes a well record.

Paso siguiente

Lea el siguiente tutorial para aprender a usar la herramienta de línea de comandos sdutil para cargar datos sísmicos en Seismic Store:

Tutorial: Uso de sdutil para cargar datos en Seismic Store