Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Warning

Configuration changes made through scripting do have the same validation as when made through the UI. 

For example, attempting to delete a Sets configuring that is being referenced by a Servers configuration will result in no action being performed.

...



Azure Injector 'type' keys

  • general
  • event-hub
  • event-hub-cert-file
  • iot-central
  • iot-edge-hub
  • iot-hub
  • iot-hub-cert-file
  • server-set
  • agent

...

Azure Injector 'iot-hub' keys

enabledboolean

Whether or not the configuration resource is enabled

namestring

The unique name for the configuration resource

protocolstringThe IoT Hub client protocol
serverSetstringThe Set this IoT Hub connection is associated with
certAuthEnabledbooleanEnable certificate based authentication instead of using a connection string
connectionStringstringThe Azure Connection String used for establishing a connection with the IoT Hub
mqttHostnamestringThe hostname of the Azure IoT Hub endpoint
deviceIdstringThe Device ID as provisioned in the Azure IoT Hub configuration
caCertFilestringCA Certificate file currently in use
clientCertFilestringClient certificate file currently in use
clientPrivateKeyFilestringClient private key file currently in use
clientKeyPasswordstringThe password associated with the certificate's private key (optional)
historyEnabledbooleanEnable Store and Forward capabilities for this stream
historyStoreTypestringThe Type of this Store & Forward mechanism
partionPeriodstringThe partitioning scheme to use for the Disk-backed history store (e.g. HOUR, MINUTE, DAY, etc)
historyMaxSizeintegerMaximum number of megabytes history can use before dropping the data
trimmerTaskPeriodMultiplierintegerA integer multiplier which is applied to the 'storageMonitorPeriod' which results in the period in which to trim potential excess history
historyMaxAgeintegerMaximum number of minutes to store history before dropping the data
queryTimeoutintegerThe H2 DB query timeout in seconds for the disk-backed history store
flushPeriodlongUpon reestablishing communication, the period to wait in milliseconds between sending when flushing messages
keepAliveintegerThe MQTT Client keep alive time (in seconds)
maxSizeintegerMaximum message size before dividing into multiple messages
expirationlongThe number of seconds before the session token expires
contentTypestringThe content type to include in the topic to Azure IoT Hub
contentEncodingstringThe content encoding to include in the topic to Azure IoT Hub
azureDateTimeFormatstringThe date/time format to use when pushing data to Azure
customTopicExtensionstringThe Custom Topic Extension to append to the topic string for things like Application Properties
h2dbDirectorystringDirectory to store the H2 Database in. Applicable for Disk-backed history store only
h2dbPortintegerTCP Port to connect to H2 Database. Applicable for Disk-backed history store only
dbMaxMessageSizeintegerThe Max Message size allowed in the Store and Forward DB. This only applies to Disk-Backed history stores
republishBirthsbooleanWhether or not to republish BIRTH messages on re

Azure Injector 'iot-hub-cert-file' keys

enabledboolean

Whether or not the configuration resource is enabled

namestring

The unique name for the configuration resource

fileNamestringThe name of this certificate file or private key
descriptionstringThe description of this certificate file or private key
fileContentsstringThe contents of this certificate file or private key

Azure Injector 'server-set' keys

enabledboolean

Whether or not the configuration resource is enabled

namestring

The unique name for the configuration resource

descriptionstringDescription of this Set
pushPolicystringThe Push Policy defines whether all cloud end-points in a set will be pushed to or only one will at a time - PUSH_TO_ALL or PUSH_TO_ANY

Azure Injector 'agent' keys

enabledboolean

Whether or not the configuration resource is enabled

namestring

The unique name for the configuration resource

tagProviderstringThe Name of the tag provider
tagPathstringA path to the root folder where the tag tree starts (optional)
pushTriggerstring

The trigger to use when pushing data - EVENT_DRIVEN, PERIODIC or HYBRID

tagPacingPeriodlong

If using an EVENT_DRIVEN Push trigger, the waiting period in milliseconds after an initial tag change event before pushing all changed tags.

If using PERIODIC, the number of milliseconds to wait between pushing all data

convertUdtsbooleanConverts UDT members to normal Tags
sendAllPropsbooleanSend all properties, including non-default properties, in Sparkplug BIRTH messages
includeQualityContextbooleanInclude the metric 'quality context' string in addition to the quality codes for metrics
includeInfoFoldersbooleanPush all Node and Device Info and Control folder information (from MQTT Engine) rather than excluding it
publishUdtDefinitionsbooleanPublish UDT Definitions in BIRTH
optimizeUdtsbooleanOptimizes UDT payload sizes in NDATA and DDATA payloads
serverSetstringThe Set this Agent is associated with
groupIdstringAn ID representing a logical grouping of Edge Nodes and Devices (optional)
edgeNodeIdstringAn ID representing an Edge or Network (EoN) Node (optional)
deviceIdstringAn ID representing a Device (optional)
filteredPropertiesstringA semicolon delimited list of Tag properties to filter/block from being published
birthSettleDelaylongThe amount of time to wait after setting the BIRTH timestamp before fetching the cached BIRTH payloads