View Source

Basic Operations

The following basic operations are available for the Google Cloud Injector Module and can be executed within any of the available Ignition scopes using the format system.cirruslink.google.operation

createConfig(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
  - iot-core
  - 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

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.

Google Cloud Injector 'type' keys

general
iot-core
server-set
agent

Google Cloud Injector 'general' keys

enabled

boolean

Whether or not the configuration resource is enabled

Google Cloud Injector 'iot-core' keys

enabled	boolean	Whether or not the configuration resource is enabled
name	string	The unique name for the configuration resource
mqttEndpointUrl	string	The MQTT Server Endpoint
projectId	string	The GCP project under which this device is provisioned
cloudRegion	string	The GCP cloud region under which this device is provisioned
registryId	string	The GCP registry ID under which this device is provisioned
deviceId	string	The GCP ID of this device
privateKeyFileContents	string	The file contents of the private key
algorithm	string	The algorithm type used by the key file
serverSet	string	The Set this Event Hub connection is associated with
proxyType	string	The Proxy Type if a proxy server is being used
proxyHostname	string	The Proxy hostname if a proxy server is being used
proxyPort	integer	The Proxy port number if a proxy server is being used
keepAlive	integer	The MQTT Client keep alive time (in seconds)
historyEnabled	boolean	Enable Store and Forward capabilities for this stream
historyStoreType	string	The Type of this Store & Forward mechanism
partionPeriod	string	The partitioning scheme to use for the Disk-backed history store (e.g. HOUR, MINUTE, DAY, etc)
historyMaxSize	integer	Maximum number of megabytes history can use before dropping the data
trimmerTaskPeriodMultiplier	integer	A integer multiplier which is applied to the 'storageMonitorPeriod' which results in the period in which to trim potential excess history
historyMaxAge	integer	Maximum number of minutes to store history before dropping the data
queryTimeout	integer	The H2 DB query timeout in seconds for the disk-backed history store
maxSize	integer	Maximum message size before dividing into multiple messages
maxThroughput	long	Maximum throughput per second in bytes. The module will throttle messages to prevent exceeding this max limit
expiration	integer	The number of minutes before the session token expires
tokenAutoRefreshEnabled	boolean	Session Token Auto-refresh
h2dbDirectory	string	Directory to store the H2 Database in. Applicable for Disk-backed history store only
h2dbPort	integer	TCP Port to connect to H2 Database. Applicable for Disk-backed history store only
dbMaxMessageSize	integer	The Max Message size allowed in the Store and Forward DB. This only applies to Disk-Backed history stores
republishBirths	boolean	Whether or not to republish BIRTH messages on reestablishing connection to the endpoint

Google Cloud Injector 'server-set' keys

enabled	boolean	Whether or not the configuration resource is enabled
name	string	The unique name for the configuration resource
description	string	Description of this Set
pushPolicy	string	The 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

Google Cloud Injector 'agent' keys

enabled	boolean	Whether or not the configuration resource is enabled
name	string	The unique name for the configuration resource
tagProvider	string	The Name of the tag provider
tagPath	string	A path to the root folder where the tag tree starts (optional)
pushTrigger	string	The trigger to use when pushing data - EVENT_DRIVEN, PERIODIC or HYBRID
tagPacingPeriod	long	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
convertUdts	boolean	Converts UDT members to normal Tags
sendAllProps	boolean	Send all properties, including non-default properties, in Sparkplug BIRTH messages
includeQualityContext	boolean	Include the metric 'quality context' string in addition to the quality codes for metrics
includeInfoFolders	boolean	Push all Node and Device Info and Control folder information (from MQTT Engine) rather than excluding it
publishUdtDefinitions	boolean	Publish UDT Definitions in BIRTH
optimizeUdts	boolean	Optimizes UDT payload sizes in NDATA and DDATA payloads
serverSet	string	The Set this Agent is associated with
groupId	string	An ID representing a logical grouping of Edge Nodes and Devices (optional)
edgeNodeId	string	An ID representing an Edge or Network (EoN) Node (optional)
deviceId	string	An ID representing a Device (optional)
filteredProperties	string	A semicolon delimited list of Tag properties to filter/block from being published
birthSettleDelay	long	The amount of time to wait after setting the BIRTH timestamp before fetching the cached BIRTH payloads