Руководство. Использование конечных точек API websocket для хранилища DDMS

Используйте API-интерфейсы доменных Управление данными служб (DDMS) в PowerShell для работы с данными резервуара в диспетчере данных Azure для энергетического ресурса.

В этом руководстве вы узнаете, как использовать конечную точку Websocket для водохранилища DDMS:

Дополнительные сведения о DDMS см . в концепциях DDMS.

Необходимые компоненты

• Ресурс Azure Data Manager для энергетики , созданный в подписке Azure
• Классический клиент Docker должен работать в системе.

Настройка

1. Чтобы подключиться к удаленному серверу через WSS, требуется клиент с поддержкой ПРОТОКОЛА SSL ETP. Скачайте ssl-клиент предварительной сборки из реестра контейнеров docker 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. Следуйте инструкциям по созданию маркера проверки подлинности для создания допустимого маркера проверки подлинности. Этот маркер используется для проверки подлинности вызовов сервера.

3. Задайте следующие переменные:

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

Использование конечных точек websocket

1. Создайте пространство данных:

   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. Получите пространство данных:

   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. Прием 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. Доступ к данным приема:

   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. Удалите пространство данных:

   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}
   

Связанный контент

• Использование конечных точек веб-сокета RDDMS
• Использование API-интерфейсов DDMS для водохранилища