Name
uddi_get_bindingDetail — Request run-time bindingTemplate
location
information.
Syntax
<uddi_get_bindingDetail generic="1.0" xmlns="urn:uddi-org:api" > <bindingKey/> [ <bindingKey/> ...] </uddi_get_bindingDetail>
Description
The uddi_get_bindingDetail
message
requests the run-time bindingTemplate
information for the
purpose of invoking a registered business API.
Attributes & Children
bindingKey
One or more uuid
_key
values that represent specific instances of known bindingTemplate
data.
Behavior
In general, it is recommended that bindingTemplate
information be cached
locally by applications so that repeated calls to a service
described by a bindingTemplate
can be made without
having to make repeated round trips to a registry. In the event
that a call made with cached data fails, the uddi
_get_bindingDetail message can
be used to get fresh bindingTemplate
data. This is useful
in cases such as when a service you are using relocates to another
server or is restored at a disaster recovery site.
Return Types
This function returns a bindingDetail
message on successful
match of one or more bindingKey
values. If multiple
bindingKey
values were
passed, the results will be returned in the same order as the keys
passed.
In the event of a large number of matches, a server may truncate
the result set. If this occurs, the bindingDetail
result will contain the
truncated
attribute with
the value of this attribute set to true.
Errors
If an error occurs in processing this message, a dispositionReport
structure will be
returned to the caller in a SOAP Fault. The following error
information will be relevant:
Table24.96.Errors signalled by uddi_get_bindingDetail
Error Code | Description |
---|---|
E_invalidKeyPassed | signifies that one of the uuid_key values passed did not match
with any known bindingKey
key values. No partial results will be returned; if any bindingKey values passed are not
valid bindingKey values,
this error will be returned. |