UDDI API - save_binding

描述

save_binding API 调用用于保存或更新完整的 bindingTemplate 元素。此消息可用于添加或更新一个或多个 bindingTemplate 元素，以及每个 bindingTemplate 与一个或多个现有 businessService 元素之间包含/被包含的关系。

此 API 返回包含调用最终结果的 bindingDetail 消息，该结果反映了受影响的 bindingTemplate 元素的新注册信息。如果在一个 save_binding 消息中保存了多个 bindingTemplate，则生成的 bindingDetail 消息将按它们在 save_binding 消息中出现的顺序返回结果。如果在 save_binding 消息中多次列出了相同的 bindingTemplate（通过匹配 bindingKey 确定），则结果中可能会为 save_binding 消息中的每个出现列出一次。如果是这样，结果中的最后一次出现表示最终保存的状态。

版本 2.0 语法

<save_binding generic = "2.0" 
   xmlns = "urn:uddi-org:api_v2" >
   <authInfo/>
   <bindingTemplate/> [<bindingTemplate/>.]
</save_binding>

参数

authInfo − 此必填参数是一个包含身份验证令牌的元素。身份验证令牌是使用 get_authToken API 调用获得的。

bindingTemplate − 一个或多个完整的 bindingTemplate 元素。要保存新的 bindingTemplate，请传递一个具有空 bindingKey 属性值的 bindingTemplate 元素。以这种方式保存的任何 bindingTemplate 数据必须提供一个 serviceKey 值，该值引用由同一发布者控制的 businessService。

返回错误

如果在处理此 API 调用时发生任何错误，则将在 SOAP 错误中向调用方返回 dispositionReport 元素。以下错误编号信息将相关

E_authTokenExpired − 表示在 authInfo 参数中传递的身份验证令牌值不再有效，因为令牌已过期。

E_authTokenRequired − 表示在 authInfo 参数中传递的身份验证令牌值丢失或无效。

E_invalidKeyPassed − 表示无法满足请求，因为指定的一个或多个 uuid_key 值不是有效的键值，或者 hostingRedirector 值引用一个自身包含 hostingRedirector 值的 bindingTemplate。

E_userMismatch − 表示传递的一个或多个 uuid_key 值引用了不由身份验证令牌所代表的个人控制的数据。导致错误的键将在错误文本中明确指出。

E_accountLimitExceeded − 表示用户帐户限制已超出。