The save_binding API call is used to save or update a complete bindingTemplate element. This message can be used to add or update one or more bindingTemplate elements as well as the container/contained relationship that each bindingTemplate has with one or more existing businessService elements.
This API returns a bindingDetail message containing the final results of the call that reflects the newly registered information for the effected bindingTemplate elements. If more than one bindingTemplate is saved in a single save_binding message, the resulting bindingDetail message will return results in the same order that they appeared in the save_binding message. If the same bindingTemplate (determined by matching bindingKey) is listed more than once in the save_binding message, it may be listed once in the result for each appearance in the save_binding message. If so, the last appearance in the results represents the final saved state.
<save_binding generic = "2.0" xmlns = "urn:uddi-org:api_v2" > <authInfo/> <bindingTemplate/> [<bindingTemplate/>.] </save_binding>
authInfo − This required argument is an element that contains an authentication token. Authentication tokens are obtained using the get_authToken API call.
bindingTemplate − One or more complete bindingTemplate elements. To save a new bindingTemplate, pass a bindingTemplate element with an empty bindingKey attribute value. Any bindingTemplate data saved in this way must provide a serviceKey value that references a businessService that is controlled by the same publisher.
If any error occurs in processing this API call, a dispositionReport element will be returned to the caller within a SOAP Fault. The following error number information will be relevant:
E_authTokenExpired − It signifies that the authentication token value passed in the authInfo argument is no longer valid because the token has expired.
E_authTokenRequired − It signifies that the authentication token value passed in the authInfo argument is either missing or is not valid.
E_invalidKeyPassed − It 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_userMismatch − It signifies that one or more of the uuid_key values passed refers to data that is not controlled by the individual who is represented by the authentication token. The key causing the error will be clearly indicated in the error text.
E_accountLimitExceeded − It signifies that user account limits have been exceeded.