Iot Hub Resource - Create Or Update

참조

Service:: IoT Hub

API Version:: 2018-04-01

Iot 허브의 메타데이터를 만들거나 업데이트합니다. 속성을 수정하는 일반적인 패턴은 IoT Hub 메타데이터 및 보안 메타데이터를 검색한 다음 새 본문의 수정된 값과 결합하여 IoT Hub를 업데이트하는 것입니다. JSON에서 특정 속성이 누락된 경우 IoT Hub 업데이트하면 이러한 값이 기본값으로 대체되어 예기치 않은 동작이 발생할 수 있습니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	IoT Hub를 포함하는 리소스 그룹의 이름입니다.
resourceName	path	True	string	IoT Hub의 이름입니다.
subscriptionId	path	True	string	구독 식별자입니다.
api-version	query	True	string	API 버전입니다.

요청 헤더

Name	필수	형식	Description
If-Match		string	IoT Hub ETag입니다. 새 IoT Hub 만들기 위해 를 지정하지 마세요. 기존 IoT Hub 업데이트하는 데 필요합니다.

요청 본문

Name	필수	형식	Description
location	True	string	리소스 위치입니다.
sku	True	IotHubSkuInfo	IotHub SKU 정보
etag		string	Etag 필드는 필요하지 않습니다 . 응답 본문에 제공된 경우 일반 ETag 규칙에 따라 헤더로도 제공해야 합니다.
properties		IotHubProperties	IotHub 속성
tags		object	리소스 태그입니다.

응답

Name	형식	Description
200 OK	IotHubDescription	만들기 또는 업데이트 작업에 대한 상태 폴링 요청에 대한 응답으로 반환됩니다. 본문에는 전환 프로비전 상태를 나타내는 리소스 표현이 포함됩니다.
201 Created	IotHubDescription	이 작업을 실행하는 데는 오랜 시간이 소요됩니다. 유효성 검사가 완료되면 작업이 201을 반환합니다. 응답에는 상태 URL을 포함하는 Azure-AsyncOperation 헤더가 포함됩니다. 클라이언트는 작업의 상태 대한 상태 URL을 폴링해야 합니다. 성공하면 작업은 HTTP 상태 코드 201(OK)을 반환합니다.
Other Status Codes	ErrorDetails	DefaultErrorResponse

보안

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	사용자 계정 가장

예제

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

정의

Name	Description
AccessRights	공유 액세스 정책에 할당된 권한입니다.
Capabilities	IoT Hub에 대해 사용하도록 설정된 기능 및 기능입니다.
CloudToDeviceProperties	IoT Hub 클라우드-디바이스 메시징 속성입니다.
ErrorDetails	오류 세부 정보입니다.
EventHubProperties	IoT Hub에서 사용하는 프로비전된 Event Hub 호환 엔드포인트의 속성입니다.
FallbackRouteProperties	대체 경로의 속성입니다. IoT Hub 대체 엔드포인트로 메시지를 라우팅할 때 이러한 속성을 사용합니다.
FeedbackProperties	클라우드-디바이스 메시지에 대한 피드백 큐의 속성입니다.
IotHubDescription	IoT Hub에 대한 설명입니다.
IotHubProperties	IoT Hub의 속성입니다.
IotHubSku	SKU의 이름입니다.
IotHubSkuInfo	IoT Hub의 SKU에 대한 정보입니다.
IotHubSkuTier	IoT Hub에 대한 청구 계층입니다.
IpFilterActionType	이 규칙에서 캡처한 요청에 대해 원하는 작업입니다.
IpFilterRule	IoT Hub에 대한 IP 필터 규칙입니다.
MessagingEndpointProperties	이 IoT Hub에서 사용하는 메시징 엔드포인트의 속성입니다.
OperationsMonitoringProperties	IoT Hub에 대한 작업 모니터링 속성입니다. 사전에 사용할 수 있는 키는 Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods입니다.
RouteProperties	IoT Hub가 메시지를 엔드포인트로 라우팅하는 데 사용하는 라우팅 규칙의 속성입니다.
RoutingEndpoints	IoT Hub가 라우팅 규칙에 따라 메시지를 라우팅하는 사용자 지정 엔드포인트와 관련된 속성입니다. 유료 허브의 모든 엔드포인트 유형에서 최대 10개의 사용자 지정 엔드포인트가 허용되며 무료 허브의 모든 엔드포인트 유형에서 1개의 사용자 지정 엔드포인트만 허용됩니다.
RoutingEventHubProperties	이벤트 허브 엔드포인트와 관련된 속성입니다.
RoutingProperties	IoT Hub의 라우팅 관련 속성입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging을 참조하세요.
RoutingServiceBusQueueEndpointProperties	Service Bus 큐 엔드포인트 유형과 관련된 속성입니다.
RoutingServiceBusTopicEndpointProperties	Service Bus 토픽 엔드포인트 유형과 관련된 속성입니다.
RoutingSource	라우팅 규칙이 적용될 원본(예: DeviceMessages)입니다.
RoutingStorageContainerProperties	스토리지 컨테이너 엔드포인트와 관련된 속성입니다.
SharedAccessSignatureAuthorizationRule	IoT Hub 공유 액세스 정책의 속성입니다.
StorageEndpointProperties	파일 업로드를 위한 Azure Storage 엔드포인트의 속성입니다.

AccessRights

공유 액세스 정책에 할당된 권한입니다.

Name	형식	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에 대해 사용하도록 설정된 기능 및 기능입니다.

Name	형식	Description
DeviceManagement	string
None	string

CloudToDeviceProperties

IoT Hub 클라우드-디바이스 메시징 속성입니다.

Name	형식	Description
defaultTtlAsIso8601	string	디바이스 큐의 클라우드-디바이스 메시지에 대한 기본 라이브 시간입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages를 참조하세요.
feedback	FeedbackProperties	클라우드-디바이스 메시지에 대한 피드백 큐의 속성입니다.
maxDeliveryCount	integer	디바이스 큐의 클라우드-디바이스 메시지에 대한 최대 배달 수입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages를 참조하세요.

ErrorDetails

오류 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
details	string	오류 세부 정보입니다.
httpStatusCode	string	HTTP 상태 코드입니다.
message	string	오류 메시지입니다.

EventHubProperties

IoT Hub에서 사용하는 프로비전된 Event Hub 호환 엔드포인트의 속성입니다.

Name	형식	Description
endpoint	string	Event Hub 호환 엔드포인트입니다.
partitionCount	integer	Event Hub 호환 엔드포인트에서 디바이스-클라우드 메시지를 수신하기 위한 파티션 수입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages를 참조하세요.
partitionIds	string[]	Event Hub 호환 엔드포인트의 파티션 ID입니다.
path	string	Event Hub 호환 이름입니다.
retentionTimeInDays	integer	디바이스-클라우드 메시지의 보존 시간(일)입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages을 참조하세요.

FallbackRouteProperties

대체 경로의 속성입니다. IoT Hub 대체 엔드포인트로 메시지를 라우팅할 때 이러한 속성을 사용합니다.

Name	형식	Description
condition	string	대체 경로를 적용하기 위해 평가되는 조건입니다. 조건이 제공되지 않으면 기본적으로 true로 평가됩니다. 문법은 다음을 참조하세요. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language
endpointNames	string[]	조건을 충족하는 메시지가 라우팅되는 엔드포인트 목록입니다. 현재 1개 엔드포인트만 허용됩니다.
isEnabled	boolean	대체 경로를 사용할지 여부를 지정하는 데 사용됩니다.
name	string	경로의 이름입니다. 이름은 영숫자 문자, 마침표, 밑줄, 하이픈만 포함할 수 있으며 최대 길이는 64자이며 고유해야 합니다.
source	RoutingSource	라우팅 규칙을 적용할 원본입니다. 예를 들어 DeviceMessages

FeedbackProperties

클라우드-디바이스 메시지에 대한 피드백 큐의 속성입니다.

Name	형식	Description
lockDurationAsIso8601	string	피드백 큐의 잠금 기간입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages를 참조하세요.
maxDeliveryCount	integer	IoT Hub가 피드백 큐에 메시지를 배달하려고 시도하는 횟수입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages를 참조하세요.
ttlAsIso8601	string	IoT Hub에서 만료되기 전에 메시지를 사용할 수 있는 기간입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages를 참조하세요.

IotHubDescription

IoT Hub에 대한 설명입니다.

Name	형식	Description
etag	string	Etag 필드는 필요하지 않습니다 . 응답 본문에 제공된 경우 일반적인 ETag 규칙에 따라 헤더로도 제공해야 합니다.
id	string	리소스 식별자입니다.
location	string	리소스 위치입니다.
name	string	리소스 이름입니다.
properties	IotHubProperties	IotHub 속성
sku	IotHubSkuInfo	IotHub SKU 정보
tags	object	리소스 태그입니다.
type	string	리소스 종류입니다.

IotHubProperties

IoT Hub의 속성입니다.

Name	형식	Description
authorizationPolicies	SharedAccessSignatureAuthorizationRule[]	IoT Hub에 대한 연결을 보호하는 데 사용할 수 있는 공유 액세스 정책입니다.
cloudToDevice	CloudToDeviceProperties	IoT Hub 클라우드-디바이스 메시징 속성입니다.
comments	string	IoT Hub 주석.
enableFileUploadNotifications	boolean	True이면 파일 업로드 알림이 활성화됩니다.
eventHubEndpoints	<string, EventHubProperties>	Event Hub 호환 엔드포인트 속성입니다. 이 사전의 가능한 키는 이벤트 및 작업모니터링Events입니다. 이러한 두 키는 모두 IoT Hub에 대한 호출을 만들거나 업데이트하는 동안 사전에 있어야 합니다.
features	Capabilities	IoT Hub에 대해 사용하도록 설정된 기능 및 기능입니다.
hostName	string	호스트의 이름입니다.
ipFilterRules	IpFilterRule[]	IP 필터 규칙입니다.
messagingEndpoints	<string, MessagingEndpointProperties>	파일 업로드 알림 큐에 대한 메시징 엔드포인트 속성입니다.
operationsMonitoringProperties	OperationsMonitoringProperties	IoT Hub에 대한 작업 모니터링 속성입니다. 사전에 사용할 수 있는 키는 Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods입니다.
provisioningState	string	프로비저닝 상태입니다.
routing	RoutingProperties	IoT Hub의 라우팅 관련 속성입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging을 참조하세요.
state	string	허브 상태입니다.
storageEndpoints	<string, StorageEndpointProperties>	파일을 업로드할 수 있는 Azure Storage 엔드포인트 목록입니다. 현재는 하나의 Azure Storage 계정만 구성할 수 있으며 해당 키는 $default. 둘 이상의 스토리지 계정을 지정하면 오류가 throw됩니다. enableFileUploadNotifications 속성이 True로 설정된 경우 이 속성의 값을 지정하지 않으면 오류가 발생합니다.

IotHubSku

SKU의 이름입니다.

Name	형식	Description
B1	string
B2	string
B3	string
F1	string
S1	string
S2	string
S3	string

IotHubSkuInfo

IoT Hub의 SKU에 대한 정보입니다.

Name	형식	Description
capacity	integer	프로비전된 IoT Hub 단위의 수입니다. https://docs.microsoft.com/azure/azure-subscription-service-limits#iot-hub-limits를 참조하세요.
name	IotHubSku	SKU의 이름입니다.
tier	IotHubSkuTier	IoT Hub에 대한 청구 계층입니다.

IotHubSkuTier

IoT Hub에 대한 청구 계층입니다.

Name	형식	Description
Basic	string
Free	string
Standard	string

IpFilterActionType

이 규칙에서 캡처한 요청에 대해 원하는 작업입니다.

Name	형식	Description
Accept	string
Reject	string

IpFilterRule

IoT Hub에 대한 IP 필터 규칙입니다.

Name	형식	Description
action	IpFilterActionType	이 규칙에서 캡처한 요청에 대해 원하는 작업입니다.
filterName	string	IP 필터 규칙의 이름입니다.
ipMask	string	규칙에 대한 CIDR 표기법의 IP 주소 범위를 포함하는 문자열입니다.

MessagingEndpointProperties

이 IoT Hub에서 사용하는 메시징 엔드포인트의 속성입니다.

Name	형식	Description
lockDurationAsIso8601	string	잠금 기간입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload를 참조하세요.
maxDeliveryCount	integer	IoT Hub가 메시지를 배달하려고 시도하는 횟수입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload를 참조하세요.
ttlAsIso8601	string	IoT Hub에서 만료되기 전에 메시지를 사용할 수 있는 기간입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload를 참조하세요.

OperationsMonitoringProperties

IoT Hub에 대한 작업 모니터링 속성입니다. 사전에 사용할 수 있는 키는 Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods입니다.

Name	형식	Description
events	object

RouteProperties

IoT Hub가 메시지를 엔드포인트로 라우팅하는 데 사용하는 라우팅 규칙의 속성입니다.

Name	형식	Description
condition	string	라우팅 규칙을 적용하기 위해 평가되는 조건입니다. 조건이 제공되지 않으면 기본적으로 true로 평가됩니다. 문법은 다음을 참조하세요. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language
endpointNames	string[]	조건을 충족하는 메시지가 라우팅되는 엔드포인트 목록입니다. 현재 하나의 엔드포인트만 허용됩니다.
isEnabled	boolean	경로를 사용할지 여부를 지정하는 데 사용됩니다.
name	string	경로의 이름입니다. 이름은 영숫자 문자, 마침표, 밑줄, 하이픈만 포함할 수 있으며 최대 길이는 64자이며 고유해야 합니다.
source	RoutingSource	라우팅 규칙이 적용될 원본(예: DeviceMessages)입니다.

RoutingEndpoints

IoT Hub가 라우팅 규칙에 따라 메시지를 라우팅하는 사용자 지정 엔드포인트와 관련된 속성입니다. 유료 허브의 모든 엔드포인트 유형에서 최대 10개의 사용자 지정 엔드포인트가 허용되며 무료 허브의 모든 엔드포인트 유형에서 1개의 사용자 지정 엔드포인트만 허용됩니다.

Name	형식	Description
eventHubs	RoutingEventHubProperties[]	라우팅 규칙에 따라 IoT Hub가 메시지를 라우팅하는 Event Hubs 엔드포인트 목록입니다. 이 목록에는 기본 제공 Event Hubs 엔드포인트가 포함되지 않습니다.
serviceBusQueues	RoutingServiceBusQueueEndpointProperties[]	라우팅 규칙에 따라 IoT Hub가 메시지를 라우팅하는 Service Bus 큐 엔드포인트 목록입니다.
serviceBusTopics	RoutingServiceBusTopicEndpointProperties[]	라우팅 규칙에 따라 IoT Hub가 메시지를 라우팅하는 Service Bus 토픽 엔드포인트 목록입니다.
storageContainers	RoutingStorageContainerProperties[]	라우팅 규칙에 따라 IoT Hub가 메시지를 라우팅하는 스토리지 컨테이너 엔드포인트 목록입니다.

RoutingEventHubProperties

이벤트 허브 엔드포인트와 관련된 속성입니다.

Name	형식	Description
connectionString	string	이벤트 허브 엔드포인트의 연결 문자열.
name	string	이 엔드포인트를 식별하는 이름입니다. 이름은 영숫자 문자, 마침표, 밑줄, 하이픈만 포함할 수 있으며 최대 길이는 64자입니다. 예약된 이름은 이벤트, operationsMonitoringEvents, fileNotifications, $default. 엔드포인트 이름은 엔드포인트 유형에서 고유해야 합니다.
resourceGroup	string	이벤트 허브 엔드포인트의 리소스 그룹 이름입니다.
subscriptionId	string	이벤트 허브 엔드포인트의 구독 식별자입니다.

RoutingProperties

IoT Hub의 라우팅 관련 속성입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging을 참조하세요.

Name	형식	Description
endpoints	RoutingEndpoints	IoT Hub가 라우팅 규칙에 따라 메시지를 라우팅하는 사용자 지정 엔드포인트와 관련된 속성입니다. 유료 허브의 모든 엔드포인트 유형에서 최대 10개의 사용자 지정 엔드포인트가 허용되며 무료 허브의 모든 엔드포인트 유형에서 1개의 사용자 지정 엔드포인트만 허용됩니다.
fallbackRoute	FallbackRouteProperties	'경로' 섹션에 지정된 조건이 충족되지 않는 경우 대체 경로로 사용되는 경로의 속성입니다. 선택적 매개 변수입니다. 이 속성을 설정하지 않으면 'routes' 섹션에 지정된 조건을 충족하지 않는 메시지가 기본 제공 eventhub 엔드포인트로 라우팅됩니다.
routes	RouteProperties[]	IoT Hub에서 메시지를 기본 제공 및 사용자 지정 엔드포인트로 라우팅하는 데 사용하는 사용자 제공 라우팅 규칙 목록입니다. 유료 허브에는 최대 100개의 라우팅 규칙이 허용되며 무료 허브에는 최대 5개의 라우팅 규칙이 허용됩니다.

RoutingServiceBusQueueEndpointProperties

Service Bus 큐 엔드포인트 유형과 관련된 속성입니다.

Name	형식	Description
connectionString	string	Service Bus 큐 엔드포인트의 연결 문자열.
name	string	이 엔드포인트를 식별하는 이름입니다. 이름은 영숫자 문자, 마침표, 밑줄, 하이픈만 포함할 수 있으며 최대 길이는 64자입니다. 예약된 이름은 이벤트, operationsMonitoringEvents, fileNotifications, $default. 엔드포인트 이름은 엔드포인트 유형에서 고유해야 합니다. 이름은 실제 큐 이름과 같을 필요가 없습니다.
resourceGroup	string	Service Bus 큐 엔드포인트의 리소스 그룹 이름입니다.
subscriptionId	string	Service Bus 큐 엔드포인트의 구독 식별자입니다.

RoutingServiceBusTopicEndpointProperties

Service Bus 토픽 엔드포인트 유형과 관련된 속성입니다.

Name	형식	Description
connectionString	string	Service Bus 토픽 엔드포인트의 연결 문자열.
name	string	이 엔드포인트를 식별하는 이름입니다. 이름은 영숫자 문자, 마침표, 밑줄, 하이픈만 포함할 수 있으며 최대 길이는 64자입니다. 예약된 이름은 이벤트, operationsMonitoringEvents, fileNotifications, $default. 엔드포인트 이름은 엔드포인트 유형에서 고유해야 합니다. 이름은 실제 토픽 이름과 같을 필요가 없습니다.
resourceGroup	string	Service Bus 토픽 엔드포인트의 리소스 그룹 이름입니다.
subscriptionId	string	Service Bus 토픽 엔드포인트의 구독 식별자입니다.

RoutingSource

라우팅 규칙이 적용될 원본(예: DeviceMessages)입니다.

Name	형식	Description
DeviceJobLifecycleEvents	string
DeviceLifecycleEvents	string
DeviceMessages	string
Invalid	string
TwinChangeEvents	string

RoutingStorageContainerProperties

스토리지 컨테이너 엔드포인트와 관련된 속성입니다.

Name	형식	Description
batchFrequencyInSeconds	integer	Blob이 스토리지에 기록되는 시간 간격입니다. 값은 60초에서 720초 사이여야 합니다. 기본값은 300초입니다.
connectionString	string	스토리지 계정의 연결 문자열.
containerName	string	스토리지 계정의 스토리지 컨테이너 이름입니다.
encoding	string	메시지를 Blob으로 직렬화하는 데 사용되는 인코딩입니다. 지원되는 값은 'avro' 및 'avroDeflate'입니다. 기본값은 'avro'입니다.
fileNameFormat	string	Blob의 파일 이름 형식입니다. 기본 형식은 {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}입니다. 모든 매개 변수는 필수이지만 순서를 변경할 수 있습니다.
maxChunkSizeInBytes	integer	스토리지에 기록된 각 Blob의 최대 바이트 수입니다. 값은 10485760(10MB)와 524288000(500MB) 사이여야 합니다. 기본값은 314572800(300MB)입니다.
name	string	이 엔드포인트를 식별하는 이름입니다. 이름은 영숫자 문자, 마침표, 밑줄, 하이픈만 포함할 수 있으며 최대 길이는 64자입니다. 예약된 이름은 이벤트, operationsMonitoringEvents, fileNotifications, $default. 엔드포인트 이름은 엔드포인트 유형에서 고유해야 합니다.
resourceGroup	string	스토리지 계정의 리소스 그룹 이름입니다.
subscriptionId	string	스토리지 계정의 구독 식별자입니다.

SharedAccessSignatureAuthorizationRule

IoT Hub 공유 액세스 정책의 속성입니다.

Name	형식	Description
keyName	string	공유 액세스 정책의 이름입니다.
primaryKey	string	기본 키입니다.
rights	AccessRights	공유 액세스 정책에 할당된 권한입니다.
secondaryKey	string	보조 키입니다.

StorageEndpointProperties

파일 업로드를 위한 Azure Storage 엔드포인트의 속성입니다.

Name	형식	Description
connectionString	string	파일이 업로드되는 Azure Storage 계정의 연결 문자열.
containerName	string	파일을 업로드하는 루트 컨테이너의 이름입니다. 컨테이너는 존재하지 않아도 되지만 지정된 connectionString을 사용하여 만들 수 있어야 합니다.
sasTtlAsIso8601	string	파일 업로드를 위해 IoT Hub 생성된 SAS URI가 유효한 기간입니다. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options를 참조하세요.