« Back to Product

Documentation

Send feedback!

IPS_GetInstance

 array IPS_GetInstance (int $InstanceID)

Parameters

InstanceID

InstanceID to be returned

Returns

The following information is available as key => value pairs:

Index Type Description
InstanceID integer InstanceID
ConnectionID integer ID of the connected instance
InstanceStatus integer Status code of the instance
InstanceSupportsSearching boolean Does the instance support the search mode
InstanceIsSearching boolean Instance is in search mode
InstanceChanged integer Unix Timestamp of the last application of configuration
ModuleInfo array Module Information

Status of Instance

Code Status
101 Instance will be created
102 Instance is activ
103 Instance will be deleted
104 Instance is inactiv
105 Instance was not created
106 Instance is in standby
>=200 Instance is marked als faulty

Module Information

Index Type Description
ModuleID string ModuleID of Instance
ModuleName string ModuleName of Instance
ModuleType integer ModuleType of Instance (0: Core, 1: I/O, 2: Splitter, 3: Device, 4: Configurator, 5: Discovery, 6: Visualization)

Description

The function returns an array containing information about the instance with the ID InstanceID. If the instance does not exist, an alert is generated.

Example

print_r(IPS_GetInstance(19668));

/* returns e.g.:
Array
(
    [InstanceID] => 19668
    [InstanceStatus] => 102
    [LastChange] => 0
    [ModuleInfo] => Array
    (
        [ModuleID] => {48FCFDC1-11A5-4309-BB0B-A0DB8042A969}
        [ModuleName] => FS20
        [ModuleType] => 3
    )
    [ConnectionID] => 29416
)
*/
Any questions?