Condividi tramite

Esercitazione: Usare gli endpoint api Websocket DDMS di Reservoir

  • Articolo

Usare le API DDMS (Reservoir Domain domain Gestione dati Services) in PowerShell per usare i dati del serbatoio in una risorsa di Azure Data Manager per l'energia.

In questa esercitazione si apprenderà come usare un endpoint websocket DDMS di Reservoir per:

  • Creare lo spazio dati.
  • Ottenere lo spazio dati.
  • Inserire un file EPC.
  • Accedere ai dati inseriti.
  • Eliminare lo spazio dati.

Per altre informazioni su DDMS, vedere Concetti relativi a DDMS.

Prerequisiti

Impostazione

  1. Per connettersi a un server remoto tramite WSS, è necessario un client abilitato per ETP SSL. Scaricare un client SSL di precompilazione dal registro contenitori Docker gitLab osDU.

    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. Seguire How to generate auth token (Come generare un token di autenticazione) per creare un token di autenticazione valido. Questo token viene usato per autenticare le chiamate al server.

  3. Imposta le variabili seguenti:

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

Uso degli endpoint websocket

  1. Creare lo spazio dati:

    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. Ottenere lo spazio dati:

    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. Inserire un file 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. Accedere ai dati inseriti:

    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. Eliminare lo spazio dati:

    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}

Contenuto correlato