Kaynak sağlayıcısı REST API'sini (.NET) kullanarak IoT hub'ı oluşturma
Azure IoT hub'larını program aracılığıyla oluşturmak ve yönetmek için IoT Hub Kaynak REST API'sini kullanabilirsiniz. Bu makalede, Postman kullanarak IoT hub'ı oluşturmak için IoT Hub Kaynağının nasıl kullanılacağı gösterilmektedir. Alternatif olarak , cURL kullanabilirsiniz. Bu REST komutlarından herhangi biri başarısız olursa, IoT Hub API'sinin yaygın hata kodlarıyla ilgili yardım bulun.
Not
Azure ile etkileşime geçmek için Azure Az PowerShell modülünü kullanmanızı öneririz. Başlamak için bkz. Azure PowerShell'i yükleme. Az PowerShell modülüne nasıl geçeceğinizi öğrenmek için bkz. Azure PowerShell’i AzureRM’den Az’ye geçirme.
Önkoşullar
Azure erişim belirteci alma
Azure PowerShell cmdlet'inde veya Azure Cloud Shell oturum açın ve aşağıdaki komutla bir belirteç alın. Zaten oturum açmış Cloud Shell kullanıyorsanız bu adımı atlayın.
az account get-access-token --resource https://management.azure.com
Konsolda bu JSON'a benzer bir yanıt görmeniz gerekir (erişim belirteci uzun olması dışında):
{ "accessToken": "eyJ ... pZA", "expiresOn": "2022-09-16 20:57:52.000000", "subscription": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "tokenType": "Bearer" }
Yeni bir Postman isteğinde, Kimlik Doğrulaması sekmesinde Tür açılan listesini seçin ve Taşıyıcı Belirteci'ni seçin.
Erişim belirtecini Belirteç etiketli alana yapıştırın.
Erişim belirtecinin süresi 5-60 dakika sonra dolduğundan, başka bir belirteç oluşturmanız gerekebileceğini unutmayın.
IoT hub oluşturma
REST komutu açılan listesini seçin ve PUT komutunu seçin. aşağıdaki URL'yi kopyalayın ve içindeki
{}
değerleri kendi değerlerinizle değiştirin.{resourceName}
Değer, yeni IoT hub'ınız için istediğiniz addır. URL'yi PUT komutunun yanındaki alana yapıştırın.PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2021-04-12
Gövde sekmesinden açılan listelerden ham ve JSON'ı seçin.
Aşağıdaki JSON dosyasını kopyalayın ve içindeki
<>
değerleri kendi değerlerinizle değiştirin. JSON'yi Gövde sekmesindeki Postman'deki kutuya yapıştırın. IoT hub'ınızın adının PUT URL'nizdeki adla eşleştiğinden emin olun. Konumu konumunuza (kaynak grubunuza atanan konum) değiştirin.{ "name": "<my-iot-hub>", "location": "<region>", "tags": {}, "properties": {}, "sku": { "name": "S1", "tier": "Standard", "capacity": 1 } }
İsteğinizi göndermek ve yeni bir IoT hub'ı oluşturmak için Gönder'i seçin. Başarılı bir istek, IoT hub belirtimlerinizin JSON çıktısıyla 201 Oluşturuldu yanıtını döndürür. Postman kullanıyorsanız isteğinizi kaydedebilirsiniz.
IoT hub'larını görüntüleme
Yeni IoT hub'ınızın tüm belirtimlerini görmek için bir GET isteği kullanın. PUT isteğinde kullandığınız URL'nin aynısını kullanabilirsiniz, ancak get isteğinin gövdesi olmadığından bu isteğin gövdesini (henüz boş değilse) silmeniz gerekir. GET isteği şablonu şu şekildedir:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2018-04-01
IoT Hub Kaynağında GET komutuna bakın.
IoT hub'larını güncelleştirme
IoT hub'ını oluşturduğumuz ve JSON gövdesini seçtiğiniz parametreleri içerecek şekilde düzenlediğimiz aynı PUT isteğini kullanmak kadar basit bir güncelleştirmedir. Bir etiket özelliği ekleyerek isteğin gövdesini düzenleyin, ardından PUT isteğini çalıştırın.
{
"name": "<my-iot-hub>",
"location": "westus2",
"tags": {
"Animal": "Cat"
},
"properties": {},
"sku": {
"name": "S1",
"tier": "Standard",
"capacity": 1
}
}
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2018-04-01
Yanıtta konsola eklenen yeni etiket gösterilir. Son oluşturduğunuz zamandan bu yana çok fazla zaman geçtiyse erişim belirtecinizi yenilemeniz gerekebileceğini unutmayın.
IoT Hub Kaynağında PUT komutuna bakın.
Alternatif olarak, etiketleri güncelleştirmek için IoT Hub Kaynağı'ndaki PATCH komutunu kullanın.
IoT hub'larını silme
Yalnızca test ediyorsanız, bir DELETE isteği göndererek kaynaklarınızı temizlemek ve yeni IoT hub'ınızı silmek isteyebilirsiniz. içindeki {}
değerleri kendi değerlerinizle değiştirmeyi unutmayın. {resourceName}
Değer, IoT hub'ınızın adıdır.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2018-04-01
IoT Hub Kaynağında DELETE komutuna bakın.
Sonraki adımlar
Kaynak sağlayıcısı REST API'sini kullanarak bir IoT hub'ı dağıttıysanız daha fazla araştırma yapmak isteyebilirsiniz:
IoT Hub kaynak sağlayıcısı REST API'sinin özellikleri hakkında bilgi edinin.
Azure Resource Manager özellikleri hakkında daha fazla bilgi edinmek için Azure Resource Manager genel bakış konusunu okuyun.
IoT Hub geliştirme hakkında daha fazla bilgi edinmek için aşağıdaki makalelere bakın:
IoT Hub özelliklerini daha fazla keşfetmek için bkz: