자습서: Well Delivery DDMS API를 사용하여 유정 데이터 레코드 작업

아티클
02/23/2024

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	`3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx`
`CLIENT_SECRET`	클라이언트 암호	`_fl******************`
`TENANT_ID`	디렉터리(테넌트) ID	`72f988bf-86f1-41af-91ab-xxxxxxxxxxxx`
`SCOPE`	애플리케이션(클라이언트) ID	`3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx`
`base_uri`	URI	`<instance>.energy.azure.com`
`data-partition-id`	데이터 파티션	`<instance>-<data-partition-name>`

이 정보는 자습서의 뒷부분에서 사용합니다.

Postman 설정

Postman 데스크톱 앱을 다운로드하고 설치합니다.
Postman에서 다음 파일을 가져옵니다.
- Well Delivery DDMS Postman 컬렉션
- Well Delivery DDMS Postman 환경
파일을 가져오려면:
1. 컬렉션 및 환경 파일에 있는 데이터를 복사하여 컴퓨터에 두 개의 JSON 파일을 만듭니다.
2. Postman에서 가져오기>파일>파일 선택을 선택한 다음 컴퓨터에서 두 개의 JSON 파일을 선택합니다.
3. Postman의 항목 가져오기에서 가져오기를 선택합니다.
Postman 환경에서 Azure Data Manager for Energy 인스턴스 정보로 CURRENT VALUE를 업데이트합니다.
1. Postman의 왼쪽 메뉴에서 환경을 선택한 다음, WellDelivery 환경을 선택합니다.
2. 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}}'