Name
uddi_save_binding — save or update a complete bindingTemplate structure
Syntax
<uddi_save_binding
generic="1.0"
xmlns="urn:uddi-org:api" >
<authInfo/>
<bindingTemplate/>
[<bindingTemplate/>...]
</uddi_save_binding>
Description
The uddi_save_binding
message is used to save or update a complete bindingTemplate structure. This
message can be used to add or update one or more bindingTemplate structures to one or
more existing businessService structures.
Attributes & Children
authInfo
This required argument is an element that contains an
authentication token, obtained using the get_authToken call.
bindingTemplate
One or more complete bindingTemplate structures. The order
in which these are processed is not defined. To save a new
bindingTemplate , pass a
bindingTemplate structure
with an empty bindingKey
attribute value.
Behavior
Each bindingTemplate
structure passed must contain a serviceKey value that corresponds to
a registered businessService controlled by the
same identity saving the bindingTemplate data. The effect of
this call is to establish the parent businessService relationship for each
bindingTemplate affected by
this call. If the same bindingTemplate (determined by
matching bindingKey value)
is listed more than once, any relationship to the containing
businessService will be
determined by processing order, which is determined by the position
of the bindingTemplate data
in first-to-last order.
Return Types
This message returns a bindingDetail message that reflects
the newly registered information for the affected bindingTemplate structures.
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.102.Errors signalled by uddi_save_binding
| Error Code | Description |
|---|---|
| E_invalidKeyPassed | signifies that the request cannot be satisfied because one or
more uuid_key values
specified is not a valid key value, or that a hostingRedirector value references a
bindingTemplate that itself
contains a hostingRedirector value. |
| E_authTokenExpired | signifies that the authentication token value passed in the
authInfo argument is no
longer valid because the token has expired. |
| E_authTokenRequired | signifies that the authentication token value passed in the
authInfo argument is either
missing or is not valid. |
| E_userMismatch | signifies that one or more of the uuid_key values passed refers to data
that is not controlled by the entity represented by the
authentication token. |
| E_operatorMismatch | signifies that one or more of the uuid_key values passed refers to data
that is not controlled by the server that received the request for
processing. |
| E_keyRetired | signifies that the request cannot be satisfied because one or
more uuid_key values
specified has previously been hidden or removed by the requester.
This specifically applies to the tModelKey values passed. |
| E_invalidURLPassed | an error occurred with one of the uploadRegister URL values. |
| E_accountLimitExceeded | signifies that user account limits have been exceeded. |