Visual Studio kullanarak Azure Digital Twins API'lerine istek gönderme

Visual Studio 2022 , uygulamadan HTTP isteklerini yapılandırmak, depolamak ve doğrudan göndermek için kullanılabilen dosyalar için .http destek içerir. Visual Studio'nun bu işlevselliğini kullanmak, HTTP istekleri oluşturmanın ve bunları Azure Digital Twins REST API'lerine göndermenin bir yoludur. Bu makalede, Visual Studio'da Azure Digital Twins API'leriyle arabirim oluşturabilen bir .http dosyanın nasıl ayarlanacağı açıklanır.

Bu makale aşağıdaki adımlar hakkında bilgi içerir:

1. Azure Digital Twins örneğinizi temsil eden değişkenlerle bir Visual Studio projesi ve .http dosyası ayarlayın.
2. Visual Studio'da API isteklerinde bulunmak için kullanabileceğiniz bir taşıyıcı belirteci almak için Azure CLI'yi kullanın.
3. Dosyada istek oluşturmak ve bunları Azure Digital Twins API'lerine .http göndermek için Kaynak olarak Azure Digital Twins REST API belgelerini kullanın.

Azure Digital Twins'de çalışabileceğiniz iki API kümesi vardır: veri düzlemi ve kontrol düzlemi. Bu API kümeleri arasındaki fark hakkında daha fazla bilgi için bkz . Azure Digital Twins API'leri ve SDK'ları. Bu makale her iki API kümesi için de yönergeler içerir.

Visual Studio'da dosya desteği hakkında .http daha fazla bilgi için bkz . Visual Studio 2022'de .http dosyalarını kullanma.

Önkoşullar

Visual Studio kullanarak Azure Digital Twins API'lerine istekte bulunmak için bir Azure Digital Twins örneği ayarlamanız ve Visual Studio 2022'yi indirmeniz gerekir. Bu bölüm bu adımlar içindir.

Azure Digital Twins örneğini ayarlama

Bu makalede Azure Digital Twins ile çalışmak için bir Azure Digital Twins örneğine ve bunu kullanmak için gerekli izinlere sahip olmanız gerekir. Zaten ayarlanmış bir Azure Digital Twins örneğiniz varsa bu örneği kullanabilir ve sonraki bölüme atlayabilirsiniz. Aksi takdirde, Örnek ve kimlik doğrulaması ayarlama başlığındaki yönergeleri izleyin. Yönergeler, her adımı başarıyla tamamladığınızdan emin olmanıza yardımcı olacak bilgiler içerir.

Örneğinizi ayarladıktan sonra, örneğin ana bilgisayar adını not edin. Konak adını Azure portalında bulabilirsiniz.

Visual Studio 2022'i indirin

Ardından Visual Studio 2022'yi indirin. ASP.NET ve web geliştirme iş yükünü yüklemenize eklediğinizden emin olun.

Visual Studio projelerini ayarlama

Bu bölümde, Visual Studio'da HTTP istekleri oluşturmak için kullanılacak projeyi ayarlarsınız.

Makinenizde Visual Studio'yu açın ve yeni bir proje oluşturun. ASP.NET Çekirdek Boş proje şablonunu kullanın.

Projenizde yeni .http bir dosya oluşturmak için .http dosyası oluşturma başlığındaki yönergeleri izleyin.

Değişken ekleme

Ardından, dosyanızın .http en üstüne Azure Digital Twins kaynağınıza bağlanmak için kullanılacak bazı değişkenleri ekleyin.

İhtiyacınız olan değişken kümesi, kullandığınız API kümesine bağlıdır, bu nedenle veri düzlemi ve denetim düzlemi API'leri arasında seçim yapmak için aşağıdaki sekmeleri kullanın.

@hostName=<host-name-of-your-Azure-Digital-Twins-instance>
@DPversion=2023-10-31

@instance=<name-of-your-Azure-Digital-Twins-instance>
@subscription=<ID-of-your-Azure-subscription>
@resourceGroup=<resource-group>
@CPversion=2023-01-31

Taşıyıcı belirteci ekleme

Azure Digital Twins örneğinizi ve Visual Studio projenizi ayarladığınıza göre, HTTP isteklerinin Azure Digital Twins API'lerine karşı yetkilendirmek için kullanabileceği bir taşıyıcı belirteci almanız gerekir.

Bu belirteci edinmenin birden çok yolu vardır. Bu makalede Azure hesabınızda oturum açmak ve bu şekilde bir belirteç almak için Azure CLI kullanılmaktadır.

Yerel olarak yüklenmiş bir Azure CLI'nız varsa aşağıdaki komutları çalıştırmak için makinenizde bir komut istemi başlatabilirsiniz. Aksi takdirde, tarayıcınızda bir Azure Cloud Shell penceresi açabilir ve komutları orada çalıştırabilirsiniz.

1. İlk olarak, şu komutu çalıştırarak Doğru kimlik bilgileriyle Azure'da oturum açtığınızdan emin olun:

   az login
   

2. Ardından az account get-access-token komutunu kullanarak Azure Digital Twins hizmetine erişimi olan bir taşıyıcı belirteci alın. Bu komutta, Azure Digital Twins kaynaklarına erişebilen bir erişim belirteci almak için Azure Digital Twins hizmet uç noktasının kaynak kimliğini geçirirsiniz.

   Belirtecin gerekli bağlamı kullandığınız API kümesine bağlıdır, bu nedenle veri düzlemi ile denetim düzlemi API'leri arasında seçim yapmak için aşağıdaki sekmeleri kullanın.

   • Veri düzlemi
   • Kontrol düzlemi

   Veri düzlemi API'leriyle kullanılacak bir belirteç almak için, belirteç bağlamı için aşağıdaki statik değeri kullanın: 0b07f429-9f4b-4714-9392-cc5e8e80c8b0. Bu değer, Azure Digital Twins hizmet uç noktasının kaynak kimliğidir.

   az account get-access-token --resource 0b07f429-9f4b-4714-9392-cc5e8e80c8b0
   

   Not

   Azure Digital Twins örneğine örnekten farklı bir Microsoft Entra kiracısına ait bir hizmet sorumlusu veya kullanıcı hesabı kullanarak erişmeniz gerekiyorsa, Azure Digital Twins örneğinin "giriş" kiracısından belirteç istemeniz gerekir. Bu işlem hakkında daha fazla bilgi için bkz . Uygulama kimlik doğrulama kodu yazma.

3. Sonuç içindeki değerini accessToken kopyalayın. Bu değer, isteklerinizi yetkilendirmek için Visual Studio'ya yapıştırdığınız belirteç değeridir .

   

Dosyaya .http belirteç ekleme

Visual Studio'daki dosyanıza .http belirtecinizin değerini tutan başka bir değişken ekleyin.

@token=<paste-data-plane-token>

@token=<paste-control-plane-token>

İstek ekleme

Dosyanız .http ayarlandıysa Artık Azure Dijital İkiz API'lerine istek ekleyebilirsiniz.

Başlangıç olarak Azure Digital Twins REST API başvurusunu açın. Bu belge, API'lerin kapsadığı tüm işlemlerin ayrıntılarını içerir. Çalıştırmak istediğiniz isteğin başvuru sayfasına gidin.

Bu makalede, örnek olarak veri düzleminden DigitalTwins Güncelleştirme API'sini kullanacağız.

1. İstek şablonu ekle: Başvuru belgelerinde gösterilen HTTP isteğini kopyalayın.

   

   Visual Studio'da isteği dosyanızdaki .http değişkenlerin altına yeni bir satıra yapıştırın.

2. Parametre ekleme: İstekte hangi parametre değerlerinin gerekli olduğunu görmek için başvuru belgelerinin URI Parametreleri bölümüne bakın. Bazılarını daha önce oluşturduğunuz değişkenlerle değiştirebilir ve diğer parametre değerlerini uygun şekilde doldurabilirsiniz. Bir değişkene başvurmak için değişken adını gibi {{variable}}çift küme ayracı içine koyun. Daha fazla ayrıntı için bkz . Değişkenler.

   Not

   Veri düzlemi istekleri digitaltwins-hostname için de bir parametredir. Bunu, ana bilgisayar adı değişkeninizin değerini kullanmak için ile {{hostName}} değiştirin.

   Örnek istekte bu adım şöyle görünür:

   

3. Yetkilendirme ekleme: Taşıyıcı belirteç değişkeninizle kimlik doğrulamasını belirtmek için isteğin hemen altına aşağıdaki satırı (tam olarak yazıldı) ekleyin.

   Authorization: Bearer {{token}}
   

   Örnek istekte bu adım şöyle görünür:

   

4. Ek üst bilgi ekleme: İstekle birlikte hangi üst bilgi değerlerinin olabileceğini görmek için başvuru belgelerinin İstek Üst Bilgisi bölümüne bakın. gibi Content-Typegeleneksel HTTP üst bilgilerini de eklemek isteyebilirsiniz. Her üst bilgiyi biçiminde kendi satırına HeaderName: Valueekleyin. Diğer ayrıntılar için bkz . İstek üst bilgileri.

   Örnek istekte bu adım şöyle görünür:

   

5. Gövde ekle: İstekte hangi gövde bilgilerinin gerekli olabileceğini görmek için başvuru belgelerinin İstek Gövdesi bölümüne bakın. İstek gövdesini boş bir satırdan sonra ekleyin. Diğer ayrıntılar için bkz . İstek gövdesi.

   Örnek istekte bu adım şöyle görünür:

6. İstek hazır olduğunda, gönderme isteğinin üzerindeki İstek gönder'i seçin.

   

Visual Studio, yanıtın ayrıntılarını içeren bir bölme sunar. Durum kodunu ve yanıt gövdesindeki tüm verileri yorumlamak için başvuru belgelerinin Yanıtlar bölümüne bakın.

Ek istekler ekleme

Dosyaya daha fazla istek eklemek için .http , bunları sınırlayıcı olarak ile ### ayırın.

Sonraki adımlar

Söz dizimi ayrıntıları ve gelişmiş senaryolar dahil olmak üzere Visual Studio'daki dosyalarla .http istek gönderme hakkında daha fazla ayrıntı için bkz . Visual Studio 2022'de .http dosyalarını kullanma.

Digital Twins API'leri hakkında daha fazla bilgi edinmek için Azure Digital Twins API'leri ve SDK'ları makalesini okuyun veya REST API'leri için başvuru belgelerini görüntüleyin.