UDDI API - 保存业务

描述

save_business API 调用用于保存或更新有关完整 businessEntity 元素的信息。

此 API 返回一个 businessDetail 消息，其中包含调用最终结果，反映了所提供 businessEntity 信息的新注册信息。这些结果将包括通过引用包含的任何 businessServices。如果通过匹配键确定的相同实体在 save_business 消息中列出多次，则它可能会在结果中为 save_business 消息中的每次出现列出一次。如果是这样，结果中的最后一次出现表示最终保存的状态。

版本 2.0 语法

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

参数

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

businessEntity − 可以传递一个或多个完整的 businessEntity 元素。这些元素可以通过使用 get_businessDetail API 调用或通过任何其他方式预先获得。

返回错误

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

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

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

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

E_invalidProjection − 表示尝试保存包含与正在投影的 businessService 不匹配的服务投影的 businessEntity。至少一个此类 businessService 的 serviceKey 将包含在 dispositionReport 中。

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

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

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

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

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