Freigeben über

Tutorial: Verwenden von Reservoir DDMS-Websocket-API-Endpunkten

  • Artikel

Verwenden Sie die APIs für Reservoir Domain Data Management Services (DDMS) in PowerShell, um in einer Ressource von Azure Data Manager for Energy mit Reservoir-Daten zu arbeiten.

In diesem Tutorial erfahren Sie, wie Sie einen Reservoir-DDMS-Websocket-Endpunkt für folgende Aktionen verwenden:

  • Erstellen des Datenbereichs.
  • Abrufen des Datenbereichs.
  • Erfassen einer EPC-Datei.
  • Zugreifen auf die erfassten Daten.
  • Löschen des Datenbereichs.

Weitere Informationen zu DDMS finden Sie unter DDMS-Konzepte.

Voraussetzungen

  • Ressource von Azure Data Manager for Energy wurde in Ihrem Azure-Abonnement erstellt
  • Docker Desktop-Client sollte auf Ihrem System ausgeführt werden

Konfiguration

  1. Um eine Verbindung mit einem Remoteserver über WSS herzustellen, benötigen Sie einen ETP SSL-aktivierten Client. Laden Sie einen vordefinierten SSL-Client aus der OSDU GitLab-Docker-Containerregistrierung herunter.

    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. Befolgen Sie Erstellen eines Authentifizierungstokens zum Erstellen eines gültigen Authentifizierungstokens. Dieses Token wird verwendet, um die Aufrufe an den Server zu authentifizieren.

  3. Legen Sie die folgenden Variablen fest:

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

Verwenden der Websocket-Endpunkte

  1. Erstellen Sie den Datenbereich:

    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. Rufen Sie den Datenbereich ab:

    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. Erfassen Sie eine EPC-Datei:

    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. Greifen Sie auf die erfassten Daten zu:

    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. Löschen Sie den Datenbereich:

    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}

Zugehöriger Inhalt