This Service is implemented by Discovery Servers.
This Serviceallows a Serverto register its DiscoveryUrlsand capabilities with a Discovery Server. It extends the registration information from RegisterServerwith information necessary for FindServersOnNetwork. This Servicewill be called by a Serveror a separate configuration utility. Clientswill not use this Service.
Serversthat support RegisterServer2shall try to register with the Discovery Serverusing this Service and shall fall back to RegisterServerif RegisterServer2fails with the status Bad_ServiceUnsupported.
A Discovery Serverthat implements this Serviceneeds to assign unique record ids each time this Serviceis called. See 5.4.3for more details.
This Servicecan only be invoked via SecureChannelsthat support Clientauthentication (i.e. HTTPS cannot be used to call this Service).
Table 8defines the parameters for the Service.
|
Name |
Type |
Description |
|
Request |
|
|
|
requestHeader |
RequestHeader |
Common request parameters. The authenticationTokenis always null. The type RequestHeaderis defined in 7.33. |
|
Server |
RegisteredServer |
The Serverto register. The type RegisteredServeris defined in 7.32. |
|
discoveryConfiguration [] |
ExtensibleParameter DiscoveryConfiguration |
Additional configuration settings for the Serverto register. The discoveryConfigurationis an extensible parameter type defined in 7.13. Discovery Serversthat do not understand a configuration shall return Bad_NotSupported for this configuration. |
|
|
|
|
|
Response |
|
|
|
responseHeader |
ResponseHeader |
Common response parameters. The type ResponseHeaderis defined in 7.34. |
|
configurationResults [] |
StatusCode |
List of results for the discoveryConfigurationparameters. |
|
diagnosticInfos [] |
DiagnosticInfo |
List of diagnostic information for the discoveryConfigurationparameters. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request. |
Table 9defines the Serviceresults specific to this Service. Common StatusCodesare defined in Table 182.
Table 9– RegisterServer2 Service Result Codes
|
Symbolic Id |
Description |
|
Bad_InvalidArgument |
See Table 182for the description of this result code. |
|
Bad_ServerUriInvalid |
See Table 182for the description of this result code. |
|
Bad_ServerNameMissing |
No ServerNamewas specified. |
|
Bad_DiscoveryUrlMissing |
No discovery URL was specified. |
|
Bad_SemaphoreFileMissing |
The semaphore file specified is not valid. |
|
Bad_ServiceUnsupported |
See Table 182for the description of this result code. |
Table 10defines values for the operation level configurationResults parameters that are specific to this Service. Common StatusCodesare defined in Table 183.
Table 10– RegisterServer2 Operation Level Result Codes
|
Symbolic Id |
Description |
|
Bad_NotSupported |
See Table 183for the description of this result code. |