자습서: 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 Data Manager for Energy 인스턴스 세부 정보 가져오기

첫 번째 단계는 Azure PortalAzure Data Manager for Energy 인스턴스에서 다음 정보를 가져오는 것입니다.

매개 변수 예제
client_id 애플리케이션(클라이언트) ID 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
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 설정

  1. Postman 데스크톱 앱을 다운로드하고 설치합니다.

  2. Postman에서 다음 파일을 가져옵니다.

    파일을 가져오려면:

    1. Postman에서 가져오기를 선택합니다.

      Screenshot that shows the Import button in Postman.

    2. 각 파일의 URL을 검색 상자에 붙여넣습니다.

      Screenshot that shows importing collection and environment files in Postman via URL.

  3. Postman 환경에서 Azure Data Manager for Energy 인스턴스 세부 정보로 현재 값을 업데이트합니다.

    1. Postman의 왼쪽 메뉴에서 Environments를 선택한 다음, Wellbore DDMS Environment를 선택합니다.

    2. CURRENT VALUE 열에서 이 자습서의 Azure Data Manager for Energy 인스턴스 세부 정보 가져오기 섹션에 있는 테이블의 정보를 입력합니다.

    Screenshot that shows where to enter current values in the Wellbore DDMS environment.

Postman 요청 예 보내기

Wellbore DDMS용 Postman 컬렉션에는 Azure Data Manager for Energy 인스턴스의 유정, 유정 시추공, 유정 로그, 유정 궤도에 대한 데이터와 상호 작용하는 데 사용할 수 있는 요청이 포함됩니다.

  1. Postman의 왼쪽 메뉴에서 컬렉션을 선택한 다음, Wellbore DDMS를 선택합니다. 설정에서 SPN 토큰 가져오기를 선택합니다.

  2. 오른쪽 상단의 환경 드롭다운 목록에서 Wellbore DDMS 환경을 선택합니다.

    Screenshot that shows selections for getting an SPN token and choosing an environment.

  3. 요청을 보내려면 보내기를 선택합니다.

    Screenshot that shows the Send button for a request in Postman.

  4. 요청은 예상 응답 코드에 대해 실제 API 응답 코드의 유효성을 검사합니다. 테스트 결과 탭을 선택하여 요청이 성공했는지 실패했는지 확인합니다.

    성공적인 Postman 호출의 예:

    Screenshot that shows success for a Postman call.

    실패한 Postman 호출의 예:

    Screenshot that shows failure for a Postman call.

Wellbore DDMS API를 사용하여 유정 데이터 레코드 작업

다음 Wellbore DDMS API에 설명된 Postman 요청을 성공적으로 완료하면 Azure Data Manager for Energy 인스턴스에서 유정 레코드의 성공적인 수집 및 검색을 나타냅니다.

데이터 규정 준수를 위해 Wellbore DDMS 환경에 자동으로 추가되는 법적 태그를 만듭니다.

API: 설정>WDMS용 법적 태그 만들기

메서드: POST

Screenshot that shows the API that creates a legal tag.

자세한 내용은 법적 태그 관리를 참조하세요.

유정 레코드 만들기

Azure Data Manager for Energy 인스턴스에서 유정 레코드를 만듭니다.

API: 유정>유정 만들기

메서드: POST

Screenshot that shows the API that creates a well record.

유정 레코드 가져오기

Azure Data Manager for Energy 인스턴스에 대한 유정 레코드 데이터를 가져옵니다.

API: 유정>ID별 유정

메서드: GET

Screenshot that shows the API that gets a well record by ID.

유정 버전 가져오기

Azure Data Manager for Energy 인스턴스에서 수집된 각 유정 레코드의 버전을 가져옵니다.

API: 유정>유정 버전

메서드: GET

Screenshot that shows the API that gets all well versions.

특정 유정 버전 가져오기

Azure Data Manager for Energy 인스턴스에서 특정 유정 레코드에 대한 특정 버전의 세부 정보를 가져옵니다.

API: 유정>유정 특정 버전

메서드: GET

Screenshot that shows the API that gets a specific well version.

유정 레코드 삭제

Azure Data Manager for Energy 인스턴스에서 특정 유정 레코드를 삭제합니다.

API: 정리>유정 레코드

메서드: DELETE

Screenshot that shows the API that deletes a well record.

다음 단계

sdutil 명령줄 도구를 사용하여 Seismic Store에 지진 데이터를 로드하는 방법을 알아보려면 다음 자습서를 참조하세요.