UDDI API - 保存服务

描述

save_service API 调用添加或更新一个或多个 businessService 元素。

此 API 调用返回一个 serviceDetail 消息，其中包含该调用的最终结果，反映了受影响的 businessService 元素的最新注册信息。如果请求中传递了多个 businessService 元素，则结果将包含每个传递的 businessService 的最终结果，这些结果将按照请求中的顺序出现。如果在 save_service 消息中多次列出了相同的实体，则结果中可能会为 save_service 消息中的每次出现列出一次该实体。如果是这样，结果中的最后一次出现代表最终保存的状态。

2.0 版语法

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

参数

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

businessService − 可以传递一个或多个完整的 businessService 元素。为了执行往返更新，可以使用 get_serviceDetail API 调用或任何其他方法预先获取此数据。

返回的错误

如果在此 API 调用的处理过程中发生任何错误，则会在 SOAP 故障中向调用方返回一个 dispositionReport 元素。以下错误编号信息将是相关的

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

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

E_invalidKeyPassed − 表示由于指定的一个或多个 uuid_key 值不是有效的键值，因此无法满足请求。这包括任何 tModelKey 引用，以及对不存在的服务密钥或绑定密钥值的引用。

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

E_invalidValue − keyValue 属性中传递的值未通过验证。这适用于已检查的分类、标识符和其他已验证的代码列表。错误文本将清楚地指出未通过验证的键值组合。

E_requestTimeout − 表示由于所需的 validate_values 服务未在合理的时间内响应，因此无法执行请求。标识失败服务的详细信息将包含在 dispositionReport 元素中。

E_valueNotAllowed − 分类法提供者已对特定分类法中该位置应包含的信息类型施加了限制。运营商站点选择的 validate_values 服务已拒绝此 businessEntity 至少一个指定的类别。

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