检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
搜索查询 V2 功能介绍 从指定服务实例中进行搜索。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
endpoint、projectId以实际申请的服务所在区域为准。 API 说明 添加数据 V2 添加数据到指定服务实例中,只有已添加到服务实例中的数据才能被搜索到。 搜索查询 V2 从指定服务实例中进行搜索。
响应示例如下,例如图像搜索服务部署的区域为"cn-north-4",响应消息体中查找“name”为"cn-north-4",其中projects下的“id”即为项目ID。
303 See Other 查看其它地址。 使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改,服务器返回此状态码时,不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。
query-string 查询参数,是可选部分,并不是每个API都有查询参数。查询参数前面需要带一个“?”,形式为“参数名=参数取值”,例如“limit=10”,表示查询不超过10条数据。
检查URI中的区域信息是否和调用服务配置的终端节点是否对应。 请检查HTTP请求方法(POST,GET等)是否正确。 请查看具体的URI信息是否正确。 APIG.0201 Backend timeout.
图1 获取用户Token响应消息头 响应消息体 响应消息体通常以结构化格式返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。 对于获取用户Token接口,返回如下消息体。为篇幅起见,这里只展示部分内容。
调用服务时错误码显示“ModelArts.4204”怎么处理? 调用接口出错后,返回的消息体中具体的错误代码及错误信息为: { "error_code":"ModelArts.4204", "error_msg":"Request api error!
登录我的凭证,查询属于“华北-北京四”的项目ID,替换URI中的{project_id}。 使用已创建的通用图像搜索服务实例名称“imagesearch_test”,替换URI中的{service_name}。 单击“Body”配置项,按照如下图中所示内容填写参数。
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。
API 添加数据 V2 搜索查询 V2 检查数据 V2 更新数据 V2 删除数据 V2
表1提供了各个云服务支持的SDK列表,您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档,参照进行进阶配置。
计费说明 计费项 图像搜索服务的计费项包含索引存储数量和搜索查询次数。 表1 计费项说明 计费项 计费项说明 索引存储V2 通过添加数据V2、删除数据V2接口对实例中的索引存储数量进行管理。 搜索查询V2 搜索查询API的调用次数。
在“API凭证”页面的查看“账号名”和“账号ID”。 图1 查看账号ID 父主题: 附录
2021年12月 序号 功能名称 功能描述 阶段 相关文档 1 新版SDK文档上线 新版SDK可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档,参照进行进阶配置。同时增加了更多开发代码的示例。
表1 接口与API对应关系 接口 API 添加数据 POST /v2/{project_id}/mms/{service_name}/data/add 搜索数据 POST /v2/{project_id}/mms/{service_name}/search 查询数据 POST /v2
获取Token,请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。
共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。
用户 由账号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。 在我的凭证下,您可以查看账号ID和用户ID。通常在调用API的鉴权过程中,您需要用到账号、用户和密码等信息。
建议:不要使用跨区域的OBS路径,如果OBS与调用服务部署区域不属于同一个区域,建议本地下载图片后使用image_base64的调用方式。 父主题: 错误码问题