Kaynak sağlayıcısı REST API'sini (.NET) kullanarak IoT hub'ı oluşturma

  • Makale

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

  1. 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"
}

  2. Yeni bir Postman isteğinde, Kimlik Doğrulaması sekmesinde Tür açılan listesini seçin ve Taşıyıcı Belirteci'ni seçin.

    **Postman** içinde Taşıyıcı Belirteci yetkilendirme türünün nasıl seçildiğini gösteren ekran görüntüsü.

  3. 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

  1. 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

    Postman'de PUT komutunun nasıl ekleneceğini gösteren ekran görüntüsü.

    IoT Hub Kaynağında PUT komutuna bakın.

  2. Gövde sekmesinden açılan listelerden ham ve JSON'ı seçin.

    Postman'da isteğinizin gövdesine JSON eklemeyi gösteren ekran görüntüsü.

  3. 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
    }
}

    IoT Hub Kaynağında PUT komutuna bakın.

  4. İ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 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: