Compartir vía

Tutorial: Uso de puntos de conexión de la API de websocket de Reservoir DDMS

  • Artículo

Use las API de Reservoir Domain Data Management Services (DDMS) en PowerShell para el uso de los datos de depósito en un recurso de Azure Data Manager for Energy.

En este tutorial, aprenderá a usar un punto de conexión de WebSocket de Reservoir DDMS para:

  • Crear el espacio de datos.
  • Obtener el espacio de datos.
  • Ingerir un archivo EPC.
  • Acceder a los datos ingeridos.
  • Eliminar el espacio de datos.

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

Requisitos previos

Configuración

  1. Para conectarse a un servidor remoto a través de WSS, necesita un cliente habilitado para ETP SSL. Descargue un cliente SSL precompilado desde el registro de contenedor Docker de OSDU GitLab.

    export SSLCLIENT_IMAGE=community.opengroup.org:5555/osdu/platform/domain-data-mgmt-services/reservoir/open-etp-server/open-etp-sslclient-main
docker pull ${SSLCLIENT_IMAGE}
docker tag ${SSLCLIENT_IMAGE} open-etp:ssl-client

  2. Siga los pasos que se indican en Cómo generar un token de autenticación para crear un token de actualización válido. Este token se usa para autenticar las llamadas al servidor.

  3. Configure las siguientes variables:

    $RDDMS_URL='<adme_dns>/api/reservoir-ddms-etp/v2/'
$PARTITION='<data_partition_name>'
$TOKEN='<access_token>'

Uso de los puntos de conexión de WebSocket

  1. Crear el espacio de datos:

    docker run -it --rm open-etp:ssl-client openETPServer space -S wss://${RDDMS_URL} --new -s <data_space_name> --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

  2. Obtener el espacio de datos:

    docker run -it --rm open-etp:ssl-client openETPServer space -S wss://${RDDMS_URL} -l --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

  3. Ingerir un archivo EPC:

    docker run -it --rm -v <path_to_directory_containing_epc_file>:/data open-etp:ssl-client openETPServer space -S wss://${RDDMS_URL} -s <dataspace_name> --import-epc ./data/<epc_file_name> --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

  4. Acceder a los datos ingeridos:

    docker run -it --rm open-etp:ssl-client openETPServer space -S wss://${RDDMS_URL} -s <dataspace_name> --stats --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

  5. Eliminar el espacio de datos:

    docker run -it --rm open-etp:ssl-client openETPServer space --delete -S wss://${RDDMS_URL} -s <dataspace_name> --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

Contenido relacionado