【 Cloud 】透過 Postman 操作 Azure Digital Twins - Query API

內容

• 學習目標
• 前置準備作業
• Twin Graph
• 上傳 Device DTDL 與建立 Twin
• 查詢所有 Twin
• 查詢 Temperature 大於 35 度的 Twin

學習目標

• 如何透過 Postman 操作 Azure Digital Twins - Query API

前置準備作業

• 已建立 Azure 帳號並能正常登入與使用
• 已完成建立與設定 Azure Digital Twins、Azure Active Directory ( Azure AD )
  • Ref https://learningsky.io/azure-digital-twins-authenticates-using-azure-ad-security-tokens-based-on-oauth/
• 已於電腦端安裝 Postman
  • 下載網址 https://www.postman.com/

Twin Graph

• 建立 device001 與 device002 兩個 Twin
• device001 的 Temperature 初始值設為 30
• device002 的 Temperature 初始值設為 38

上傳 Device DTDL 與建立 Twin

Step 1. 上傳 Device DTDL 與建立 Device Twin

• Device DTDL 資訊

• 上傳 Device DTDL 到所建立的 Azure Digital Twin

  • Ref https://learningsky.io/how-to-use-postman-to-send-requests-to-the-azure-digital-twins-models-apis/

• Azure Digital Twin 建立 Device DTDL 的 device001 與 device002 兩個 Twin，其中 device001 的 Temperature 初始值設為 30、device002 的 Temperature 初始值設為 38

  • Ref https://learningsky.io/how-to-use-postman-to-send-requests-to-the-azure-digital-twins-twins-apis/

查詢所有 Twin

Step 1. 查詢 Twin

• 點選 +

• 填寫 Request 資訊
  • Request Method 請選擇 POST
  • Request URL 請在 Enter Request URL 的輸入框輸入 https://Adt-Host-Name/query?api-version=2020-10-31
    • ㊟ 將 URL 中的 Adt-Host-Name 修改成所建立的 Azure Digital Twins 所取得的 Host name
  • Request Body
    • 請點選 Body 頁籤 > 再點選 raw > 再點選 JSON > 在輸入框輸入下方資訊

• 點選 Send

• 執行結果

查詢 Temperature 大於 35 度的 Twin

Step 1. 依條件查詢 Twin

• 點選 +

• 填寫 Request 資訊
  • Request Method 請選擇 POST
  • Request URL 請在 Enter Request URL 的輸入框輸入 https://Adt-Host-Name/query?api-version=2020-10-31
    • ㊟ 將 URL 中的 Adt-Host-Name 修改成所建立的 Azure Digital Twins 所取得的 Host name
  • Request Body
    • 請點選 Body 頁籤 > 再點選 raw > 再點選 JSON > 在輸入框輸入下方資訊

• 點選 Send

• 執行結果

Reference

• https://docs.microsoft.com/en-us/rest/api/azure-digitaltwins/

GitHub

• ArcherHuang @ GitHub

List of blogs

• https://oranwind.org/author/archer/
• https://learningsky.io/author/archer/