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

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

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

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

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

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

• Подписка Azure
• Экземпляр Azure Data Manager для энергетики , созданный в подписке Azure

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

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

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

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

Настройка Postman

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

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

   • Коллекция Postman для доставки DDMS
   • Среда Postman для доставки DDMS

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

   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}}'  
   

   

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

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

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

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

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

API: UC1>entity_create хорошо

Метод: PUT

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

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

API: UC1>entity_create wellbore

Метод: PUT

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

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

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

Метод: GET

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

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

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

Метод: PUT

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

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

API: UC2>activity_plans_by_well

Метод: GET

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

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

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

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

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

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

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