Versions Compared

Key

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

Basic Operations

The following

...

basic operations are available for the Azure Injector Module and can be executed within any of the available Ignition

...

scopes using the format system.cirruslink.azure.operation

  • createConfig

...

Warning

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

For example, deleting a Sets configuring that is being referenced by a Servers configuration will result in the UI showing an Internal Error. Follow the instructions here to recover the configuration.

APIs

...

  • Parameters
    • type (str)
      • The type of configuration to create with valid options:

        • "Cert Files"
        • "IoT Hubs"
        • "IoT Edges"
        • "IoT Centrals"
        • "Event Hubs"
        • "Agents"
        • "Sets"
    • Map props
      • Dictionary of properties making up the configuration with the following keys and datatypes:
        • Cert Files
          • Name (str)

          • FileName (str)

          • FileContents (str)

          • Description (str)

        • IoT Hubs
          • Id (long)(cannot be null)

          • Name (str)

          • Enabled (bool)

          • Protocol (str) "MQTT"

          • AzureSetId (long)(must be included)

          • CertAuthEnabled (bool)

          • ConnectionString (str)

          • MqttHostname (str)

          • DeviceId (str)

          • CaCertFileId (long)

          • ClientCertFileId (long)

          • ClientPrivateKeyFileId (long)

          • ClientKeyPassword (str)

          • HistoryEnabled (bool)

          • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

          • MessageCapacity (int)(deprecated 4.0.19)

          • HistoryMaxSize (int)(added 4.0.22)
          • HistoryMaxAge (int)(added 4.0.19)
          • FlushPeriod (long)

          • H2dbDirectory (str)(added 4.0.25)
          • H2dbPort (int)(added 4.0.22)
          • KeepAlive (int)

          • MaxSize (int)

          • Expiration (long)

          • ContentType (str) "NONE" or "APPLICATION_JSON"

          • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"

          • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

          • CustomTopicExtension (str)

        • IoT Edges
          • Id (long)(cannot be null)

          • Name (str)

          • Enabled (bool)

          • Protocol (str) "MQTT"

          • AzureSetId (long)(must be included)

          • MqttServerUrl (str)

          • CertAuthEnabled (bool)

          • ConnectionString (str)

          • CaCertFileId (long)

          • ClientCertFileId (long)

          • ClientPrivateKeyFileId (long)

          • ClientKeyPassword (str)

          • HostnameVerification (bool)

          • MqttHostname (str)

          • DeviceId (str)

          • ModuleIdOption (str) "NONE", "ENVIRONMENT_VARIABLE" or "IGNITION_CONFIG"

          • ModuleId (str)

          • HistoryEnabled (bool)

          • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

          • MessageCapacity (int)(deprecated 4.0.19)

          • HistoryMaxSize (int)(added 4.0.22)
          • HistoryMaxAge (int)(added 4.0.19)
          • FlushPeriod (long)

          • H2dbDirectory (str)(added 4.0.25)
          • H2dbPort (int)(added 4.0.22)
          • KeepAlive (int)

          • MaxSize (int)

          • Expiration (long)

          • ContentType (str) "NONE" or "APPLICATION_JSON"

          • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"

          • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

          • CustomTopicExtension (str)

        • IoT Centrals
          • Id (Long)(cannot be null)
          • Name (str)
          • Enabled (bool)
          • ScopeId (str)
          • EnrollmentGroupSymmetricKey (str)
          • GlobalEndpoint (str)
          • ProvisionedDeviceId (str)
          • ModelId (str)
          • AureSetId (long)(must be included)
          • HistoryEnabled (bool)
          • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)
          • MessageCapacity (int)(deprecated 4.0.19)
          • HistoryMaxSize (int)(added 4.0.22)
          • HistoryMaxAge (int)(added 4.0.19)
          • FlushPeriod (long)
          • H2dbDirectory (str)(added 4.0.25)
          • H2dbPort (int)(added 4.0.22)
          • MaximumSize (int)
          • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPCOH" or "STRING_AZURE_COMPAT"
        • Event Hubs
          • Id (long)(cannot be null)

          • Name (str)

          • Enabled (bool)

          • AzureSetId(long)(must be included)

          • CertAuthEnabled (bool)(added 4.0.26)
          • TenantId (str)(added 4.0.26)
          • AzureServicePrincipalClientId (str)(added 4.0.26)
          • EventHubNamespace (str)(added 4.0.26)
          • EventHubName (str)(added 4.0.26)
          • ClientCertFileId (long)(added 4.0.26)
          • ClientPrivateKeyFileId (long)(added 4.0.26)
          • ClientKeyPassword (str)(added 4.0.26)
          • ConnectionString (str)

          • HistoryEnabled (bool)

          • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

          • MessageCapacity (int)(deprecated 4.0.19)

          • HistoryMaxSize (int)(added 4.0.22)
          • HistoryMaxAge (int)(added 4.0.19)
          • FlushPeriod (long)

          • H2dbDirectory (str)(added 4.0.25)
          • H2dbPort (int)(added 4.0.22)
          • MaxSize (int)

          • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"
          • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

        • Agents
          • Id (long)(cannot be null)

          • Name (str) (added 4.0.17)
          • Enabled (bool) (added 4.0.17)
          • TagProvider (str)

          • TagPath (str)

          • PushTrigger (str) "EVENT_DRIVEN", "PERIODIC" or "HYBRID"

          • TagPacingPeriod (long)

          • ConvertUdts (bool)

          • PublishUdtDefinitions (bool)

          • OptimizeUdts (bool)

          • AzureSetId (long)(must be included)

          • GroupId (str)

          • EdgeNodeId (str)

          • DeviceId (str)

          • FilteredProperties (str)

          • SendAllProps (bool)(added 4.0.25)
          • IncludeInfoFolders (bool)(added 4.0.30)
        • Sets
          • Id (long)(cannot be null)

          • Name (str)

          • Description (str)

          • PushPolicy (str) "PUSH_TO_ALL" or "PUSH_TO_ANY"

  • Return Value
    • A map representing the newly created configuration after it has been written to the database. (added 4.0.16)

...

  • Parameters
    • type (str)
      • The type of configuration to read with valid options:

        • "General"
        • "Cert Files"
        • "IoT Hubs"
        • "IoT Edges"
        • "IoT Centrals"
        • "Event Hubs"
        • "Agents"
        • "Sets"
  • Return Value
    • A List of Dictionaries of properties making up the configurations with the following keys and datatypes:
      • General
        • Id (long)

        • Enabled (bool)

      • Cert Files
        • Name (str)

        • FileName (str)

        • FileContents (str)

        • Description (str)

      • IoT Hubs
        • Id (long)

        • Name (str)

        • Enabled (str)

        • Protocol (str) "MQTT"

        • AzureSetId (long)

        • CertAuthEnabled (bool)

        • ConnectionString (str)

        • MqttHostname (str)

        • DeviceId (str)

        • CaCertFileId (long)

        • ClientCertFileId (long)

        • ClientPrivateKeyFileId (long)

        • ClientKeyPassword (str)

        • HistoryEnabled (bool)

        • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

        • MessageCapacity (int)(deprecated 4.0.19)

        • HistoryMaxSize (int)(added 4.0.22)
        • HistoryMaxAge (int)(added 4.0.19)
        • FlushPeriod (long)

        • H2dbDirectory (str)(added 4.0.25)
        • H2dbPort (int)(added 4.0.22)
        • KeepAlive (int)

        • MaxSize (int)

        • Expiration (long)

        • ContentType (str) "NONE" or "APPLICATION_JSON"

        • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"

        • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

        • CustomTopicExtension (str)

      •  IoT Edges
        • Id (long)

        • Name (str)

        • Enabled (str)

        • Protocol (str) "MQTT"

        • AzureSetId (long)

        • MqttServerUrl (str)

        • CertAuthEnabled (bool)

        • ConnectionString (str)

        • CaCertFileId (long)

        • ClientCertFileId (long)

        • ClientPrivateKeyFileId (long)

        • ClientKeyPassword (str)

        • HostnameVerification (bool)

        • MqttHostname (str)

        • DeviceId (str)

        • ModuleIdOption (str) "NONE", "ENVIRONMENT_VARIABLE" or "IGNITION_CONFIG"

        • ModuleId (str)

        • HistoryEnabled (bool)

        • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

        • MessageCapacity (int)(deprecated 4.0.19)

        • HistoryMaxSize (int)(added 4.0.22)
        • HistoryMaxAge (int)(added 4.0.19)
        • FlushPeriod (long)

        • H2dbDirectory (str)(added 4.0.25)
        • H2dbPort (int)(added 4.0.22)
        • KeepAlive (int)

        • MaxSize (int)

        • Expiration (long)

        • ContentType (str) "NONE" or "APPLICATION_JSON"

        • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"

        • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

        • CustomTopicExtension (str)

      • IoT Centrals
        • Id (long)
        • Name (str)
        • Enabled (bool)
        • ScopeId (str)
        • EnrollmentGroupSymmetricKey (str)
        • GlobalEndpoint (str)
        • ProvisionedDeviceId (str)
        • ModelId (str)
        • AzureSetId (str)
        • HistoryEnabled (bool)
        • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)
        • MessageCapacity (int)(deprecated 4.0.19)
        • HistoryMaxSize (int)(added 4.0.22)
        • HistoryMaxAge (int)(added 4.0.19)
        • FlushPeriod (long)
        • H2dbDirectory (str)(added 4.0.25)
        • H2dbPort (int)(added 4.0.22)
        • MaximumSize (int)
        • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCK" or "STRING_AZURE_COMPAT"
      • Event Hubs
        • Id (long)

        • Name (str)

        • Enabled (str)

        • CertAuthEnabled (bool)(added 4.0.26)
        • TenantId (str)(added 4.0.26)
        • AzureServicePrincipalClientId (str)(added 4.0.26)
        • EventHubNamespace (str)(added 4.0.26)
        • EventHubName (str)(added 4.0.26)
        • ClientCertFileId (long)(added 4.0.26)
        • ClientPrivateKeyFileId (long)(added 4.0.26)
        • ClientKeyPassword (str)(added 4.0.26)
        • ConnectionString (str)

        • HistoryEnabled (bool)

        • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

        • MessageCapacity (int)(deprecated 4.0.19)

        • HistoryMaxSize (int)(added 4.0.22)
        • HistoryMaxAge (int)(added 4.0.19)
        • FlushPeriod (long)

        • H2dbDirectory (str)(added 4.0.25)
        • H2dbPort (int)(added 4.0.22)
        • MaxSize (int)

        • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"
        • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

      • Agents
        • Id (long)

        • Name (str) (added 4.0.17)
        • Enabled (bool) (added 4.0.17)
        • TagProvider (str)

        • TagPath (str)

        • PushTrigger (str) "EVENT_DRIVEN", "PERIODIC" or "HYBRID"

        • TagPacingPeriod (long)

        • ConvertUdts (bool)

        • PublishUdtDefinitions (bool)

        • OptimizeUdts (bool)

        • AzureSetId (long)

        • GroupId (str)

        • EdgeNodeId (str)

        • DeviceId (str)

        • FilteredProperties (str)

        • SendAllProps (bool)(added 4.0.25)
        • IncludeInfoFolders (bool)(added 4.0.30)
      • Sets
        • Id (long)

        • Name (str)

        • Description (str)

        • PushPolicy (str) "PUSH_TO_ALL" or "PUSH_TO_ANY"

...

  • Parameters
    • Type (str)
      • The type of configuration to update with valid options:

        • "General"
        • "Cert Files"
        • "IoT Hubs"
        • "IoT Edges"
        • "IoT Centrals"
        • "Event Hubs"
        • "Agents"
        • "Sets"
    • Id (long)
      • The ID of the record to update
    • collisionPolicy(str)
      • "MergeOverwrite" or "Overwrite"
        • "MergeOverwrite" will replace the existing properties in the record ID with only those included in the call
        • "Overwrite" will replace all properties in the record ID with those in the call
    • Map props
      • Dictionary of properties making up the configuration with the following keys and datatypes:
        • General
          • Id (long)

          • Enabled (bool)

        • Cert Files
          • Name (str)

          • FileName (str)

          • FileContents (str)

          • Description (str)

        • IoT Hubs
          • Id (long)

          • Name (str)

          • Enabled (str)

          • Protocol (str) "MQTT"

          • AzureSetId (long)

          • CertAuthEnabled (bool)

          • ConnectionString (str)

          • MqttHostname (str)

          • DeviceId (str)

          • CaCertFileId (long)

          • ClientCertFileId (long)

          • ClientPrivateKeyFileId (long)

          • ClientKeyPassword (str)

          • HistoryEnabled (bool)

          • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

          • MessageCapacity (int)(deprecated 4.0.19)

          • HistoryMaxSize (int)(added 4.0.22)
          • HistoryMaxAge (int) (added 4.0.19)
          • FlushPeriod (long)

          • H2dbDirectory (str)(added 4.0.25)
          • H2dbPort (int)(added 4.0.22)
          • KeepAlive (int)

          • MaxSize (int)

          • Expiration (long)

          • ContentType (str) "NONE" or "APPLICATION_JSON"

          • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"

          • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

          • CustomTopicExtension (str)

        •  IoT Edges
          • Id (long)

          • Name (str)

          • Enabled (str)

          • Protocol (str) "MQTT"

          • AzureSetId (long)

          • MqttServerUrl (str)

          • CertAuthEnabled (bool)

          • ConnectionString (str)

          • CaCertFileId (long)

          • ClientCertFileId (long)

          • ClientPrivateKeyFileId (long)

          • ClientKeyPassword (str)

          • HostnameVerification (bool)

          • MqttHostname (str)

          • DeviceId (str)

          • ModuleIdOption (str) "NONE", "ENVIRONMENT_VARIABLE" or "IGNITION_CONFIG"

          • ModuleId (str)

          • HistoryEnabled (bool)

          • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

          • MessageCapacity (int)(deprecated 4.0.19)

          • HistoryMaxSize (int)(added 4.0.22)
          • HistoryMaxAge (int)(added 4.0.19)
          • FlushPeriod (long)

          • H2dbDirectory (str)(added 4.0.25)
          • H2dbPort (int)(added 4.0.22)
          • KeepAlive (int)

          • MaxSize (int)

          • Expiration (long)

          • ContentType (str) "NONE" or "APPLICATION_JSON"

          • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"

          • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

          • CustomTopicExtension (str)

        • IoT Centrals
          • Id (long)
          • Name (str)
          • Enabled (bool)
          • ScopeId (str)
          • EnrollmentGroupSymmetricKey (str)
          • GlobalEndpoint (str)
          • ModelId (str)
          • AzureSetId (long)
          • HistoryEnabled (bool)
          • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)
          • MessageCapacity (int)(depreacted 4.0.19)
          • HistoryMaxSize (int)(added 4.0.22)
          • HistoryMaxAge (int)(added 4.0.19)
          • FlushPeriod (long)
          • H2dbDirectory (str)(added 4.0.25)
          • H2dbPort (int)(added 4.0.22)
          • MaximumSize (int)
          • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"
        • Event Hubs
          • Id (long)

          • Name (str)

          • Enabled (str)

          • CertAuthEnabled (bool)(added 4.0.26)
          • TenantId (str)(added 4.0.26)
          • AzureServicePrincipalClientId (str)(added 4.0.26)
          • EventHubNamespace (str)(added 4.0.26)
          • EventHubName (str)(added 4.0.26)
          • ClientCertFileId (long)(added 4.0.26)
          • ClientPrivateKeyFileId (long)(added 4.0.26)
          • ClientKeyPassword (str)(added 4.0.26)
          • ConnectionString (str)

          • HistoryEnabled (bool)

          • HistoryStoreType (str) "In_Memory" or "Disk_Backed" (added 4.0.17)

          • MessageCapacity (int)(deprecated 4.0.19)

          • HistoryMaxSize (int)(added 4.0.22)
          • HistoryMaxAge (int)(added 4.0.19)
          • FlushPeriod (long)

          • H2dbDirectory (str)(added 4.0.25)
          • H2dbPort (int)(added 4.0.22)
          • MaxSize (int)

          • ContentEncoding (str) "NONE", "UTF_8", "UTF_16", or "UTF_32"
          • AzureDateTimeFormat (str) "LONG_MS_SINCE_EPOCH" or "STRING_AZURE_COMPAT"

        • Agents
          • Id (long)

          • Name (str) (added 4.0.17)
          • Enabled (bool) (added 4.0.17)
          • TagProvider (str)

          • TagPath (str)

          • PushTrigger (str) "EVENT_DRIVEN", "PERIODIC" or "HYBRID"

          • TagPacingPeriod (long)

          • ConvertUdts (bool)

          • PublishUdtDefinitions (bool)

          • OptimizeUdts (bool)

          • AzureSetId (long)

          • GroupId (str)

          • EdgeNodeId (str)

          • DeviceId (str)

          • FilteredProperties (str)

          • SendAllProps (bool)(added 4.0.25)
          • IncludeInfoFolders (bool)(added 4.0.30)
        • Sets
          • Id (long)

          • Name (str)

          • Description (str)

          • PushPolicy (str) "PUSH_TO_ALL" or "PUSH_TO_ANY"

  • Return Value
    • A map representing the updated configuration after it has been written to the database. (added 4.0.16)

...

  • (type, name, config, enabled, description)
    • enabled (boolean) and description (string) are optional calls
    • returns a dictionary that represents the config.json of the specified resource
  • deleteConfig(type, name)
    • returns a boolean
  • getConfigNames(type, enabled)
    • enabled is an optional call
    • returns a list strings
  • isConfigEnabled(type, name)
    • returns a boolean
  • readConfig(type, name)
    • returns a dictionary that represents the config.json of the specified resource
  • setConfigEnabled(type, name, enabled)
    • returns a boolean 
  • updateConfig(type, name, collisionPolicy, config)
    • returns a dictionary that represents the config.json of the specified resource

where:

  • type
    • string denoting the type of configuration to operate on
  • name
    • string denoting the unique name for the configuration resource to operate on
  • config
    • dictionary of properties making up the configuration resource to operate on
      • general
      • event-hub
      • event-hub-cert-file
      • iot-central
      • iot-edge-hub
      • iot-hub
      • iot-hub-cert-file
      • server-set
      • agent
  • enabled
    • boolean
  • collisionPolicy
    • string with options "MergeOverwrite" or "Overwrite"
      • "MergeOverwrite" will replace the existing properties in the resource name with only those included in the call
      • "Overwrite" will replace all properties in the resource name with those in the call



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.



AWS 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 'general' keys

enabledboolean

Whether or not the configuration resource is enabled

Azure Injector 'event-hub' keys

enabledboolean

Whether or not the configuration resource is enabled

namestring

The unique name for the configuration resource

serverSetstringThe Set this Event 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 Event Hub
tenantIdstringThe Azure Tenant ID
azureServicePrincipalClientIdstringThe Service Principal Client ID associated with the client certificate
eventHubNamespacestringThe Event Hub Namespace associated with the client certificate
eventHubNamestringThe Event Hub Namespace associated with the client certificate
clientCertFilestringClient certificate file currently in use
clientPrivateKeyFilestringClient private key file currently in use
c;lientKeyPasswordstringThe 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
maxSizeintegerMaximum message size before dividing into multiple messages
contentEncodingstringThe content encoding of the data to push to Event Hub
azureDateTimeFormatstringThe date/time format to use when pushing data to Azure
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 reestablishing connection to the endpoint

Azure Injector 'event-hub-cert-files' 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 'iot-central' keys

enabledboolean

Whether or not the configuration resource is enabled

namestring

The unique name for the configuration resource

scopeIdstringThe Azure IoT Central Scope ID
enrollmentGroupSymmetricKeystringThe Azure Enrollment Group Symmetric Key
globalEndPointstringThe global endpoint of the IoT Central connection
provisionedDeviceIdstringThe provisioned Device ID associated with this IoT Central connection
modelIdstringThe Model ID associated with this IoT Central connection
serverSetstringThe Set this IoT Central connection is associated with
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
maxSizeintegerMaximum message size before dividing into multiple messages
expirationlongThe number of seconds before the session token expires
azureDateTimeFormatstringThe date/time format to use when pushing data to Azure
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 reestablishing connection to the endpoint

Azure Injector 'iot-edge-hub' keys

enabledboolean

Whether or not the configuration resource is enabled

namestring

The unique name for the configuration resource

protocolstringThe IoT Edge Hub client protocol
serverSetstringThe Set this IoT Central connection is associated with
automaticbooleanIf true, Azure Edge environment variables will be used as the connection parameters rather than those defined in the Connectivity and Authentication sections of this configuration
mqttServerUrlstringThe MQTT Server URL for the Azure IoT Edge
certAuthEnabledbooleanEnable certificate based authentication instead of using a connection string
connectionStringstringThe Connection String used for establishing a connection with the IoT Edge when using 'Connection String Authentication'. This is either the Connection String associated with the Child Device or with the Azure Edge Module
caCertFilestringCA Certificate file currently in use on the IoT Edge instance. It is used for both Certificate and Connection String based authentication. This is the CA Device Certificate that was uploaded to the Azure Edge instance
clientCertFilestringClient certificate file currently in use
clientPrivateKeyFilestringClient private key file currently in use
clientKeyPasswordstringThe password associated with the certificate's private key (optional)
hostnameVerificationbooleanEnable TLS Hostname Verification. This should be true on production systems
mqttHostnamestringThe hostname of the Azure IoT Hub endpoint
deviceIdstringThe Device ID as provisioned in the Azure IoT Edge configuration
moduleIdOptionstringThe method to use to configure the Module ID. Options are NONE, ENVIRONMENT_VARIABLE, IOTEDGE_MODULEID, or IGNITION_CONFIG
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
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
autoGeneratedbooleanWhether or not the connection details were auto-generated
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 reestablishing connection to the endpoint

...

  • Type (str)
    • The type of configuration to delete with valid options:

      • "Cert Files"
      • "IoT Hubs"
      • "IoT Edges"
      • "IoT Centrals"
      • "Event Hubs"
      • "Agents"
      • "Sets"
  • Id (long)
    • The ID of the record to delete

...

Sample Script


Warning
Cirrus Link provides these scripts as examples only, they are not supported or guaranteed to meet any particular functionality. Cirrus Link cannot provide any assistance to modify these scripts to meet a particular need.

...