This Service returns the Servers known to a Discovery Server. Unlike FindServers, this Service is only implemented by Discovery Servers.
The Client may reduce the number of results returned by specifying filter criteria. An empty list is returned if no Server matches the criteria specified by the Client.
This Service shall not require message security but it may require transport layer security.
Each time the Discovery Server creates or updates a record in its cache it shall assign a monotonically increasing identifier to the record. This allows Clients to request records in batches by specifying the identifier for the last record received in the last call to FindServersOnNetwork. To support this the Discovery Server shall return records in numerical order starting from the lowest record identifier. The Discovery Server shall also return the last time the counter was reset for example due to a restart of the Discovery Server. If a Client detects that this time is more recent than the last time the Client called the Service it shall call the Service again with a startingRecordId of 0.
This Service can be used without security and it is therefore vulnerable to denial of service (DOS) attacks. A Server should minimize the amount of processing required to send the response for this Service. This can be achieved by preparing the result in advance.
Table 4 defines the parameters for the Service.
Table 4 – FindServersOnNetwork Service Parameters
|
Name |
Type |
Description |
|
Request |
|
|
|
requestHeader |
RequestHeader |
Common request parameters. The authenticationToken is always null. The authenticationToken shall be ignored if it is provided. The type RequestHeader is defined in 7.33. |
|
startingRecordId |
Counter |
Only records with an identifier greater than this number will be returned. Specify 0 to start with the first record in the cache. |
|
maxRecordsToReturn |
UInt32 |
The maximum number of records to return in the response. 0 indicates that there is no limit. |
|
serverCapabilityFilter[] |
String |
List of Server capability filters. The set of allowed Server capabilities are defined in OPC 10000-12. Only records with all of the specified Server capabilities are returned. The comparison is case insensitive. If this list is empty then no filtering is performed. |
|
|
|
|
|
Response |
|
|
|
responseHeader |
ResponseHeader |
Common response parameters. The ResponseHeader type is defined in 7.34. |
|
lastCounterResetTime |
UtcTime |
The last time the counters were reset. |
|
servers[] |
ServerOnNetwork |
List of DNS service records that meet criteria specified in the request. This list is empty if no Servers meet the criteria. |
|
recordId |
UInt32 |
A unique identifier for the record. This can be used to fetch the next batch of Servers in a subsequent call to FindServersOnNetwork. |
|
serverName |
String |
The name of the Server specified in the mDNS announcement (see OPC 10000-12). This may be the same as the ApplicationName for the Server. |
|
discoveryUrl |
String |
The URL of the DiscoveryEndpoint. |
|
serverCapabilities |
String[] |
The set of Server capabilities supported by the Server. The set of allowed Server capabilities are defined in OPC 10000-12. |
Common StatusCodes are defined in Table 182.