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.

Table 8– RegisterServer2

Name

Type

Description

Request

requestHeader

RequestHeader

Common request parameters.

The authenticationTokenis always null.

The type RequestHeaderis defined in 7.28.

Server

RegisteredServer

The Serverto register. The type RegisteredServeris defined in 7.27.

discoveryConfiguration []

ExtensibleParameter DiscoveryConfiguration

Additional configuration settings for the Serverto register.

The discoveryConfigurationis an extensible parameter type defined in 7.9.

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.29.

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 177.

Table 9– RegisterServer2 Service Result Codes

Symbolic Id

Description

Bad_InvalidArgument

See Table 177for the description of this result code.

Bad_ServerUriInvalid

See Table 177for 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 177for the description of this result code.

Table 10defines values for the operation level statusCodeparameters that are specific to this Service. Common StatusCodesare defined in Table 178.

Table 10– RegisterServer2 Operation Level Result Codes

Symbolic Id

Description

Bad_NotSupported

See Table 178for the description of this result code.