Поделиться через


Руководство. Работа с хорошо записями данных с помощью API-интерфейсов DDMS для доставки

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

В этом руководстве описано следующее:

  • Настройте Postman для использования коллекции Well Delivery DDMS.
  • Настройте Postman для использования среды DDMS хорошой доставки.
  • Отправка запросов через Postman.
  • Создайте маркер авторизации.
  • Используйте API-интерфейсы DDMS для хорошой доставки данных.

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

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

Получение сведений об экземпляре Azure Data Manager для энергетики

Первым шагом является получение следующих сведений из экземпляра Azure Data Manager для энергии в портал Azure:

Параметр Значение Пример
CLIENT_ID Идентификатор приложения (клиент) 00001111-aaaa-2222-bbbb-3333cccc4444
CLIENT_SECRET Секреты клиента _fl******************
TENANT_ID Идентификатор каталога (клиента) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE Идентификатор приложения (клиент) 00001111-aaaa-2222-bbbb-3333cccc4444
base_uri URI-адрес <instance>.energy.azure.com
data-partition-id Секции данных <data-partition-id>

Эти сведения будут использоваться далее в руководстве.

Настройка Postman

  1. Скачайте и установите классическое приложение Postman .

  2. Импортируйте следующие файлы в Postman:

    Чтобы импортировать файлы, выполните следующие действия.

    1. Создайте два JSON-файла на компьютере путем копирования данных, содержащихся в файлах коллекции и среды.

    2. В Postman выберите импорт файлов>>выбора файлов, а затем выберите два JSON-файла на компьютере.

    3. В разделе "Импорт сущностей " в Postman выберите "Импорт".

      Снимок экрана: импорт коллекций и файлов среды.

  3. В среде Postman обновите CURRENT VALUE с информацией из экземпляра Azure Data Manager для энергетики:

    1. В Postman в меню слева выберите "Среды" и выберите "Среда WellDelivery".

    2. В столбце CURRENT VALUE введите сведения из таблицы в разделе "Получение сведений об экземпляре Azure Data Manager для энергии" этого руководства.

    Снимок экрана, на котором показано, где ввести текущие значения в среде

Отправка запроса Postman

Коллекция Postman для DDMS "Хорошо доставка" содержит запросы, которые можно использовать для взаимодействия с данными о скважинах, скважинах, журналах и траектории в экземпляре Azure Data Manager для энергетики.

Пример отправки запроса Postman см. в руководстве по Wellbore DDMS.

Создание маркера для API

Создайте маркер, который можно использовать для работы с API-интерфейсами DDMS для хорошой доставки:

  1. Импортируйте следующую команду cURL в Postman для создания маркера носителя. Используйте значения из экземпляра Azure Data Manager для энергетики.

     curl --location --request POST 'https://login.microsoftonline.com/{{TENANT_ID}}/oauth2/v2.0/token' \
         --header 'Content-Type: application/x-www-form-urlencoded' \
         --data-urlencode 'grant_type=client_credentials' \
         --data-urlencode 'client_id={{CLIENT_ID}}' \
         --data-urlencode 'client_secret={{CLIENT_SECRET}}' \
         --data-urlencode 'scope={{SCOPE}}'  
    

    Снимок экрана: код cURL в маркере DDMS хорошой доставки.

  2. Используйте выходные данные маркера для обновления access_token в среде DDMS хорошой доставки. Затем маркер носителя можно использовать в качестве типа авторизации в других вызовах API.

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

Успешное завершение запросов Postman, описанных в следующих API-интерфейсах DDMS для доставки, указывает на успешное прием и получение записей хорошо в экземпляре Azure Data Manager для энергетики.

Создание хорошой записи

Создайте запись в экземпляре Azure Data Manager для энергетики.

API: UC1>entity_create хорошо

Метод: PUT

Снимок экрана: API, создающий хорошо записанную запись.

Создание записи wellbore

Создайтезаписьную запись в экземпляре Azure Data Manager для энергетики.

API: UC1>entity_create wellbore

Метод: PUT

Снимок экрана, на котором показан API, создающий запись хорошого метода.

Получение хорошой версии

Получение хорошой записи на основе определенного идентификатора.

API: UC1>entity_create хорошо Копировать

Метод: GET

Снимок экрана: API, который получает хорошо запись на основе определенного идентификатора.

Создание плана действий

Создайте план действий.

API: план действий entity_create UC1>

Метод: PUT

Снимок экрана: API, создающий план действий.

Получение плана действий по идентификатору

Получите объект плана действий для определенного идентификатора хорошо.

API: UC2>activity_plans_by_well

Метод: GET

Снимок экрана: API, который получает план действий по идентификатору.

Удаление записи wellbore

Вы можете удалить запись скважины в экземпляре Azure Data Manager для энергетики с помощью API-интерфейсов DDMS для хорошой доставки. На следующем снимке экрана показан пример.

Снимок экрана, на котором показано, как использовать API для удаления записи wellbore.

Удаление хорошой записи

Вы можете удалить запись в экземпляре Azure Data Manager для энергетики с помощью API-интерфейсов DDMS для хорошой доставки. На следующем снимке экрана показан пример.

Снимок экрана: использование API для удаления хорошой записи.

Следующие шаги

Перейдите к следующему руководству, чтобы узнать, как работать с хорошо данными с помощью API Wellbore DDMS: