The REST APIs for IoT Hub offer programmatic access to the device, messaging, and job services, as well as the resource provder, in IoT Hub.
Further information can be found in the IoT Hub REST docs
Use this API to manage the IoT hubs in your Azure subscription.
Generates verification code for proof of possession flow. The verification code will be used to generate a leaf certificate.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
certificateName
|
string Pattern: ^[A-Za-z0-9-._]{1,64}$
|
The name of the certificate |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
If-Match
|
string |
ETag of the Certificate. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
CertificateWithNonceDescription
|
object |
The X509 Certificate. |
etag
|
string Read-only |
The entity tag. |
||||||||||||||||||||||||||||
id
|
string Read-only |
The resource identifier. |
||||||||||||||||||||||||||||
name
|
string Read-only |
The name of the certificate. |
||||||||||||||||||||||||||||
properties
|
CertificatePropertiesWithNonce | |||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||
type
|
string Read-only |
The resource type. |
Verifies the certificate's private key possession by providing the leaf cert issued by the verifying pre uploaded certificate.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
certificateName
|
string Pattern: ^[A-Za-z0-9-._]{1,64}$
|
The name of the certificate |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
If-Match
|
string |
ETag of the Certificate. |
Name | Data Type | Description |
---|---|---|
CertificateVerificationDescription
|
object |
The JSON-serialized leaf certificate |
certificate
|
string |
base-64 representation of X509 certificate .cer file or just .pem file content. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
CertificateDescription
|
object |
The X509 Certificate. |
etag
|
string Read-only |
The entity tag. |
|||||||||||||||||||||||||
id
|
string Read-only |
The resource identifier. |
|||||||||||||||||||||||||
name
|
string Read-only |
The name of the certificate. |
|||||||||||||||||||||||||
properties
|
CertificateProperties | ||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||
type
|
string Read-only |
The resource type. |
Deletes an existing X509 certificate or does nothing if it does not exist.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
certificateName
|
string Pattern: ^[A-Za-z0-9-._]{1,64}$
|
The name of the certificate |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
If-Match
|
string |
ETag of the Certificate. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Returns the certificate.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
certificateName
|
string Pattern: ^[A-Za-z0-9-._]{1,64}$
|
The name of the certificate |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
CertificateDescription
|
object |
The X509 Certificate. |
etag
|
string Read-only |
The entity tag. |
|||||||||||||||||||||||||
id
|
string Read-only |
The resource identifier. |
|||||||||||||||||||||||||
name
|
string Read-only |
The name of the certificate. |
|||||||||||||||||||||||||
properties
|
CertificateProperties | ||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||
type
|
string Read-only |
The resource type. |
Adds new or replaces existing certificate.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
certificateName
|
string Pattern: ^[A-Za-z0-9-._]{1,64}$
|
The name of the certificate |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
If-Match
|
string |
ETag of the Certificate. Do not specify for creating a brand new certificate. Required to update an existing certificate. |
Name | Data Type | Description |
---|---|---|
CertificateBodyDescription
|
object |
The JSON-serialized X509 Certificate. |
certificate
|
string |
base-64 representation of the X509 leaf certificate .cer file or just .pem file content. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
CertificateDescription
|
object |
The X509 Certificate. |
etag
|
string Read-only |
The entity tag. |
|||||||||||||||||||||||||
id
|
string Read-only |
The resource identifier. |
|||||||||||||||||||||||||
name
|
string Read-only |
The name of the certificate. |
|||||||||||||||||||||||||
properties
|
CertificateProperties | ||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||
type
|
string Read-only |
The resource type. |
Name | Data Type | Description |
---|---|---|
CertificateDescription
|
object |
The X509 Certificate. |
etag
|
string Read-only |
The entity tag. |
|||||||||||||||||||||||||
id
|
string Read-only |
The resource identifier. |
|||||||||||||||||||||||||
name
|
string Read-only |
The name of the certificate. |
|||||||||||||||||||||||||
properties
|
CertificateProperties | ||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||
type
|
string Read-only |
The resource type. |
Returns the list of certificates.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
CertificateListDescription
|
object |
The JSON-serialized array of Certificate objects. |
value
|
array [CertificateDescription] |
The array of Certificate objects. |
|||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Delete a consumer group from an Event Hub-compatible endpoint in an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
eventHubEndpointName
|
string |
The name of the Event Hub-compatible endpoint in the IoT hub. |
name
|
string |
The name of the consumer group to delete. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Delete an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
IotHubDescription
|
object |
The description of the IoT hub. |
etag
|
string |
The Etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
properties
|
IotHubProperties |
IotHub properties |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sku
|
IotHubSkuInfo |
IotHub SKU info |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
IotHubDescription
|
object |
The description of the IoT hub. |
etag
|
string |
The Etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
properties
|
IotHubProperties |
IotHub properties |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sku
|
IotHubSkuInfo |
IotHub SKU info |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Get all the IoT hubs in a subscription.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
IotHubDescriptionListResult
|
object |
The JSON-serialized array of IotHubDescription objects with a next link. |
nextLink
|
string Read-only |
The next link. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value
|
array [IotHubDescription] |
The array of IotHubDescription objects. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Get the number of free and paid iot hubs in the subscription
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
UserSubscriptionQuotaListResult
|
object |
Json-serialized array of User subscription quota response |
nextLink
|
string Read-only |
|||||||||||||||||||||||
value
|
array [UserSubscriptionQuota] | |||||||||||||||||||||||
Properties
|
Get the health for routing endpoints.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string | |
iotHubName
|
string |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
EndpointHealthDataListResult
|
object |
The JSON-serialized array of EndpointHealthData objects with a next link. |
nextLink
|
string Read-only |
Link to more results |
||||||||||
value
|
array [EndpointHealthData] |
JSON-serialized array of Endpoint health data |
||||||||||
Properties
|
Get the statistics from an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
RegistryStatistics
|
object |
Identity registry statistics. |
disabledDeviceCount
|
long Read-only |
The count of disabled devices in the identity registry. |
enabledDeviceCount
|
long Read-only |
The count of enabled devices in the identity registry. |
totalDeviceCount
|
long Read-only |
The total count of devices in the identity registry. |
Get a consumer group from the Event Hub-compatible device-to-cloud endpoint for an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
eventHubEndpointName
|
string |
The name of the Event Hub-compatible endpoint in the IoT hub. |
name
|
string |
The name of the consumer group to retrieve. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
EventHubConsumerGroupInfo
|
object |
The properties of the EventHubConsumerGroupInfo object. |
etag
|
string Read-only |
The etag. |
id
|
string Read-only |
The Event Hub-compatible consumer group identifier. |
name
|
string Read-only |
The Event Hub-compatible consumer group name. |
properties
|
object |
The tags. |
type
|
string Read-only |
the resource type. |
Get a list of the consumer groups in the Event Hub-compatible device-to-cloud endpoint in an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
eventHubEndpointName
|
string |
The name of the Event Hub-compatible endpoint. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
EventHubConsumerGroupsListResult
|
object |
The JSON-serialized array of Event Hub-compatible consumer group names with a next link. |
nextLink
|
string Read-only |
The next link. |
|||||||||||||||||||
value
|
array [EventHubConsumerGroupInfo] |
List of consumer groups objects |
|||||||||||||||||||
Properties
|
Get the details of a job from an IoT hub. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
jobId
|
string |
The job identifier. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
JobResponse
|
object |
The properties of the Job Response object. |
endTimeUtc
|
string Read-only |
The time the job stopped processing. |
failureReason
|
string Read-only |
If status == failed, this string containing the reason for the failure. |
jobId
|
string Read-only |
The job identifier. |
parentJobId
|
string Read-only |
The job identifier of the parent job, if any. |
startTimeUtc
|
string Read-only |
The start time of the job. |
status
|
string Read-only Allowed values: - unknown - enqueued - running - completed - failed - cancelled |
The status of the job. |
statusMessage
|
string Read-only |
The status message for the job. |
type
|
string Read-only Allowed values: - unknown - export - import - backup - readDeviceProperties - writeDeviceProperties - updateDeviceConfiguration - rebootDevice - factoryResetDevice - firmwareUpdate |
The type of the job. |
Get a list of all the jobs in an IoT hub. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
JobResponseListResult
|
object |
The JSON-serialized array of JobResponse objects with a next link. |
nextLink
|
string Read-only |
The next link. |
||||||||||||||||||||||||||||
value
|
array [JobResponse] |
The array of JobResponse objects. |
||||||||||||||||||||||||||||
Properties
|
Get the quota metrics for an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
IotHubQuotaMetricInfoListResult
|
object |
The JSON-serialized array of IotHubQuotaMetricInfo objects with a next link. |
nextLink
|
string Read-only |
The next link. |
|||||||||||||
value
|
array [IotHubQuotaMetricInfo] |
The array of quota metrics objects. |
|||||||||||||
Properties
|
Get the list of valid SKUs for an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
IotHubSkuDescriptionListResult
|
object |
The JSON-serialized array of IotHubSkuDescription objects with a next link. |
nextLink
|
string Read-only |
The next link. |
|||||||||||||||||||||||||||||
value
|
array [IotHubSkuDescription] |
The array of IotHubSkuDescription. |
|||||||||||||||||||||||||||||
Properties
|
Get the non-security related metadata of an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
IotHubDescription
|
object |
The description of the IoT hub. |
etag
|
string |
The Etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
properties
|
IotHubProperties |
IotHub properties |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sku
|
IotHubSkuInfo |
IotHub SKU info |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Get all the IoT hubs in a resource group.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
IotHubDescriptionListResult
|
object |
The JSON-serialized array of IotHubDescription objects with a next link. |
nextLink
|
string Read-only |
The next link. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value
|
array [IotHubDescription] |
The array of IotHubDescription objects. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Lists all of the available IoT Hub REST API operations.
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
OperationListResult
|
Result of the request to list IoT Hub operations. It contains a list of operations and a URL link to get the next set of results. |
nextLink
|
string Read-only |
URL to get the next set of operation list results if there are any. |
||||||||||
value
|
array [Operation] |
List of IoT Hub operations supported by the Microsoft.Devices resource provider. |
||||||||||
Properties
|
Update an existing IoT Hub tags. to update other fields use the CreateOrUpdate method
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
Resource group identifier. |
resourceName
|
string |
Name of iot hub to update. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
TagsResource
|
A container holding only the Tags for a resource, allowing the user to update the tags on an IoT Hub instance. |
tags
|
Resource tags |
Name | Data Type | Description |
---|---|---|
IotHubDescription
|
object |
The description of the IoT hub. |
etag
|
string |
The Etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
properties
|
IotHubProperties |
IotHub properties |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sku
|
IotHubSkuInfo |
IotHub SKU info |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Check if an IoT hub name is available.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
OperationInputs
|
object |
Input values. |
name
|
string |
The name of the IoT hub to check. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
IotHubNameAvailabilityInfo
|
object |
The properties indicating whether a given IoT hub name is available. |
message
|
string |
The detailed reason message. |
nameAvailable
|
boolean Read-only |
The value which indicates whether the provided name is available. |
reason
|
string Read-only Allowed values: - Invalid - AlreadyExists |
The reason for unavailability. |
Test all routes configured in this Iot Hub
Name | Data Type | Description |
---|---|---|
iotHubName
|
string |
IotHub to be tested |
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
resource group which Iot Hub belongs to |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
TestAllRoutesInput
|
object |
Input for testing all routes |
message
|
RoutingMessage |
Routing message |
|||||||||||||
Properties
|
|||||||||||||||
routingSource
|
string Allowed values: - Invalid - DeviceMessages - TwinChangeEvents - DeviceLifecycleEvents - DeviceJobLifecycleEvents |
Routing source |
|||||||||||||
twin
|
RoutingTwin |
Routing Twin Reference |
|||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
TestAllRoutesResult
|
object |
Result of testing all routes |
routes
|
array [MatchedRoute] |
JSON-serialized array of matched routes |
|||||||||||||||||||||||||||||
Properties
|
Test the new route for this Iot Hub
Name | Data Type | Description |
---|---|---|
iotHubName
|
string |
IotHub to be tested |
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
resource group which Iot Hub belongs to |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
TestRouteInput
|
object |
Input for testing route |
message
|
RoutingMessage |
Routing message |
|||||||||||||||||||
Properties
|
|||||||||||||||||||||
route
|
RouteProperties |
Route properties |
|||||||||||||||||||
Properties
|
|||||||||||||||||||||
twin
|
RoutingTwin |
Routing Twin Reference |
|||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
TestRouteResult
|
object |
Result of testing one route |
details
|
TestRouteResultDetails |
Detailed result of testing route |
|||||||
Properties
|
|||||||||
result
|
string Allowed values: - undefined - false - true |
Result of testing route |
Get a shared access policy by name from an IoT hub. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-security.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
keyName
|
string |
The name of the shared access policy. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
SharedAccessSignatureAuthorizationRule
|
object |
The properties of an IoT hub shared access policy. |
keyName
|
string |
The name of the shared access policy. |
primaryKey
|
string |
The primary key. |
rights
|
string Allowed values: - RegistryRead - RegistryWrite - ServiceConnect - DeviceConnect - RegistryRead, RegistryWrite - RegistryRead, ServiceConnect - RegistryRead, DeviceConnect - RegistryWrite, ServiceConnect - RegistryWrite, DeviceConnect - ServiceConnect, DeviceConnect - RegistryRead, RegistryWrite, ServiceConnect - RegistryRead, RegistryWrite, DeviceConnect - RegistryRead, ServiceConnect, DeviceConnect - RegistryWrite, ServiceConnect, DeviceConnect - RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect |
The permissions assigned to the shared access policy. |
secondaryKey
|
string |
The secondary key. |
Exports all the device identities in the IoT hub identity registry to an Azure Storage blob container. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ExportDevicesRequest
|
object |
Use to provide parameters when requesting an export of all devices in the IoT hub. |
excludeKeys
|
boolean |
The value indicating whether keys should be excluded during export. |
exportBlobContainerUri
|
string |
The export blob container URI. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
JobResponse
|
object |
The properties of the Job Response object. |
endTimeUtc
|
string Read-only |
The time the job stopped processing. |
failureReason
|
string Read-only |
If status == failed, this string containing the reason for the failure. |
jobId
|
string Read-only |
The job identifier. |
parentJobId
|
string Read-only |
The job identifier of the parent job, if any. |
startTimeUtc
|
string Read-only |
The start time of the job. |
status
|
string Read-only Allowed values: - unknown - enqueued - running - completed - failed - cancelled |
The status of the job. |
statusMessage
|
string Read-only |
The status message for the job. |
type
|
string Read-only Allowed values: - unknown - export - import - backup - readDeviceProperties - writeDeviceProperties - updateDeviceConfiguration - rebootDevice - factoryResetDevice - firmwareUpdate |
The type of the job. |
Import, update, or delete device identities in the IoT hub identity registry from a blob. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ImportDevicesRequest
|
object |
Use to provide parameters when requesting an import of all devices in the hub. |
inputBlobContainerUri
|
string |
The input blob container URI. |
outputBlobContainerUri
|
string |
The output blob container URI. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
JobResponse
|
object |
The properties of the Job Response object. |
endTimeUtc
|
string Read-only |
The time the job stopped processing. |
failureReason
|
string Read-only |
If status == failed, this string containing the reason for the failure. |
jobId
|
string Read-only |
The job identifier. |
parentJobId
|
string Read-only |
The job identifier of the parent job, if any. |
startTimeUtc
|
string Read-only |
The start time of the job. |
status
|
string Read-only Allowed values: - unknown - enqueued - running - completed - failed - cancelled |
The status of the job. |
statusMessage
|
string Read-only |
The status message for the job. |
type
|
string Read-only Allowed values: - unknown - export - import - backup - readDeviceProperties - writeDeviceProperties - updateDeviceConfiguration - rebootDevice - factoryResetDevice - firmwareUpdate |
The type of the job. |
Get the security metadata for an IoT hub. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-security.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
SharedAccessSignatureAuthorizationRuleListResult
|
object |
The list of shared access policies with a next link. |
nextLink
|
string Read-only |
The next link. |
||||||||||||||||
value
|
array [SharedAccessSignatureAuthorizationRule] |
The list of shared access policies. |
||||||||||||||||
Properties
|
Add a consumer group to an Event Hub-compatible endpoint in an IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
eventHubEndpointName
|
string |
The name of the Event Hub-compatible endpoint in the IoT hub. |
name
|
string |
The name of the consumer group to add. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
EventHubConsumerGroupInfo
|
object |
The properties of the EventHubConsumerGroupInfo object. |
etag
|
string Read-only |
The etag. |
id
|
string Read-only |
The Event Hub-compatible consumer group identifier. |
name
|
string Read-only |
The Event Hub-compatible consumer group name. |
properties
|
object |
The tags. |
type
|
string Read-only |
the resource type. |
Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub metadata and security metadata, and then combine them with the modified values in a new body to update the IoT hub.
Name | Data Type | Description |
---|---|---|
subscriptionId
|
string |
The subscription identifier. |
resourceGroupName
|
string |
The name of the resource group that contains the IoT hub. |
resourceName
|
string |
The name of the IoT hub. |
Name | Data Type | Description |
---|---|---|
api-version
|
string |
The version of the API. |
Name | Data Type | Description |
---|---|---|
If-Match
|
string |
ETag of the IoT Hub. Do not specify for creating a brand new IoT Hub. Required to update an existing IoT Hub. |
Name | Data Type | Description |
---|---|---|
IotHubDescription
|
object |
The description of the IoT hub. |
etag
|
string |
The Etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
properties
|
IotHubProperties |
IotHub properties |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sku
|
IotHubSkuInfo |
IotHub SKU info |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
ErrorDetails
|
object |
Error details. |
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
Name | Data Type | Description |
---|---|---|
IotHubDescription
|
object |
The description of the IoT hub. |
etag
|
string |
The Etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
properties
|
IotHubProperties |
IotHub properties |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sku
|
IotHubSkuInfo |
IotHub SKU info |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
IotHubDescription
|
object |
The description of the IoT hub. |
etag
|
string |
The Etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
properties
|
IotHubProperties |
IotHub properties |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sku
|
IotHubSkuInfo |
IotHub SKU info |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
The JSON-serialized X509 Certificate.
Name | Data Type | Description |
---|---|---|
certificate
|
string |
base-64 representation of the X509 leaf certificate .cer file or just .pem file content. |
The X509 Certificate.
Name | Data Type | Description | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
etag
|
string Read-only |
The entity tag. |
|||||||||||||||||||||||||
id
|
string Read-only |
The resource identifier. |
|||||||||||||||||||||||||
name
|
string Read-only |
The name of the certificate. |
|||||||||||||||||||||||||
properties
|
CertificateProperties | ||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||
type
|
string Read-only |
The resource type. |
The JSON-serialized array of Certificate objects.
Name | Data Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
value
|
array [CertificateDescription] |
The array of Certificate objects. |
|||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
The description of an X509 CA Certificate.
Name | Data Type | Description |
---|---|---|
certificate
|
string |
The certificate content |
created
|
string Read-only |
The certificate's create date and time. |
expiry
|
string Read-only |
The certificate's expiration date and time. |
isVerified
|
boolean Read-only |
Determines whether certificate has been verified. |
subject
|
string Read-only |
The certificate's subject name. |
thumbprint
|
string Read-only |
The certificate's thumbprint. |
updated
|
string Read-only |
The certificate's last update date and time. |
The description of an X509 CA Certificate including the challenge nonce issued for the Proof-Of-Possession flow.
Name | Data Type | Description |
---|---|---|
certificate
|
string Read-only |
The certificate content |
created
|
string Read-only |
The certificate's create date and time. |
expiry
|
string Read-only |
The certificate's expiration date and time. |
isVerified
|
boolean Read-only |
Determines whether certificate has been verified. |
subject
|
string Read-only |
The certificate's subject name. |
thumbprint
|
string Read-only |
The certificate's thumbprint. |
updated
|
string Read-only |
The certificate's last update date and time. |
verificationCode
|
string Read-only |
The certificate's verification code that will be used for proof of possession. |
The JSON-serialized leaf certificate
Name | Data Type | Description |
---|---|---|
certificate
|
string |
base-64 representation of X509 certificate .cer file or just .pem file content. |
The X509 Certificate.
Name | Data Type | Description | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
etag
|
string Read-only |
The entity tag. |
||||||||||||||||||||||||||||
id
|
string Read-only |
The resource identifier. |
||||||||||||||||||||||||||||
name
|
string Read-only |
The name of the certificate. |
||||||||||||||||||||||||||||
properties
|
CertificatePropertiesWithNonce | |||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||
type
|
string Read-only |
The resource type. |
The health data for an endpoint
Name | Data Type | Description |
---|---|---|
endpointId
|
string |
Id of the endpoint |
healthStatus
|
string Allowed values: - unknown - healthy - unhealthy - dead |
Health status |
The JSON-serialized array of EndpointHealthData objects with a next link.
Name | Data Type | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
Link to more results |
||||||||||
value
|
array [EndpointHealthData] |
JSON-serialized array of Endpoint health data |
||||||||||
Properties
|
Error details.
Name | Data Type | Description |
---|---|---|
code
|
string Read-only |
The error code. |
details
|
string Read-only |
The error details. |
httpStatusCode
|
string Read-only |
The HTTP status code. |
message
|
string Read-only |
The error message. |
The properties of the EventHubConsumerGroupInfo object.
Name | Data Type | Description |
---|---|---|
etag
|
string Read-only |
The etag. |
id
|
string Read-only |
The Event Hub-compatible consumer group identifier. |
name
|
string Read-only |
The Event Hub-compatible consumer group name. |
properties
|
object |
The tags. |
type
|
string Read-only |
the resource type. |
The JSON-serialized array of Event Hub-compatible consumer group names with a next link.
Name | Data Type | Description | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
The next link. |
|||||||||||||||||||
value
|
array [EventHubConsumerGroupInfo] |
List of consumer groups objects |
|||||||||||||||||||
Properties
|
Use to provide parameters when requesting an export of all devices in the IoT hub.
Name | Data Type | Description |
---|---|---|
excludeKeys
|
boolean |
The value indicating whether keys should be excluded during export. |
exportBlobContainerUri
|
string |
The export blob container URI. |
Use to provide parameters when requesting an import of all devices in the hub.
Name | Data Type | Description |
---|---|---|
inputBlobContainerUri
|
string |
The input blob container URI. |
outputBlobContainerUri
|
string |
The output blob container URI. |
The description of the IoT hub.
Name | Data Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
etag
|
string |
The Etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
properties
|
IotHubProperties |
IotHub properties |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sku
|
IotHubSkuInfo |
IotHub SKU info |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
The JSON-serialized array of IotHubDescription objects with a next link.
Name | Data Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
The next link. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value
|
array [IotHubDescription] |
The array of IotHubDescription objects. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
The properties indicating whether a given IoT hub name is available.
Name | Data Type | Description |
---|---|---|
message
|
string |
The detailed reason message. |
nameAvailable
|
boolean Read-only |
The value which indicates whether the provided name is available. |
reason
|
string Read-only Allowed values: - Invalid - AlreadyExists |
The reason for unavailability. |
The properties of an IoT hub.
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
authorizationPolicies
|
array [SharedAccessSignatureAuthorizationRule] |
The shared access policies you can use to secure a connection to the IoT hub. |
||||||||||||||||
Properties
|
||||||||||||||||||
cloudToDevice
|
CloudToDeviceProperties | |||||||||||||||||
comments
|
string |
IoT hub comments. |
||||||||||||||||
enableFileUploadNotifications
|
boolean |
If True, file upload notifications are enabled. |
||||||||||||||||
eventHubEndpoints
|
object |
The Event Hub-compatible endpoint properties. The possible keys to this dictionary are events and operationsMonitoringEvents. Both of these keys have to be present in the dictionary while making create or update calls for the IoT hub. |
||||||||||||||||
features
|
string Allowed values: - None - DeviceManagement |
The capabilities and features enabled for the IoT hub. |
||||||||||||||||
hostName
|
string Read-only |
The name of the host. |
||||||||||||||||
ipFilterRules
|
array [IpFilterRule] |
The IP filter rules. |
||||||||||||||||
messagingEndpoints
|
object |
The messaging endpoint properties for the file upload notification queue. |
||||||||||||||||
operationsMonitoringProperties
|
OperationsMonitoringProperties | |||||||||||||||||
provisioningState
|
string Read-only |
The provisioning state. |
||||||||||||||||
routing
|
RoutingProperties | |||||||||||||||||
state
|
string Read-only |
The hub state. |
||||||||||||||||
storageEndpoints
|
object |
The list of Azure Storage endpoints where you can upload files. Currently you can configure only one Azure Storage account and that MUST have its key as $default. Specifying more than one storage account causes an error to be thrown. Not specifying a value for this property when the enableFileUploadNotifications property is set to True, causes an error to be thrown. |
Quota metrics properties.
Name | Data Type | Description |
---|---|---|
currentValue
|
long Read-only |
The current value for the quota metric. |
maxValue
|
long Read-only |
The maximum value of the quota metric. |
name
|
string Read-only |
The name of the quota metric. |
The JSON-serialized array of IotHubQuotaMetricInfo objects with a next link.
Name | Data Type | Description | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
The next link. |
|||||||||||||
value
|
array [IotHubQuotaMetricInfo] |
The array of quota metrics objects. |
|||||||||||||
Properties
|
SKU properties.
Name | Data Type | Description | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
capacity
|
IotHubCapacity |
IotHub capacity |
|||||||||||||
resourceType
|
string Read-only |
The type of the resource. |
|||||||||||||
sku
|
IotHubSkuInfo |
The type of the resource. |
|||||||||||||
Properties
|
The JSON-serialized array of IotHubSkuDescription objects with a next link.
Name | Data Type | Description | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
The next link. |
|||||||||||||||||||||||||||||
value
|
array [IotHubSkuDescription] |
The array of IotHubSkuDescription. |
|||||||||||||||||||||||||||||
Properties
|
Information about the SKU of the IoT hub.
Name | Data Type | Description |
---|---|---|
capacity
|
long |
The number of provisioned IoT Hub units. See: https://docs.microsoft.com/azure/azure-subscription-service-limits#iot-hub-limits. |
name
|
string Allowed values: - F1 - S1 - S2 - S3 - B1 - B2 - B3 |
The name of the SKU. |
tier
|
string Read-only Allowed values: - Free - Standard - Basic |
The billing tier for the IoT hub. |
The properties of the Job Response object.
Name | Data Type | Description |
---|---|---|
endTimeUtc
|
string Read-only |
The time the job stopped processing. |
failureReason
|
string Read-only |
If status == failed, this string containing the reason for the failure. |
jobId
|
string Read-only |
The job identifier. |
parentJobId
|
string Read-only |
The job identifier of the parent job, if any. |
startTimeUtc
|
string Read-only |
The start time of the job. |
status
|
string Read-only Allowed values: - unknown - enqueued - running - completed - failed - cancelled |
The status of the job. |
statusMessage
|
string Read-only |
The status message for the job. |
type
|
string Read-only Allowed values: - unknown - export - import - backup - readDeviceProperties - writeDeviceProperties - updateDeviceConfiguration - rebootDevice - factoryResetDevice - firmwareUpdate |
The type of the job. |
The JSON-serialized array of JobResponse objects with a next link.
Name | Data Type | Description | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
The next link. |
||||||||||||||||||||||||||||
value
|
array [JobResponse] |
The array of JobResponse objects. |
||||||||||||||||||||||||||||
Properties
|
Routes that matched
Name | Data Type | Description | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
properties
|
RouteProperties |
Properties of routes that matched |
|||||||||||||||||||
Properties
|
IoT Hub REST API operation
Name | Data Type | Description |
---|---|---|
display
|
||
name
|
string Read-only |
Operation name: {provider}/{resource}/{read | write | action | delete} |
Input values.
Name | Data Type | Description |
---|---|---|
name
|
string |
The name of the IoT hub to check. |
Result of the request to list IoT Hub operations. It contains a list of operations and a URL link to get the next set of results.
Name | Data Type | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
URL to get the next set of operation list results if there are any. |
||||||||||
value
|
array [Operation] |
List of IoT Hub operations supported by the Microsoft.Devices resource provider. |
||||||||||
Properties
|
Identity registry statistics.
Name | Data Type | Description |
---|---|---|
disabledDeviceCount
|
long Read-only |
The count of disabled devices in the identity registry. |
enabledDeviceCount
|
long Read-only |
The count of enabled devices in the identity registry. |
totalDeviceCount
|
long Read-only |
The total count of devices in the identity registry. |
The properties of a routing rule that your IoT hub uses to route messages to endpoints.
Name | Data Type | Description |
---|---|---|
condition
|
string |
The condition that is evaluated to apply the routing rule. If no condition is provided, it evaluates to true by default. For grammar, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language |
endpointNames
|
array [] Minimum: 1 Maximum: 1 |
The list of endpoints to which messages that satisfy the condition are routed. Currently only one endpoint is allowed. |
isEnabled
|
boolean |
Used to specify whether a route is enabled. |
name
|
string Pattern: ^[A-Za-z0-9-._]{1,64}$
|
The name of the route. The name can only include alphanumeric characters, periods, underscores, hyphens, has a maximum length of 64 characters, and must be unique. |
source
|
string Allowed values: - Invalid - DeviceMessages - TwinChangeEvents - DeviceLifecycleEvents - DeviceJobLifecycleEvents |
The source that the routing rule is to be applied to, such as DeviceMessages. |
Routing message
Name | Data Type | Description |
---|---|---|
appProperties
|
object |
App properties |
body
|
string |
Body of routing message |
systemProperties
|
object |
System properties |
Twin reference input parameter. This is an optional parameter
Name | Data Type | Description |
---|---|---|
properties
|
||
tags
|
object |
Twin Tags |
The properties of an IoT hub shared access policy.
Name | Data Type | Description |
---|---|---|
keyName
|
string |
The name of the shared access policy. |
primaryKey
|
string |
The primary key. |
rights
|
string Allowed values: - RegistryRead - RegistryWrite - ServiceConnect - DeviceConnect - RegistryRead, RegistryWrite - RegistryRead, ServiceConnect - RegistryRead, DeviceConnect - RegistryWrite, ServiceConnect - RegistryWrite, DeviceConnect - ServiceConnect, DeviceConnect - RegistryRead, RegistryWrite, ServiceConnect - RegistryRead, RegistryWrite, DeviceConnect - RegistryRead, ServiceConnect, DeviceConnect - RegistryWrite, ServiceConnect, DeviceConnect - RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect |
The permissions assigned to the shared access policy. |
secondaryKey
|
string |
The secondary key. |
The list of shared access policies with a next link.
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
The next link. |
||||||||||||||||
value
|
array [SharedAccessSignatureAuthorizationRule] |
The list of shared access policies. |
||||||||||||||||
Properties
|
A container holding only the Tags for a resource, allowing the user to update the tags on an IoT Hub instance.
Name | Data Type | Description |
---|---|---|
tags
|
Resource tags |
Input for testing all routes
Name | Data Type | Description | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
message
|
RoutingMessage |
Routing message |
|||||||||||||
Properties
|
|||||||||||||||
routingSource
|
string Allowed values: - Invalid - DeviceMessages - TwinChangeEvents - DeviceLifecycleEvents - DeviceJobLifecycleEvents |
Routing source |
|||||||||||||
twin
|
RoutingTwin |
Routing Twin Reference |
|||||||||||||
Properties
|
Result of testing all routes
Name | Data Type | Description | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
routes
|
array [MatchedRoute] |
JSON-serialized array of matched routes |
|||||||||||||||||||||||||||||
Properties
|
Input for testing route
Name | Data Type | Description | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
message
|
RoutingMessage |
Routing message |
|||||||||||||||||||
Properties
|
|||||||||||||||||||||
route
|
RouteProperties |
Route properties |
|||||||||||||||||||
Properties
|
|||||||||||||||||||||
twin
|
RoutingTwin |
Routing Twin Reference |
|||||||||||||||||||
Properties
|
Result of testing one route
Name | Data Type | Description | |||||||
---|---|---|---|---|---|---|---|---|---|
details
|
TestRouteResultDetails |
Detailed result of testing route |
|||||||
Properties
|
|||||||||
result
|
string Allowed values: - undefined - false - true |
Result of testing route |
Detailed result of testing a route
Name | Data Type | Description |
---|---|---|
compilationErrors
|
array [RouteCompilationError] |
JSON-serialized list of route compilation errors |
User subscription quota response
Name | Data Type | Description |
---|---|---|
currentValue
|
integer |
Current number of IotHub type |
id
|
string |
IotHub type id |
limit
|
integer |
Numerical limit on IotHub type |
name
|
Name |
IotHub type |
type
|
string |
Response type |
unit
|
string |
Unit of IotHub type |
Json-serialized array of User subscription quota response
Name | Data Type | Description | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
nextLink
|
string Read-only |
|||||||||||||||||||||||
value
|
array [UserSubscriptionQuota] | |||||||||||||||||||||||
Properties
|
'OAuth' Authentication Scheme
Reference: RFC5849, Section 3.5.1
Azure Active Directory OAuth2 Flow
Flow:implicit
https://login.microsoftonline.com/common/oauth2/authorize
user_impersonation
: impersonate your user accountMs-code-generation-settings |
|
Origin - Format | swagger |
Origin - Url | https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/specification/iothub/resource-manager/Microsoft.Devices/stable/2018-04-01/iothub.json |
Origin - Version | 2.0 |
Preferred | No |
Provider Name | azure.com |
Service Name | iothub |
API Version | 2018-04-01 |