Kurz: Práce s datovými záznamy s využitím rozhraní API Well Delivery DDMS

Pomocí rozhraní API služby Well Delivery Domain Správa dat Services (DDMS) v Postmanu můžete pracovat s dobře dostupnými daty ve vaší instanci Azure Data Manageru pro energii.

V tomto kurzu se naučíte:

• Nastavte Postman pro použití kolekce Well Delivery DDMS.
• Nastavte Postman pro použití prostředí Well Delivery DDMS.
• Odešlete žádosti přes Postman.
• Vygenerujte autorizační token.
• K práci s dobře datovými záznamy použijte rozhraní API DDMS Pro doručování.

Další informace o DDMS najdete v tématu Koncepty DDMS.

Požadavky

• Předplatné Azure
• Instance Azure Data Manageru pro energii vytvořená ve vašem předplatném Azure

Získání podrobností o instanci energie v Azure Data Manageru

Prvním krokem je získání následujících informací z instance Azure Data Manageru pro energii na webu Azure Portal:

Parametr	Hodnota	Příklad
CLIENT_ID	ID aplikace (klienta)	00001111-aaaa-2222-bbbb-3333cccc4444
CLIENT_SECRET	Tajné kódy klienta	_fl******************
TENANT_ID	ID adresáře (klienta)	72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE	ID aplikace (klienta)	00001111-aaaa-2222-bbbb-3333cccc4444
base_uri	Identifikátor URI	<instance>.energy.azure.com
data-partition-id	Datové oddíly	<data-partition-id>

Tyto informace použijete později v tomto kurzu.

Nastavení nástroje Postman

1. Stáhněte a nainstalujte desktopovou aplikaci Postman .

2. Naimportujte následující soubory v Nástroji Postman:

   • Kolekce Well Delivery DDMS Postman
   • Well Delivery DDMS Postman environment

   Import souborů:

   1. Ve svém počítači vytvořte dva soubory JSON zkopírováním dat, která jsou v kolekci a souborech prostředí.

   2. V nástroji Postman vyberte Importovat>soubory Zvolit soubory> a pak na počítači vyberte dva soubory JSON.

   3. V nástroji Import Entities in Postman (Importovat entity v nástroji Postman) vyberte Importovat.

      

3. V prostředí Postman aktualizujte AKTUÁLNÍ HODNOTU informacemi z azure Data Manageru pro instanci energie:

   1. V nástroji Postman v nabídce vlevo vyberte Prostředí a pak vyberte WellDelivery Environment.

   2. Ve sloupci CURRENT VALUE zadejte informace z tabulky v části Získání Azure Data Manageru pro podrobnosti o instanci energie v tomto kurzu.

   

Odeslání požadavku Postman

Kolekce Postman pro Well Delivery DDMS obsahuje požadavky, které můžete použít k interakci s daty o wells, wellbores, wellbores, dobře protokoly a dobře trajektorií ve vaší instanci Azure Data Manageru pro energii.

Příklad odeslání požadavku Postman najdete v kurzu Wellbore DDMS.

Generování tokenu pro rozhraní API

Vygenerujte token, který můžete použít pro práci s rozhraními API Well Delivery DDMS:

1. Naimportujte následující příkaz cURL v Nástroji Postman a vygenerujte nosný token. Použijte hodnoty z vaší instance Azure Data Manageru pro energii.

    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}}'  
   

   

2. Pomocí výstupu tokenu aktualizujte access_token v prostředí Well Delivery DDMS. Nosný token pak můžete použít jako autorizační typ v jiných voláních rozhraní API.

Použití rozhraní API DDMS pro doručování pro práci s dobře uloženými datovými záznamy

Úspěšné dokončení požadavků Postman popsaných v následujících rozhraních API well delivery DDMS indikuje úspěšné ingestování a načítání záznamů v instanci Azure Data Manageru pro energii.

Vytvoření záznamu dobře

Vytvořte záznam dobře v instanci Azure Data Manageru pro energii.

ROZHRANÍ API: UC1>entity_create dobře

Metoda: PUT

Vytvoření záznamu wellbore

Vytvořte záznam wellbore v instanci Azure Data Manageru pro energii.

ROZHRANÍ API: UC1>entity_create wellbore

Metoda: PUT

Získání dobře známé verze

Získejte záznam o kontejneru na základě konkrétního ID kontejneru.

ROZHRANÍ API: UC1>entity_create dobře kopírovat

Metoda: GET

Vytvoření plánu aktivit

Vytvořte plán aktivit.

ROZHRANÍ API: PLÁN aktivity UC1>entity_create

Metoda: PUT

Získání plánu aktivit podle ID kontejneru

Získejte objekt plánu aktivity pro konkrétní ID kontejneru.

ROZHRANÍ API: UC2>activity_plans_by_well

Metoda: GET

Odstranění záznamu wellbore

Záznam wellbore můžete odstranit v instanci Azure Data Manageru pro energii pomocí rozhraní API Well Delivery DDMS. Následující snímek obrazovky ukazuje příklad.

Odstranění záznamu kontejneru

Pomocí rozhraní API Well Delivery DDMS můžete odstranit záznam ve svém Azure Data Manageru pro energii. Následující snímek obrazovky ukazuje příklad.

Další kroky

V dalším kurzu se dozvíte, jak pracovat s daty pomocí rozhraní API Wellbore DDMS:

Kurz: Práce s datovými záznamy pomocí rozhraní API Wellbore DDMS