教學課程：使用 Well Delivery DDMS API 來處理井資料記錄

發行項
05/14/2024

在 Postman 中使用 Well Delivery Domain Data Management Services (DDMS) API，在 Azure Data Manager for Energy 中處理井資料。

在本教學課程中，您會了解如何：

設定 Postman 以使用 Well Delivery DDMS 集合。
設定 Postman 以使用 Well Delivery DDMS 環境。
透過 Postman 傳送要求。
產生授權權杖。
使用 Well Delivery DDMS API 來處理井資料記錄。

如需 DDMS 的詳細資訊，請參閱 DDMS 概念。

必要條件

Azure 訂閱
在 Azure 訂用帳戶中建立之 Azure Data Manager for Energy 的執行個體

取得 Azure Data Manager for Energy 執行個體的詳細資料

第一個步驟是從 Azure 入口網站中的 Azure Data Manager for Energy 執行個體取得下列資訊：

參數	值	範例
`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

下載並安裝 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}}'