Zelfstudie: Reservoir DDMS websocket-API-eindpunten gebruiken

Gebruik DDMS-API's (Reservoir Domain Gegevensbeheer Services) in PowerShell om te werken met reservoirgegevens in een Azure Data Manager for Energy-resource.

In deze zelfstudie leert u hoe u een Reservoir DDMS-websocket-eindpunt gebruikt voor:

Zie DDMS-concepten voor meer informatie over DDMS.

Vereisten

• Azure Data Manager for Energy-resource die is gemaakt in uw Azure-abonnement
• Docker-desktopclient moet worden uitgevoerd op uw systeem

Configuratie

1. Als u via WSS verbinding wilt maken met een externe server, hebt u een ETP SSL-client nodig. Download een vooraf gebouwde SSL-client uit het Docker-containerregister van 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. Volg Hoe u een verificatietoken genereert om een geldig verificatietoken te maken. Dit token wordt gebruikt om de aanroepen naar de server te verifiëren.

3. Stel de volgende variabelen in:

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

De websocket-eindpunten gebruiken

1. Maak de gegevensruimte:

   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} --xdata "{\"viewers\":[\"data.default.viewers@<data_partition_name>.dataservices.energy\"],\"owners\":[\"data.default.owners@<data_partition_name>.dataservices.energy\"],\"legaltags\":\"<legal_tag_name>\",\"otherRelevantDataCountries\":[\"<country_code1\", \"country_code2\"]}"
   

2. Haal de gegevensruimte op:

   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. Een EPC-bestand opnemen:

   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. Toegang tot de opgenomen gegevens:

   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. Verwijder de gegevensruimte:

   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}
   

Gerelateerde inhoud

• RDDMS-websockets gebruiken
• Reservoir DDMS-API's gebruiken