Description:

Post messages to a Microsoft Azure IOT hub, sending the contents of the Flow File to Azure IOT hub.

Tags:

azure, Microsoft, cloud, IOT, streaming, streams, send, messages

Properties:

In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, and whether a property is considered “sensitive”, meaning that its value will be encrypted. Before entering a value in a sensitive property, ensure that the nifi.properties file has an entry for the property nifi.sensitive.props.key.

Name

Default Value

Allowable Values

Description

IOT Hub Name

The name of the Azure IOT Hub-compatible name

Device Id

Device Id of the Azure IOT Hub device.

Device Primary Key

Primary key from Azure IOT Hub device details.

Relationships:

Name

Description

Failure Any Flow File that is not able to transfer data successfully to the Azure IOT IOT Hub will be transferred to this Relationship.
Success Any Flow File that can transfer data successfully to the Azure IOT will be transferred to this Relationship.

Read attributes:

None Specified

Write attributes:

Name

Description

eventhub.enqueued.timestamp The time (in milliseconds since epoch, UTC) at which the message was enqueued in the Azure Event Hub.
eventhub.offset The offset into the partition at which the message was stored.
eventhub.sequence The Azure Sequence number associated with the message.
eventhub.name The name of the Event Hub from which the message was pulled.
eventhub.partition The name of the Azure Partition from which the message was pulled.

State management:

This component does not store state.

Restricted:

This component is not restricted.

How to get the property value from Azure Portal?

Get value for IOT Hub Endpoint, Hub Name and Partitions value

Step 1: Login into Azure IoT account by https://portal.azure.com/ with respected credentials.

Step 2: Choose your respected Azure IOT Hub in dashboard page.

Step 3: Type as Endpoints in search box, choose and select the Events from Built-in endpoints. It will show the value of partitions, Hub-compatible name and endpoint.

Example to take the value for hub endpoint in copied URL:

Only copy the hub endpoint as in bold format like below

Endpoint=sb://iothub-ns-testio-28516-1a234ebdf.servicebus.windows.net/;SharedAccessKeyName=iothubowner;SharedAccessKey=GAhyblkHa4sPCI+d+/aax4hHoAMg+0GfVGE0lYpaR9o=

Get value for Device Name Id and Device primary key:

Type as device in search box, choose Device Explorer and click your device Id from list. It will show the value of device Id and device primary key values.

Get value for Shared Access Primary Key:

Type as Shared access in search box, choose and select the iothubowner from POLICY. It will show the multiple value of shared access keys and copy first one for shared access primary key value.

How to send data to the Microsoft Azure IOT Hub using Data Integration Platform?

In Data Integration Platform use PutAzureIOTHub Processor to send the data from flow file to corresponding Microsoft Azure IOT Hub. Here is the overview image for PutAzureIOTHub with success relationship.

Step 1:

  • Drag “PutAzureIOTHub” processor in canvas page and pair with success relationship. If data is sent to destination or queued successfully, its moves into success relationship.

  • In PutAzureIOTHub work flow update the data location details in GetFile processor and connect the relationship to PutAzureIOTHub processor.

Step 2: Once note down all the property value from azure portal in user account, filled all those values in corresponding field.

Step 3: Once job is success and it has able to send a message to Microsoft azure IOT Hub from requested flow file, the relationship is fall into success.