자습서: Well Delivery DDMS API를 사용하여 유정 데이터 레코드 작업
Postman에서 Well Delivery DDMS(Domain Data Management Services) API를 사용하여 Azure Data Manager for Energy 인스턴스의 유정 데이터를 작업합니다.
이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.
- Well Delivery DDMS 컬렉션을 사용하도록 Postman을 설정합니다.
- Well Delivery DDMS 환경을 사용하도록 Postman을 설정합니다.
- Postman을 통해 요청을 보냅니다.
- 권한 부여 토큰을 생성합니다.
- Well Delivery DDMS API를 사용하여 유정 데이터 레코드를 작업합니다.
DDMS에 대한 자세한 내용은 DDMS 개념을 참조하세요.
필수 조건
- Azure 구독
- Azure 구독에서 만들어진 Azure Data Manager for Energy 인스턴스
Azure Data Manager for Energy 인스턴스 세부 정보 가져오기
첫 번째 단계는 Azure Portal의 Azure Data Manager for Energy 인스턴스에서 다음 정보를 가져오는 것입니다.
| 매개 변수 | 값 | 예제 |
|---|---|---|
CLIENT_ID |
애플리케이션(클라이언트) ID | 00001111-aaaa-2222-bbbb-3333cccc4444 |
CLIENT_SECRET |
클라이언트 암호 | _fl****************** |
TENANT_ID |
디렉터리(테넌트) ID | 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx |
SCOPE |
애플리케이션(클라이언트) ID | 00001111-aaaa-2222-bbbb-3333cccc4444 |
base_uri |
URI | <instance>.energy.azure.com |
data-partition-id |
데이터 파티션 | <instance>-<data-partition-name> |
이 정보는 자습서의 뒷부분에서 사용합니다.
Postman 설정
Postman 데스크톱 앱을 다운로드하고 설치합니다.
Postman에서 다음 파일을 가져옵니다.
파일을 가져오려면:
컬렉션 및 환경 파일에 있는 데이터를 복사하여 컴퓨터에 두 개의 JSON 파일을 만듭니다.
Postman에서 가져오기>파일>파일 선택을 선택한 다음 컴퓨터에서 두 개의 JSON 파일을 선택합니다.
Postman의 항목 가져오기에서 가져오기를 선택합니다.
Postman 환경에서 Azure Data Manager for Energy 인스턴스 정보로 CURRENT VALUE를 업데이트합니다.
Postman의 왼쪽 메뉴에서 환경을 선택한 다음, WellDelivery 환경을 선택합니다.
CURRENT VALUE 열에서 이 자습서의 Azure Data Manager for Energy 인스턴스 세부 정보 가져오기 섹션에 있는 테이블의 정보를 입력합니다.
Postman 요청 보내기
Well Delivery DDMS용 Postman 컬렉션에는 Azure Data Manager for Energy 인스턴스의 유정, 유정 시추공, 유정 로그, 유정 궤도에 대한 데이터와 상호 작용하는 데 사용할 수 있는 요청이 포함됩니다.
Postman 요청을 보내는 방법에 대한 예제는 Wellbore DDMS 자습서를 참조하세요.
API용 토큰 생성
Well Delivery DDMS API 작업에 사용할 수 있는 토큰을 생성합니다.
전달자 토큰을 생성하려면 Postman에서 다음 cURL 명령을 가져옵니다. Azure Data Manager for Energy 인스턴스의 값을 사용합니다.
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}}'
토큰 출력을 사용하여 Well Delivery DDMS 환경에서
access_token을 업데이트합니다. 그런 다음, 전달자 토큰을 다른 API 호출에서 권한 부여 유형으로 사용할 수 있습니다.
Well Delivery DDMS API를 사용하여 유정 데이터 레코드 작업
다음 Well Delivery DDMS API에 설명된 Postman 요청을 성공적으로 완료하면 Azure Data Manager for Energy 인스턴스의 유정 레코드를 성공적으로 수집하고 검색한 것입니다.
유정 레코드 만들기
Azure Data Manager for Energy 인스턴스에서 유정 레코드를 만듭니다.
API: UC1>entity_create well
메서드: PUT
유정 시추공 레코드 만들기
Azure Data Manager for Energy 인스턴스에서 유정 시추공 레코드를 만듭니다.
API: UC1>entity_create wellbore
메서드: PUT
유정 버전 가져오기
특정 유정 ID를 기반으로 유정 레코드를 가져옵니다.
API: UC1>entity_create well Copy
메서드: GET
작업 계획 만들기
작업 계획을 만듭니다.
API: UC1>entity_create activityplan
메서드: PUT
유정 ID로 작업 계획 가져오기
특정 유정 ID에 대한 작업 계획 개체를 가져옵니다.
API: UC2>activity_plans_by_well
메서드: GET
유정 시추공 레코드 삭제
Well Delivery DDMS API를 사용하여 Azure Data Manager for Energy 인스턴스의 유정 시추공 레코드를 삭제할 수 있습니다. 다음 스크린샷은 예제를 보여 줍니다.
유정 레코드 삭제
Well Delivery DDMS API를 사용하여 Azure Data Manager for Energy 인스턴스의 유정 레코드를 삭제할 수 있습니다. 다음 스크린샷은 예제를 보여 줍니다.
다음 단계
다음 자습서로 이동하여 Wellbore DDMS API를 사용하여 유정 데이터로 작업하는 방법을 알아봅니다.