Iot Hub Resource - Create Or Update

Service:

IoT Hub

API Version:

2018-04-01

IoT hub'ının meta verilerini oluşturun veya güncelleştirin. Bir özelliği değiştirmek için her zamanki düzen 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	İçinde	Gerekli	Tür	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'nin sürümü.

İstek Başlığı

Name	Gerekli	Tür	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	Gerekli	Tür	Description
location	True	string	Kaynak konumu.
sku	True	IotHubSkuInfo	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		IotHubProperties	IotHub özellikleri
tags		object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	IotHubDescription	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	IotHubDescription	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'si 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	ErrorDetails	DefaultErrorResponse

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

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

HTTP

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

Status code:

200

{
  "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
  }
}

Status code:

201

{
  "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

Name	Description
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ı Connections, 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ç noktası 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	Tür	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	Tür	Description
DeviceManagement	string
None	string

CloudToDeviceProperties

IoT hub buluttan cihaza mesajlaşma özellikleri.

Name	Tür	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	FeedbackProperties	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	Tür	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	Tür	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	Tür	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, en fazla 64 karakter uzunluğundadır ve benzersiz olmalıdır.
source	RoutingSource	Yönlendirme kuralının uygulanacağı kaynak. Örneğin, DeviceMessages

FeedbackProperties

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

Name	Tür	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 göndermeyi deneme 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	Tür	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	IotHubProperties	IotHub özellikleri
sku	IotHubSkuInfo	IotHub SKU bilgileri
tags	object	Kaynak etiketleri.
type	string	Kaynak türü.

IotHubProperties

IoT hub'ının özellikleri.

Name	Tür	Description
authorizationPolicies	SharedAccessSignatureAuthorizationRule[]	IoT hub'ına bir bağlantının güvenliğini sağlamak için kullanabileceğiniz paylaşılan erişim ilkeleri.
cloudToDevice	CloudToDeviceProperties	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	<string,  EventHubProperties>	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	Capabilities	IoT hub'ı için etkinleştirilen özellikler ve özellikler.
hostName	string	Ana bilgisayarın adı.
ipFilterRules	IpFilterRule[]	IP filtresi kuralları.
messagingEndpoints	<string,  MessagingEndpointProperties>	Dosya karşıya yükleme bildirim kuyruğunun mesajlaşma uç noktası özellikleri.
operationsMonitoringProperties	OperationsMonitoringProperties	IoT hub'ına yönelik işlemleri izleme özellikleri. Sözlüğün olası anahtarları Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods'tır.
provisioningState	string	Sağlama durumu.
routing	RoutingProperties	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	<string,  StorageEndpointProperties>	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	Tür	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	Tür	Description
capacity	integer	Sağlanan IoT Hub birimi sayısı. Bkz. https://docs.microsoft.com/azure/azure-subscription-service-limits#iot-hub-limits.
name	IotHubSku	SKU'nun adı.
tier	IotHubSkuTier	IoT hub'ına yönelik faturalama katmanı.

IotHubSkuTier

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

Name	Tür	Description
Basic	string
Free	string
Standard	string

IpFilterActionType

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

Name	Tür	Description
Accept	string
Reject	string

IpFilterRule

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

Name	Tür	Description
action	IpFilterActionType	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	Tür	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ı Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods'tır.

Name	Tür	Description
events	object

RouteProperties

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

Name	Tür	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, en fazla 64 karakter uzunluğundadır ve benzersiz olmalıdır.
source	RoutingSource	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	Tür	Description
eventHubs	RoutingEventHubProperties[]	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	RoutingServiceBusQueueEndpointProperties[]	Yönlendirme kurallarına göre IoT hub'ının iletileri yönlendirdığı Service Bus kuyruğu uç noktalarının listesi.
serviceBusTopics	RoutingServiceBusTopicEndpointProperties[]	Yönlendirme kurallarına göre IoT hub'ının iletileri yönlendirdığı Service Bus konu uç noktalarının listesi.
storageContainers	RoutingStorageContainerProperties[]	Yönlendirme kurallarına göre IoT hub'ının iletileri yönlendirdığı depolama kapsayıcısı uç noktalarının listesi.

RoutingEventHubProperties

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

Name	Tür	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 uzunluk üst sınırı 64 karakterdir. Aşağıdaki adlar ayrılmıştır: olaylar, 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	Tür	Description
endpoints	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.
fallbackRoute	FallbackRouteProperties	'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	RouteProperties[]	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ç noktası türleriyle ilgili özellikler.

Name	Tür	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 uzunluk üst sınırı 64 karakterdir. Aşağıdaki adlar ayrılmıştır: olaylar, 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	Tür	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 uzunluk üst sınırı 64 karakterdir. Aşağıdaki adlar ayrılmıştır: olaylar, 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	Tür	Description
DeviceJobLifecycleEvents	string
DeviceLifecycleEvents	string
DeviceMessages	string
Invalid	string
TwinChangeEvents	string

RoutingStorageContainerProperties

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

Name	Tür	Description
batchFrequencyInSeconds	integer	Blobların depolamaya 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'. 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 uzunluk üst sınırı 64 karakterdir. Aşağıdaki adlar ayrılmıştır: olaylar, 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	Tür	Description
keyName	string	Paylaşılan erişim ilkesinin adı.
primaryKey	string	Birincil anahtar.
rights	AccessRights	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	Tür	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.