检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
搜索查询 V2 功能介绍 从指定服务实例中进行搜索。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
对于获取用户Token接口,返回如图1所示的消息头,其中“x-subject-token”就是需要获取的用户Token。有了Token之后,您就可以使用Token认证调用其他API。
有哪些途径可以使用图像搜索的API? 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。
调用SDK实现功能 图像搜索服务软件开发工具包(ImageSearch SDK)是对图像搜索服务提供的REST API进行的封装,以简化用户的开发工作。 本章节以搜索数据接口为例,介绍如何使用ImageSearch Java SDK在本地开发,用户调用接口函数即可使用SDK功能。
resource-path 资源路径,也即API访问路径。 从具体API的URI模块获取,例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数,是可选部分,并不是每个API都有查询参数。
调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
Token可通过调用获取用户Token接口获取,调用本服务API需要project级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
API 说明 添加数据 V2 添加数据到指定服务实例中,只有已添加到服务实例中的数据才能被搜索到。 搜索查询 V2 从指定服务实例中进行搜索。 检查数据 V2 检查指定服务实例中的对应数据是否存在,如存在则返回其主要信息。 更新数据 V2 更新指定服务实例中的对应数据。
API 添加数据 V2 搜索查询 V2 检查数据 V2 更新数据 V2 删除数据 V2
SDK代码示例自动生成 API Explorer提供API检索及平台调试,支持全量快速检索、可视化调试、帮助文档查看、在线咨询。 您只需要在API Explorer中修改接口参数,即可自动生成对应的代码示例。
公测 / 2018年9月 序号 功能名称 功能描述 阶段 相关文档 1 新增实例交叉查询API接口 给定源实例中多个图片路径,到目标实例中搜索相同或相似图片。仅图库模型支持该接口。
访问的API不存在或尚未在环境中发布 请检查API的URL是否拼写正确,例如,URL中是否缺少project_id。 检查URI中的区域信息是否和调用服务配置的终端节点是否对应。 请检查HTTP请求方法(POST,GET等)是否正确。 请查看具体的URI信息是否正确。
表1 接口与API对应关系 接口 API 添加数据 POST /v2/{project_id}/mms/{service_name}/data/add 搜索数据 POST /v2/{project_id}/mms/{service_name}/search 查询数据 POST /v2
在“我的凭证”页面,可以查看用户名、账号名,在项目列表中查看项目。 图1 查看项目ID 多项目时,展开“所属区域”,从“项目ID”列获取子项目ID。 调用API获取项目ID 项目ID通过调用查询指定条件下的项目信息API获取。
调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
获取账号名和账号ID 在调用接口的时候,部分请求中需要填入账号名(domain name)和账号ID(domain_id)。获取步骤如下: 注册并登录管理控制台。 鼠标移动至用户名,在下拉列表中单击“我的凭证”。 在“API凭证”页面的查看“账号名”和“账号ID”。
调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
计费说明 计费项 图像搜索服务的计费项包含索引存储数量和搜索查询次数。 表1 计费项说明 计费项 计费项说明 索引存储V2 通过添加数据V2、删除数据V2接口对实例中的索引存储数量进行管理。 搜索查询V2 搜索查询API的调用次数。
调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。