Iot Hub Resource - Create Or Update

  • Başvuru
Service:
IoT Hub
API Version:
2018-04-01

Bir IoT hub'ını oluşturun veya meta verilerini 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 ardından IoT hub'ı güncelleştirmek için bunları yeni bir gövdede değiştirilen değerlerle birleştirmektir. JSON'da bazı özellikler eksikse, IoT Hub bu değerlerin varsayılana geri dönüşe neden olması beklenmeyen davranışlara neden olabilir.

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'larını içeren kaynak grubunun adı.
resourceName
 path True
  • string

IoT hub'ları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 Required Type Description
If-Match
  • string

ETag of the IoT Hub. Yepyeni bir uygulama oluşturmak için IoT Hub. Mevcut bir çalışma IoT Hub.

İ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ş sağlama durumunu gösteren kaynak gösterimini içerir.
201 Created

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

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ıza 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
Request Body
{
  "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

AccessRights

Paylaşılan erişim ilkesine atanan izinler.
Capabilities

IoT Hub 'ı için etkinleştirilen yetenekler 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önlendirçalışırken bu özellikleri kullanır.
FeedbackProperties

Buluttan cihaza iletiler için geri bildirim sırasının özellikleri.
IotHubDescription

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

IoT hub'larının özellikleri.
IotHubSku

SKU'nun adı.
IotHubSkuInfo

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

IoT Hub 'ı için faturalandırma 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 için işlem izleme özellikleri. Sözlüklerde olası anahtarlar şunlardır; bağlantılar, Devicetelemetri, C2DCommands, Deviceıdentityoperations, FileUploadOperations, rotalar, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods.
RouteProperties

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

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

Bir olay hub 'ı uç noktasıyla ilgili özellikler.
RoutingProperties

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

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

Service Bus konu uç noktası türleri ile ilgili özellikler.
RoutingSource

DeviceMessages gibi yönlendirme kuralının uygulanıyor olduğu kaynak.
RoutingStorageContainerProperties

Bir depolama kapsayıcısı uç noktasıyla ilgili özellikler.
SharedAccessSignatureAuthorizationRule

IoT hub'ı paylaşılan erişim ilkesi özellikleri.
StorageEndpointProperties

Dosya karşıya 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 yetenekler ve Özellikler.

Name Type Description
DeviceManagement
  • string
None
  • string

CloudToDeviceProperties

IoT Hub 'ı buluttan cihaza mesajlaşma özellikleri.

Name Type Description
defaultTtlAsIso8601
  • string

Cihaz sırasındaki buluttan cihaza iletiler için varsayılan olarak 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 sırasının özellikleri.
maxDeliveryCount
  • integer

Cihaz sırasındaki buluttan cihaza iletiler için en fazla teslimat 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 almak için 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

Olay Hub'ı ile uyumlu ad.
retentionTimeInDays
  • integer

Cihazdan buluta iletilerin gün olarak saklama süresi. 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önlendirçalışırken 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. Dilbilgisi için bkz.: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language
endpointNames
  • string[]

Koşulu karşılayan mesajların yönlendirildiği bitiş noktaları listesi. Şu anda yalnızca 1 uç noktaya izin veriliyor.
isEnabled
  • boolean

Geri dönüş yolunun etkin olup olmadığını belirtmek için kullanılır.
name
  • string

Yolun adı. Ad yalnızca alfasayısal karakter, nokta, alt çizgi, kısa çizgi içerebilir, en fazla 64 karakter uzunluğunda olabilir ve benzersiz olmalıdır.
source

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

FeedbackProperties

Buluttan cihaza iletiler için geri bildirim sırasının özellikleri.

Name Type Description
lockDurationAsIso8601
  • string

Geri bildirim sırasının 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ğuna ileti sunmaya kaç kez girişimde bulunduğu. Bkz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages .
ttlAsIso8601
  • string

Bir iletinin IoT Hub 'ı tarafından süresi dolmadan önce kullanabileceği süre. Bkz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages .

IotHubDescription

IoT hub'ları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'larının özellikleri.

Name Type Description
authorizationPolicies

IoT hub'ı bağlantısı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 yorumları.
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 mevcut olması gerekir.
features

IoT hub'ı için etkinleştirilmiş özellikler ve özellikler.
hostName
  • string

Ana bilgisayarın adı.
ipFilterRules

IP filtresi kuralları.
messagingEndpoints

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

IoT hub'ı için işlemleri izleme özellikleri. Sözlüğün olası anahtarları Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods'dır.
provisioningState
  • string

Sağlama durumu.
routing

IoT hub'ları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ük Depolama azure uç noktalarının listesi. Şu anda yalnızca tek bir Azure Depolama hesabı yapılandırabilirsiniz ve bu hesapta anahtar, $default. Birden fazla depolama hesabı belirtmek hataya neden olur. enableFileUploadNotifications özelliği True olarak ayarlanırsa bu özellik için bir değer belirtmezseniz, bir hatanın neden olması.

IotHubSku

SKU'nun adı.

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

IotHubSkuInfo

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

Name Type Description
capacity
  • integer

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

SKU'nun adı.
tier

IoT hub'ı için faturalama katmanı.

IotHubSkuTier

IoT Hub 'ı için faturalandırma 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ın CIDR ifadesinde 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 ileti sunmaya kaç kez deneme sayısı. Bkz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload .
ttlAsIso8601
  • string

Bir iletinin IoT Hub 'ı tarafından süresi dolmadan önce kullanabileceği süre. Bkz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload .

OperationsMonitoringProperties

IoT Hub için işlem izleme özellikleri. Sözlüklerde olası anahtarlar şunlardır; bağlantılar, Devicetelemetri, C2DCommands, Deviceıdentityoperations, FileUploadOperations, rotalar, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods.

Name Type Description
events
  • object

RouteProperties

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

Name Type Description
condition
  • string

Yönlendirme kuralını uygulamak için değerlendirilen koşul. Hiçbir koşul sağlanmazsa, varsayılan olarak true olarak değerlendirilir. Dilbilgisi 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 bitiş noktaları listesi. Şu anda yalnızca bir uç noktaya izin veriliyor.
isEnabled
  • boolean

Bir yolun etkin olup olmadığını belirtmek için kullanılır.
name
  • string

Yolun adı. Ad yalnızca alfasayısal karakter, nokta, alt çizgi, kısa çizgi içerebilir, en fazla 64 karakter uzunluğunda olabilir ve benzersiz olmalıdır.
source

Yönlendirme kuralının, DeviceMessages gibi, uygulanacak kaynak.

RoutingEndpoints

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

Name Type Description
eventHubs

IoT Hub 'ın iletileri yönlendirme kurallarına göre yönlendirdiğini belirten Event Hubs uç noktaları listesi. Bu liste, yerleşik Event Hubs uç noktasını içermez.
serviceBusQueues

ıot hub 'ın iletileri yönlendirme kurallarına göre yönlendirdiğini Service Bus kuyruk uç noktaları listesi.
serviceBusTopics

ıot hub 'ının iletileri yönlendirme kurallarına göre yönlendirdiğini Service Bus konu uç noktaları listesi.
storageContainers

IoT Hub 'ın iletileri yönlendirme kurallarına göre yönlendirdiğini gösteren depolama kapsayıcısı uç noktaları listesi.

RoutingEventHubProperties

Bir 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, noktalar, alt çizgiler, kısa çizgiler içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Şu adlar ayrılmıştır: olaylar, Operationsmonitorıngevents, 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'larının yönlendirmeyle ilgili özellikleri. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging

Name Type Description
endpoints

IoT hub'nizin iletileri yönlendirme kurallarına göre yönlendiren ö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ç nokta kullanılabilir.
fallbackRoute

'routes' bölümünde belirtilen koşulların hiçbiri karşılanamay olduğunda, geri dönme yolu olarak kullanılan yol özellikleri. Bu isteğe bağlı bir parametredir. Bu özellik ayarlanmazsa, 'routes' bölümünde belirtilen koşulların herhangi birini karşılamayan iletiler yerleşik eventhub uç noktasına yönlendiriliyor.
routes

IoT hub'ı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 izin verilir ve ücretsiz hub'lar için en fazla 5 yönlendirme kuralına izin verilir.

RoutingServiceBusQueueEndpointProperties

Service Bus kuyruk uç noktası 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, noktalar, alt çizgiler, kısa çizgiler içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Şu adlar ayrılmıştır: olaylar, Operationsmonitorıngevents, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Ad, gerçek sıra adıyla aynı olmamalıdır.
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ürleri ile 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, noktalar, alt çizgiler, kısa çizgiler içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Şu adlar ayrılmıştır: olaylar, Operationsmonitorıngevents, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Ad, gerçek konu adıyla aynı olmamalıdır.
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 uygulanıyor olduğu kaynak.

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

RoutingStorageContainerProperties

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

Name Type 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

Blob 'lara iletileri seri hale getirmek için kullanılan kodlama. Desteklenen değerler ' avro ' ve ' Avrosöndür '. Varsayılan değer 'avro' değeridir.
fileNameFormat
  • string

Blob için dosya adı biçimi. Varsayılan biçim {ıothub}/{Partition}/{yyyy}/{mm}/{dd}/{ss}/{mm} biçimindedir. Tüm parametreler zorunludur, ancak yeniden sıralanabilir.
maxChunkSizeInBytes
  • integer

Depolamaya yazılan her blob için en fazla bayt sayısı. Değer 10485760 (10 MB) ile 524288000 (500 MB) arasında olmalıdır. Varsayılan değer 314572800 ' dir (300MB).
name
  • string

Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, noktalar, alt çizgiler, kısa çizgiler içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Şu adlar ayrılmıştır: olaylar, Operationsmonitorıngevents, 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 ilkesi özellikleri.

Name Type Description
keyName
  • string

Paylaşılan erişim ilkesi adı.
primaryKey
  • string

Birincil anahtar.
rights

Paylaşılan erişim ilkesine atanan izinler.
secondaryKey
  • string

İkincil anahtar.

StorageEndpointProperties

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

Name Type Description
connectionString
  • string

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ı değil, belirtilen connectionString kullanılarak creatable olması gerekir.
sasTtlAsIso8601
  • string

Dosya karşıya yükleme için bir IoT Hub SAS URI'sı oluşturma süresi geçerlidir. Bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options .