Öğretici: Well Delivery DDMS API'lerini kullanarak iyi veri kayıtlarıyla çalışma
Enerji için Azure Data Manager örneğinizdeki iyi verilerle çalışmak için Postman'daki Well Delivery Domain Veri Yönetimi Services (DDMS) API'lerini kullanın.
Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:
- Postman'i Well Delivery DDMS koleksiyonunu kullanacak şekilde ayarlayın.
- Postman'i Well Delivery DDMS ortamını kullanacak şekilde ayarlayın.
- Postman aracılığıyla istek gönderin.
- Yetkilendirme belirteci oluşturun.
- İyi veri kayıtlarıyla çalışmak için Well Delivery DDMS API'lerini kullanın.
DDMS hakkında daha fazla bilgi için bkz . DDMS kavramları.
Önkoşullar
- Bir Azure aboneliği
- Azure aboneliğinizde oluşturulan Enerji için Azure Data Manager örneği
Enerji için Azure Data Manager örneğinizin ayrıntılarını alma
İlk adım, Azure portalında Enerji için Azure Data Manager örneğinizden aşağıdaki bilgileri almaktır:
Parametre | Value | Örnek |
---|---|---|
CLIENT_ID |
Uygulama (istemci) kimliği | 00001111-aaaa-2222-bbbb-3333cccc4444 |
CLIENT_SECRET |
İstemci gizli dizileri | _fl****************** |
TENANT_ID |
Dizin (kiracı) kimliği | 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx |
SCOPE |
Uygulama (istemci) kimliği | 00001111-aaaa-2222-bbbb-3333cccc4444 |
base_uri |
URI | <instance>.energy.azure.com |
data-partition-id |
Veri bölümleri | <instance>-<data-partition-name> |
Bu bilgileri öğreticinin ilerleyen bölümlerinde kullanacaksınız.
Postman’i ayarlama
Postman'da aşağıdaki dosyaları içeri aktarın:
Dosyaları içeri aktarmak için:
Postman ortamında CURRENT VALUE değerini Enerji için Azure Data Manager örneğinizdeki bilgilerle güncelleştirin:
Postman'de, soldaki menüde Ortamlar'ı ve ardından WellDelivery Ortamı'nı seçin.
GÜNCEL DEĞER sütununda, bu öğreticinin Enerji için Azure Data Manager örneği ayrıntılarını alma bölümündeki tablodan bilgileri girin.
Postman isteği gönderme
Well Delivery DDMS için Postman koleksiyonu, Enerji için Azure Data Manager örneğinizdeki kuyular, kuyular, kuyu günlükleri ve iyi yörünge hakkındaki verilerle etkileşimde bulunmak için kullanabileceğiniz istekler içerir.
Postman isteği gönderme örneği için Wellbore DDMS öğreticisine bakın.
API'ler için belirteç oluşturma
Well Delivery DDMS API'leriyle çalışmak için kullanabileceğiniz bir belirteç oluşturun:
Taşıyıcı belirteci oluşturmak için Postman'da aşağıdaki cURL komutunu içeri aktarın. Enerji için Azure Data Manager örneğinizdeki değerleri kullanın.
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}}'
Well Delivery DDMS ortamınızda güncelleştirmek
access_token
için belirteç çıkışını kullanın. Ardından taşıyıcı belirtecini diğer API çağrılarında yetkilendirme türü olarak kullanabilirsiniz.
İyi veri kayıtlarıyla çalışmak için Well Delivery DDMS API'lerini kullanma
Aşağıdaki Well Delivery DDMS API'lerinde açıklanan Postman isteklerinin başarıyla tamamlanması, Enerji için Azure Data Manager örneğinizdeki well kayıtlarının başarıyla alındığını ve alındığını gösterir.
İyi kayıt oluşturma
Enerji için Azure Data Manager örneğinizde iyi bir kayıt oluşturun.
API: UC1>iyi entity_create
Yöntem: PUT
wellbore kaydı oluşturma
Enerji için Azure Data Manager örneğinizde bir wellbore kaydı oluşturun.
API: UC1>entity_create wellbore
Yöntem: PUT
İyi bir sürüm edinin
Belirli bir kuyu kimliğine göre iyi bir kayıt alın.
API: UC1>entity_create well Copy
Yöntem: GET
Etkinlik planı oluşturma
Etkinlik planı oluşturma.
API: UC1>entity_create etkinlik planı
Yöntem: PUT
Well ID'ye göre etkinlik planı alma
Belirli bir kuyu kimliği için etkinlik planı nesnesini alın.
API: UC2>activity_plans_by_well
Yöntem: GET
Wellbore kaydını silme
Well Delivery DDMS API'lerini kullanarak Enerji için Azure Data Manager örneğinizdeki bir wellbore kaydını silebilirsiniz. Aşağıdaki ekran görüntüsünde bir örnek gösterilmektedir.
Kuyu kaydını silme
Well Delivery DDMS API'lerini kullanarak Enerji için Azure Data Manager örneğinizdeki bir kuyu kaydını silebilirsiniz. Aşağıdaki ekran görüntüsünde bir örnek gösterilmektedir.
Sonraki adımlar
Wellbore DDMS API'lerini kullanarak iyi verilerle çalışmayı öğrenmek için sonraki öğreticiye gidin: