Iot Hub Resource - Create Or Update

IoT hub'ının meta verilerini oluşturun veya güncelleştirin. Bir özelliği değiştirmek için her zamanki desen IoT hub meta verilerini ve güvenlik meta verilerini almak ve bunları yeni bir gövdedeki değiştirilmiş değerlerle birleştirerek IoT hub'ını güncelleştirmektir. JSON'da belirli özellikler eksikse, IoT Hub güncelleştirilmesi bu değerlerin varsayılan değere geri döndürülmesine neden olabilir ve bu da beklenmeyen davranışlara yol açabilir.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2018-04-01

URI Parametreleri

Name In Required Type Description
resourceGroupName
path True
  • string

IoT hub'ını içeren kaynak grubunun adı.

resourceName
path True
  • string

IoT hub'ının adı.

subscriptionId
path True
  • string

Abonelik tanımlayıcısı.

api-version
query True
  • string

API sürümü.

İstek Başlığı

Name Required Type Description
If-Match
  • string

IoT Hub ETag'i. Yepyeni bir IoT Hub oluşturmak için belirtmeyin. Mevcut bir IoT Hub güncelleştirmek için gereklidir.

İstek Gövdesi

Name Required Type Description
location True
  • string

Kaynak konumu.

sku True

IotHub SKU bilgileri

etag
  • string

Etag alanı gerekli değildir . Yanıt gövdesinde sağlanıyorsa, normal ETag kuralına göre üst bilgi olarak da sağlanmalıdır.

properties

IotHub özellikleri

tags
  • object

Kaynak etiketleri.

Yanıtlar

Name Type Description
200 OK

Bu, oluşturma veya güncelleştirme işlemi için durum yoklama isteğine yanıt olarak döndürülür. Gövde, geçişli sağlama durumunu gösteren kaynak gösterimini içerir.

201 Created

Bu uzun süre çalışan bir işlemdir. Doğrulama tamamlandıysa işlem bir 201 döndürür. Yanıt, durum URL'sini içeren bir Azure-AsyncOperation üst bilgisi içerir. İstemcilerin işlemin durumu için durum URL'sini yoklaması beklenir. İşlem başarılı olursa 201 (Tamam) HTTP durum kodunu döndürür.

Other Status Codes

DefaultErrorResponse

Güvenlik

azure_auth

OAuth2 Flow Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

IotHubResource_CreateOrUpdate

Sample Request

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub?api-version=2018-04-01

{
  "name": "iot-dps-cit-hub-1",
  "type": "Microsoft.Devices/IotHubs",
  "location": "centraluseuap",
  "tags": {},
  "etag": "AAAAAAFD6M4=",
  "properties": {
    "operationsMonitoringProperties": {
      "events": {
        "None": "None",
        "Connections": "None",
        "DeviceTelemetry": "None",
        "C2DCommands": "None",
        "DeviceIdentityOperations": "None",
        "FileUploadOperations": "None",
        "Routes": "None"
      }
    },
    "state": "Active",
    "provisioningState": "Succeeded",
    "ipFilterRules": [],
    "hostName": "iot-dps-cit-hub-1.azure-devices.net",
    "eventHubEndpoints": {
      "events": {
        "retentionTimeInDays": 1,
        "partitionCount": 2,
        "partitionIds": [
          "0",
          "1"
        ],
        "path": "iot-dps-cit-hub-1",
        "endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
      },
      "operationsMonitoringEvents": {
        "retentionTimeInDays": 1,
        "partitionCount": 2,
        "partitionIds": [
          "0",
          "1"
        ],
        "path": "iot-dps-cit-hub-1-operationmonitoring",
        "endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
      }
    },
    "routing": {
      "endpoints": {
        "serviceBusQueues": [],
        "serviceBusTopics": [],
        "eventHubs": [],
        "storageContainers": []
      },
      "routes": [],
      "fallbackRoute": {
        "name": "$fallback",
        "source": "DeviceMessages",
        "condition": "true",
        "endpointNames": [
          "events"
        ],
        "isEnabled": true
      }
    },
    "storageEndpoints": {
      "$default": {
        "sasTtlAsIso8601": "PT1H",
        "connectionString": "",
        "containerName": ""
      }
    },
    "messagingEndpoints": {
      "fileNotifications": {
        "lockDurationAsIso8601": "PT1M",
        "ttlAsIso8601": "PT1H",
        "maxDeliveryCount": 10
      }
    },
    "enableFileUploadNotifications": false,
    "cloudToDevice": {
      "maxDeliveryCount": 10,
      "defaultTtlAsIso8601": "PT1H",
      "feedback": {
        "lockDurationAsIso8601": "PT1M",
        "ttlAsIso8601": "PT1H",
        "maxDeliveryCount": 10
      }
    },
    "features": "None"
  },
  "sku": {
    "name": "S1",
    "tier": "Standard",
    "capacity": 1
  }
}

Sample Response

{
  "id": "/subscriptions/ae24ff83-d2ca-4fc8-9717-05dae4bba489/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub",
  "name": "testHub",
  "type": "Microsoft.Devices/IotHubs",
  "location": "centraluseuap",
  "tags": {},
  "etag": "AAAAAAFD6M4=",
  "properties": {
    "operationsMonitoringProperties": {
      "events": {
        "None": "None",
        "Connections": "None",
        "DeviceTelemetry": "None",
        "C2DCommands": "None",
        "DeviceIdentityOperations": "None",
        "FileUploadOperations": "None",
        "Routes": "None"
      }
    },
    "state": "Active",
    "provisioningState": "Succeeded",
    "ipFilterRules": [],
    "hostName": "iot-dps-cit-hub-1.azure-devices.net",
    "eventHubEndpoints": {
      "events": {
        "retentionTimeInDays": 1,
        "partitionCount": 2,
        "partitionIds": [
          "0",
          "1"
        ],
        "path": "iot-dps-cit-hub-1",
        "endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
      },
      "operationsMonitoringEvents": {
        "retentionTimeInDays": 1,
        "partitionCount": 2,
        "partitionIds": [
          "0",
          "1"
        ],
        "path": "iot-dps-cit-hub-1-operationmonitoring",
        "endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
      }
    },
    "routing": {
      "endpoints": {
        "serviceBusQueues": [],
        "serviceBusTopics": [],
        "eventHubs": [],
        "storageContainers": []
      },
      "routes": [],
      "fallbackRoute": {
        "name": "$fallback",
        "source": "DeviceMessages",
        "condition": "true",
        "endpointNames": [
          "events"
        ],
        "isEnabled": true
      }
    },
    "storageEndpoints": {
      "$default": {
        "sasTtlAsIso8601": "PT1H",
        "connectionString": "",
        "containerName": ""
      }
    },
    "messagingEndpoints": {
      "fileNotifications": {
        "lockDurationAsIso8601": "PT1M",
        "ttlAsIso8601": "PT1H",
        "maxDeliveryCount": 10
      }
    },
    "enableFileUploadNotifications": false,
    "cloudToDevice": {
      "maxDeliveryCount": 10,
      "defaultTtlAsIso8601": "PT1H",
      "feedback": {
        "lockDurationAsIso8601": "PT1M",
        "ttlAsIso8601": "PT1H",
        "maxDeliveryCount": 10
      }
    },
    "features": "None"
  },
  "sku": {
    "name": "S1",
    "tier": "Standard",
    "capacity": 1
  }
}
{
  "id": "/subscriptions/ae24ff83-d2ca-4fc8-9717-05dae4bba489/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub",
  "name": "testHub",
  "type": "Microsoft.Devices/IotHubs",
  "location": "centraluseuap",
  "tags": {},
  "etag": "AAAAAAFD6M4=",
  "properties": {
    "operationsMonitoringProperties": {
      "events": {
        "None": "None",
        "Connections": "None",
        "DeviceTelemetry": "None",
        "C2DCommands": "None",
        "DeviceIdentityOperations": "None",
        "FileUploadOperations": "None",
        "Routes": "None"
      }
    },
    "state": "Active",
    "provisioningState": "Succeeded",
    "ipFilterRules": [],
    "hostName": "iot-dps-cit-hub-1.azure-devices.net",
    "eventHubEndpoints": {
      "events": {
        "retentionTimeInDays": 1,
        "partitionCount": 2,
        "partitionIds": [
          "0",
          "1"
        ],
        "path": "iot-dps-cit-hub-1",
        "endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
      },
      "operationsMonitoringEvents": {
        "retentionTimeInDays": 1,
        "partitionCount": 2,
        "partitionIds": [
          "0",
          "1"
        ],
        "path": "iot-dps-cit-hub-1-operationmonitoring",
        "endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
      }
    },
    "routing": {
      "endpoints": {
        "serviceBusQueues": [],
        "serviceBusTopics": [],
        "eventHubs": [],
        "storageContainers": []
      },
      "routes": [],
      "fallbackRoute": {
        "name": "$fallback",
        "source": "DeviceMessages",
        "condition": "true",
        "endpointNames": [
          "events"
        ],
        "isEnabled": true
      }
    },
    "storageEndpoints": {
      "$default": {
        "sasTtlAsIso8601": "PT1H",
        "connectionString": "",
        "containerName": ""
      }
    },
    "messagingEndpoints": {
      "fileNotifications": {
        "lockDurationAsIso8601": "PT1M",
        "ttlAsIso8601": "PT1H",
        "maxDeliveryCount": 10
      }
    },
    "enableFileUploadNotifications": false,
    "cloudToDevice": {
      "maxDeliveryCount": 10,
      "defaultTtlAsIso8601": "PT1H",
      "feedback": {
        "lockDurationAsIso8601": "PT1M",
        "ttlAsIso8601": "PT1H",
        "maxDeliveryCount": 10
      }
    },
    "features": "None"
  },
  "sku": {
    "name": "S1",
    "tier": "Standard",
    "capacity": 1
  }
}

Tanımlar

AccessRights

Paylaşılan erişim ilkesine atanan izinler.

Capabilities

IoT hub'ı için etkinleştirilen özellikler ve özellikler.

CloudToDeviceProperties

IoT hub buluttan cihaza mesajlaşma özellikleri.

ErrorDetails

Hata ayrıntıları.

EventHubProperties

IoT hub'ı tarafından kullanılan, sağlanan Event Hub ile uyumlu uç noktanın özellikleri.

FallbackRouteProperties

Geri dönüş yolunun özellikleri. IoT Hub, iletileri geri dönüş uç noktasına yönlendirirken bu özellikleri kullanır.

FeedbackProperties

Buluttan cihaza iletiler için geri bildirim kuyruğunun özellikleri.

IotHubDescription

IoT hub'ının açıklaması.

IotHubProperties

IoT hub'ının özellikleri.

IotHubSku

SKU'nun adı.

IotHubSkuInfo

IoT hub'ının SKU'su hakkında bilgi.

IotHubSkuTier

IoT hub'ına yönelik faturalama katmanı.

IpFilterActionType

Bu kural tarafından yakalanan istekler için istenen eylem.

IpFilterRule

IoT hub'ı için IP filtresi kuralları.

MessagingEndpointProperties

Bu IoT hub'ı tarafından kullanılan mesajlaşma uç noktalarının özellikleri.

OperationsMonitoringProperties

IoT hub'ına yönelik işlemleri izleme özellikleri. Sözlüğün olası anahtarları Bağlantılar, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods'tır.

RouteProperties

IoT hub'ınızın iletileri uç noktalara yönlendirmek için kullandığı yönlendirme kuralının özellikleri.

RoutingEndpoints

IoT hub'ınızın iletileri yönlendirme kurallarına göre yönlendirdiği özel uç noktalarla ilgili özellikler. Ücretli hub'lar için tüm uç nokta türlerinde en fazla 10 özel uç noktaya izin verilir ve ücretsiz hub'lar için tüm uç nokta türlerinde yalnızca 1 özel uç noktaya izin verilir.

RoutingEventHubProperties

Olay hub'ı uç noktasıyla ilgili özellikler.

RoutingProperties

IoT hub'ının yönlendirmeyle ilgili özellikleri. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging

RoutingServiceBusQueueEndpointProperties

Service Bus kuyruğu uç nokta türleriyle ilgili özellikler.

RoutingServiceBusTopicEndpointProperties

Service Bus konu uç noktası türleriyle ilgili özellikler.

RoutingSource

DeviceMessages gibi yönlendirme kuralının uygulanacağı kaynak.

RoutingStorageContainerProperties

Depolama kapsayıcısı uç noktasıyla ilgili özellikler.

SharedAccessSignatureAuthorizationRule

IoT hub paylaşılan erişim ilkesinin özellikleri.

StorageEndpointProperties

Dosya yükleme için Azure Depolama uç noktasının özellikleri.

AccessRights

Paylaşılan erişim ilkesine atanan izinler.

Name Type Description
DeviceConnect
  • string
RegistryRead
  • string
RegistryRead, DeviceConnect
  • string
RegistryRead, RegistryWrite
  • string
RegistryRead, RegistryWrite, DeviceConnect
  • string
RegistryRead, RegistryWrite, ServiceConnect
  • string
RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect
  • string
RegistryRead, ServiceConnect
  • string
RegistryRead, ServiceConnect, DeviceConnect
  • string
RegistryWrite
  • string
RegistryWrite, DeviceConnect
  • string
RegistryWrite, ServiceConnect
  • string
RegistryWrite, ServiceConnect, DeviceConnect
  • string
ServiceConnect
  • string
ServiceConnect, DeviceConnect
  • string

Capabilities

IoT hub'ı için etkinleştirilen özellikler ve özellikler.

Name Type Description
DeviceManagement
  • string
None
  • string

CloudToDeviceProperties

IoT hub buluttan cihaza mesajlaşma özellikleri.

Name Type Description
defaultTtlAsIso8601
  • string

Cihaz kuyruğundaki buluttan cihaza iletiler için varsayılan yaşam süresi. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

feedback

Buluttan cihaza iletiler için geri bildirim kuyruğunun özellikleri.

maxDeliveryCount
  • integer

Cihaz kuyruğundaki buluttan cihaza iletiler için maksimum teslim sayısı. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

ErrorDetails

Hata ayrıntıları.

Name Type Description
code
  • string

Hata kodu.

details
  • string

Hata ayrıntıları.

httpStatusCode
  • string

HTTP durum kodu.

message
  • string

Hata iletisi.

EventHubProperties

IoT hub'ı tarafından kullanılan, sağlanan Event Hub ile uyumlu uç noktanın özellikleri.

Name Type Description
endpoint
  • string

Event Hub ile uyumlu uç nokta.

partitionCount
  • integer

Event Hub ile uyumlu uç noktada cihazdan buluta iletileri almaya yönelik bölüm sayısı. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages.

partitionIds
  • string[]

Event Hub ile uyumlu uç noktadaki bölüm kimlikleri.

path
  • string

Event Hub ile uyumlu ad.

retentionTimeInDays
  • integer

Cihazdan buluta iletilerin saklama süresi (gün cinsinden). Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages

FallbackRouteProperties

Geri dönüş yolunun özellikleri. IoT Hub, iletileri geri dönüş uç noktasına yönlendirirken bu özellikleri kullanır.

Name Type Description
condition
  • string

Geri dönüş yolunu uygulamak için değerlendirilen koşul. Koşul sağlanmazsa varsayılan olarak true olarak değerlendirilir. Dil bilgisi için bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language

endpointNames
  • string[]

Koşulu karşılayan iletilerin yönlendirildiği uç noktaların listesi. Şu anda yalnızca 1 uç noktaya izin verilir.

isEnabled
  • boolean

Geri dönüş yolunun etkinleştirilip etkinleştirilmediğini belirtmek için kullanılır.

name
  • string

Yolun adı. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir, uzunluk üst sınırı 64 karakterdir ve benzersiz olmalıdır.

source

Yönlendirme kuralının uygulanacağı kaynak. Örneğin, DeviceMessages

FeedbackProperties

Buluttan cihaza iletiler için geri bildirim kuyruğunun özellikleri.

Name Type Description
lockDurationAsIso8601
  • string

Geri bildirim kuyruğunun kilit süresi. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

maxDeliveryCount
  • integer

IoT hub'ının geri bildirim kuyruğunda ileti teslim etmeye çalışma sayısı. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

ttlAsIso8601
  • string

IoT hub'ı tarafından süresi dolmadan önce iletinin kullanılabilmesi için kullanılabilecek süre. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

IotHubDescription

IoT hub'ının açıklaması.

Name Type Description
etag
  • string

Etag alanı gerekli değildir . Yanıt gövdesinde sağlanıyorsa, normal ETag kuralına göre üst bilgi olarak da sağlanmalıdır.

id
  • string

Kaynak tanımlayıcısı.

location
  • string

Kaynak konumu.

name
  • string

Kaynak adı.

properties

IotHub özellikleri

sku

IotHub SKU bilgileri

tags
  • object

Kaynak etiketleri.

type
  • string

Kaynak türü.

IotHubProperties

IoT hub'ının özellikleri.

Name Type Description
authorizationPolicies

IoT hub'ına bir bağlantının güvenliğini sağlamak için kullanabileceğiniz paylaşılan erişim ilkeleri.

cloudToDevice

IoT hub buluttan cihaza mesajlaşma özellikleri.

comments
  • string

IoT hub açıklamaları.

enableFileUploadNotifications
  • boolean

True ise, dosya karşıya yükleme bildirimleri etkinleştirilir.

eventHubEndpoints

Event Hub ile uyumlu uç nokta özellikleri. Bu sözlüğün olası anahtarları olaylar ve işlemlerMonitoringEvents'tir. Bu anahtarların her ikisi de IoT hub'ı için oluşturma veya güncelleştirme çağrıları yaparken sözlükte bulunmalıdır.

features

IoT hub'ı için etkinleştirilen özellikler ve özellikler.

hostName
  • string

Ana bilgisayarın adı.

ipFilterRules

IP filtresi kuralları.

messagingEndpoints

Dosya karşıya yükleme bildirim kuyruğunun mesajlaşma uç noktası özellikleri.

operationsMonitoringProperties

IoT hub'ına yönelik işlemleri izleme özellikleri. Sözlüğün olası anahtarları Bağlantılar, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods'tır.

provisioningState
  • string

Sağlama durumu.

routing

IoT hub'ının yönlendirmeyle ilgili özellikleri. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging

state
  • string

Hub durumu.

storageEndpoints

Dosyaları karşıya yükleyebileceğiniz Azure Depolama uç noktalarının listesi. Şu anda yalnızca bir Azure Depolama hesabı yapılandırabilirsiniz ve bu hesabın anahtarı $default olmalıdır. Birden fazla depolama hesabı belirtilmesi hata oluşmasına neden olur. enableFileUploadNotifications özelliği True olarak ayarlandığında bu özellik için bir değer belirtilmemesi bir hata oluşmasına neden olur.

IotHubSku

SKU'nun adı.

Name Type Description
B1
  • string
B2
  • string
B3
  • string
F1
  • string
S1
  • string
S2
  • string
S3
  • string

IotHubSkuInfo

IoT hub'ının SKU'su hakkında bilgi.

Name Type Description
capacity
  • integer

Sağlanan IoT Hub birimi sayısı. Bkz. https://docs.microsoft.com/azure/azure-subscription-service-limits#iot-hub-limits.

name

SKU'nun adı.

tier

IoT hub'ına yönelik faturalama katmanı.

IotHubSkuTier

IoT hub'ına yönelik faturalama katmanı.

Name Type Description
Basic
  • string
Free
  • string
Standard
  • string

IpFilterActionType

Bu kural tarafından yakalanan istekler için istenen eylem.

Name Type Description
Accept
  • string
Reject
  • string

IpFilterRule

IoT hub'ı için IP filtresi kuralları.

Name Type Description
action

Bu kural tarafından yakalanan istekler için istenen eylem.

filterName
  • string

IP filtresi kuralının adı.

ipMask
  • string

Kural için CIDR gösteriminde IP adresi aralığını içeren bir dize.

MessagingEndpointProperties

Bu IoT hub'ı tarafından kullanılan mesajlaşma uç noktalarının özellikleri.

Name Type Description
lockDurationAsIso8601
  • string

Kilit süresi. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload.

maxDeliveryCount
  • integer

IoT hub'ının bir iletiyi teslim etmeye çalışma sayısı. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload.

ttlAsIso8601
  • string

IoT hub'ı tarafından süresi dolmadan önce iletinin kullanılabilmesi için kullanılabilecek süre. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload.

OperationsMonitoringProperties

IoT hub'ına yönelik işlemleri izleme özellikleri. Sözlüğün olası anahtarları Bağlantılar, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods'tır.

Name Type Description
events
  • object

RouteProperties

IoT hub'ınızın iletileri uç noktalara yönlendirmek için kullandığı yönlendirme kuralının özellikleri.

Name Type Description
condition
  • string

Yönlendirme kuralını uygulamak için değerlendirilen koşul. Koşul sağlanmazsa, varsayılan olarak true olarak değerlendirilir. Dil bilgisi için bkz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language

endpointNames
  • string[]

Koşulu karşılayan iletilerin yönlendirildiği uç noktaların listesi. Şu anda yalnızca bir uç noktaya izin verilir.

isEnabled
  • boolean

Bir yolun etkinleştirilip etkinleştirilmediğini belirtmek için kullanılır.

name
  • string

Yolun adı. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir, uzunluk üst sınırı 64 karakterdir ve benzersiz olmalıdır.

source

DeviceMessages gibi yönlendirme kuralının uygulanacağı kaynak.

RoutingEndpoints

IoT hub'ınızın iletileri yönlendirme kurallarına göre yönlendirdiği özel uç noktalarla ilgili özellikler. Ücretli hub'lar için tüm uç nokta türlerinde en fazla 10 özel uç noktaya izin verilir ve ücretsiz hub'lar için tüm uç nokta türlerinde yalnızca 1 özel uç noktaya izin verilir.

Name Type Description
eventHubs

Yönlendirme kurallarına göre IoT hub'ının iletileri yönlendirdığı Event Hubs uç noktalarının listesi. Bu liste yerleşik Event Hubs uç noktasını içermez.

serviceBusQueues

Yönlendirme kurallarına göre IoT hub'ının iletileri yönlendirdığı Service Bus kuyruk uç noktalarının listesi.

serviceBusTopics

IoT hub'ının yönlendirme kurallarına göre iletileri yönlendirdığı Service Bus konu uç noktalarının listesi.

storageContainers

IoT hub'ının yönlendirme kurallarına göre iletileri yönlendirdığı depolama kapsayıcısı uç noktalarının listesi.

RoutingEventHubProperties

Olay hub'ı uç noktasıyla ilgili özellikler.

Name Type Description
connectionString
  • string

Olay hub'ı uç noktasının bağlantı dizesi.

name
  • string

Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: events, operationsMonitoringEvents, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır.

resourceGroup
  • string

Olay hub'ı uç noktasının kaynak grubunun adı.

subscriptionId
  • string

Olay hub'ı uç noktasının abonelik tanımlayıcısı.

RoutingProperties

IoT hub'ının yönlendirmeyle ilgili özellikleri. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging

Name Type Description
endpoints

IoT hub'ınızın iletileri yönlendirme kurallarına göre yönlendirdiği özel uç noktalarla ilgili özellikler. Ücretli hub'lar için tüm uç nokta türlerinde en fazla 10 özel uç noktaya izin verilir ve ücretsiz hub'lar için tüm uç nokta türlerinde yalnızca 1 özel uç noktaya izin verilir.

fallbackRoute

'Yollar' bölümünde belirtilen koşulların hiçbiri karşılanmadığında geri dönüş yolu olarak kullanılan yolun özellikleri. Bu isteğe bağlı bir parametredir. Bu özellik ayarlanmadığında, 'routes' bölümünde belirtilen koşulların hiçbirini karşılamayan iletiler yerleşik eventhub uç noktasına yönlendirilir.

routes

IoT hub'ının iletileri yerleşik ve özel uç noktalara yönlendirmek için kullandığı kullanıcı tarafından sağlanan yönlendirme kurallarının listesi. Ücretli hub'lar için en fazla 100 yönlendirme kuralına ve ücretsiz hub'lar için en fazla 5 yönlendirme kuralına izin verilir.

RoutingServiceBusQueueEndpointProperties

Service Bus kuyruğu uç nokta türleriyle ilgili özellikler.

Name Type Description
connectionString
  • string

Service Bus kuyruğu uç noktasının bağlantı dizesi.

name
  • string

Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: events, operationsMonitoringEvents, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Adın gerçek kuyruk adıyla aynı olması gerekmez.

resourceGroup
  • string

Service Bus kuyruğu uç noktasının kaynak grubunun adı.

subscriptionId
  • string

Service Bus kuyruğu uç noktasının abonelik tanımlayıcısı.

RoutingServiceBusTopicEndpointProperties

Service Bus konu uç noktası türleriyle ilgili özellikler.

Name Type Description
connectionString
  • string

Service Bus konu uç noktasının bağlantı dizesi.

name
  • string

Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: events, operationsMonitoringEvents, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Adın gerçek konu adıyla aynı olması gerekmez.

resourceGroup
  • string

Service Bus konu uç noktasının kaynak grubunun adı.

subscriptionId
  • string

Service Bus konu uç noktasının abonelik tanımlayıcısı.

RoutingSource

DeviceMessages gibi yönlendirme kuralının uygulanacağı kaynak.

Name Type Description
DeviceJobLifecycleEvents
  • string
DeviceLifecycleEvents
  • string
DeviceMessages
  • string
Invalid
  • string
TwinChangeEvents
  • string

RoutingStorageContainerProperties

Depolama kapsayıcısı uç noktasıyla ilgili özellikler.

Name Type Description
batchFrequencyInSeconds
  • integer

Blobların depolama alanına yazıldığı zaman aralığı. Değer 60 ile 720 saniye arasında olmalıdır. Varsayılan değer 300 saniyedir.

connectionString
  • string

Depolama hesabının bağlantı dizesi.

containerName
  • string

Depolama hesabındaki depolama kapsayıcısının adı.

encoding
  • string

İletileri bloblara seri hale getirmek için kullanılan kodlama. Desteklenen değerler 'avro' ve 'avroDeflate' değerleridir. Varsayılan değer :'avro'.

fileNameFormat
  • string

Blob için dosya adı biçimi. Varsayılan biçim: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. Tüm parametreler zorunlu olsa da yeniden sıralanabilir.

maxChunkSizeInBytes
  • integer

Depolama alanına yazılan her blob için maksimum bayt sayısı. Değer 10485760(10 MB) ile 524288000(500 MB) arasında olmalıdır. Varsayılan değer 314572800(300 MB) değeridir.

name
  • string

Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: events, operationsMonitoringEvents, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır.

resourceGroup
  • string

Depolama hesabının kaynak grubunun adı.

subscriptionId
  • string

Depolama hesabının abonelik tanımlayıcısı.

SharedAccessSignatureAuthorizationRule

IoT hub paylaşılan erişim ilkesinin özellikleri.

Name Type Description
keyName
  • string

Paylaşılan erişim ilkesinin adı.

primaryKey
  • string

Birincil anahtar.

rights

Paylaşılan erişim ilkesine atanan izinler.

secondaryKey
  • string

İkincil anahtar.

StorageEndpointProperties

Dosya yükleme için Azure Depolama uç noktasının özellikleri.

Name Type Description
connectionString
  • string

Dosyaların karşıya yüklendiği Azure Depolama hesabının bağlantı dizesi.

containerName
  • string

Dosyaları karşıya yüklediğiniz kök kapsayıcının adı. Kapsayıcının mevcut olması gerekmez, ancak belirtilen connectionString kullanılarak oluşturulabilir olmalıdır.

sasTtlAsIso8601
  • string

Dosya yükleme için IoT Hub tarafından oluşturulan SAS URI'sinin geçerli olduğu süre. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options.