자습서: Wellbore DDMS API를 사용하여 유정 데이터 레코드 작업
Postman에서 Wellbore DDMS(Domain Data Management Services) API를 사용하여 Azure Data Manager for Energy 인스턴스의 유정 데이터로 작업합니다.
이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.
- Wellbore DDMS 컬렉션을 사용하도록 Postman을 설정합니다.
- Wellbore DDMS 환경을 사용하도록 Postman을 설정합니다.
- Postman을 통해 요청을 보냅니다.
- 권한 부여 토큰을 생성합니다.
- Wellbore 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 |
base_url |
URL | https://<instance>.energy.azure.com |
data-partition-id |
데이터 파티션 | <data-partition-name> |
이 정보는 자습서의 뒷부분에서 사용합니다.
Postman 설정
Postman 데스크톱 앱을 다운로드하고 설치합니다.
Postman에서 다음 파일을 가져옵니다.
파일을 가져오려면:
Postman 환경에서 Azure Data Manager for Energy 인스턴스 세부 정보로 현재 값을 업데이트합니다.
Postman의 왼쪽 메뉴에서 Environments를 선택한 다음, Wellbore DDMS Environment를 선택합니다.
CURRENT VALUE 열에서 이 자습서의 Azure Data Manager for Energy 인스턴스 세부 정보 가져오기 섹션에 있는 테이블의 정보를 입력합니다.
Postman 요청 예 보내기
Wellbore DDMS용 Postman 컬렉션에는 Azure Data Manager for Energy 인스턴스의 유정, 유정 시추공, 유정 로그, 유정 궤도에 대한 데이터와 상호 작용하는 데 사용할 수 있는 요청이 포함됩니다.
Postman의 왼쪽 메뉴에서 컬렉션을 선택한 다음, Wellbore DDMS를 선택합니다. 설정에서 SPN 토큰 가져오기를 선택합니다.
오른쪽 상단의 환경 드롭다운 목록에서 Wellbore DDMS 환경을 선택합니다.
요청을 보내려면 보내기를 선택합니다.
요청은 예상 응답 코드에 대해 실제 API 응답 코드의 유효성을 검사합니다. 테스트 결과 탭을 선택하여 요청이 성공했는지 실패했는지 확인합니다.
성공적인 Postman 호출의 예:
실패한 Postman 호출의 예:
Wellbore DDMS API를 사용하여 유정 데이터 레코드 작업
다음 Wellbore DDMS API에 설명된 Postman 요청을 성공적으로 완료하면 Azure Data Manager for Energy 인스턴스에서 유정 레코드의 성공적인 수집 및 검색을 나타냅니다.
법적 태그 만들기
데이터 규정 준수를 위해 Wellbore DDMS 환경에 자동으로 추가되는 법적 태그를 만듭니다.
API: 설정>WDMS용 법적 태그 만들기
메서드: POST
자세한 내용은 법적 태그 관리를 참조하세요.
유정 레코드 만들기
Azure Data Manager for Energy 인스턴스에서 유정 레코드를 만듭니다.
API: 유정>유정 만들기
메서드: POST
유정 레코드 가져오기
Azure Data Manager for Energy 인스턴스에 대한 유정 레코드 데이터를 가져옵니다.
API: 유정>ID별 유정
메서드: GET
유정 버전 가져오기
Azure Data Manager for Energy 인스턴스에서 수집된 각 유정 레코드의 버전을 가져옵니다.
API: 유정>유정 버전
메서드: GET
특정 유정 버전 가져오기
Azure Data Manager for Energy 인스턴스에서 특정 유정 레코드에 대한 특정 버전의 세부 정보를 가져옵니다.
API: 유정>유정 특정 버전
메서드: GET
유정 레코드 삭제
Azure Data Manager for Energy 인스턴스에서 특정 유정 레코드를 삭제합니다.
API: 정리>유정 레코드
메서드: DELETE
다음 단계
sdutil 명령줄 도구를 사용하여 Seismic Store에 지진 데이터를 로드하는 방법을 알아보려면 다음 자습서를 참조하세요.