检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取账号名和账号ID 在调用接口的时候,部分请求中需要填入账号名(domain name)和账号ID(domain_id)。获取步骤如下: 注册并登录管理控制台。 鼠标移动至用户名,在下拉列表中单击“我的凭证”。 在“API凭证”页面的查看“账号名”和“账号ID”。 图1 查看账号ID
Explorer中修改接口参数,即可自动生成对应的代码示例。同时,可在集成开发环境CloudIDE中完成代码的构建、调试、运行等操作。 表1提供了各个云服务支持的SDK列表,您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档,参照进行进阶配置。 表1 SDK列表 编程语言
因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求,不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求,不要重试该请求。 406 Not
新建系统变量GOROOT,变量值为实际go安装位置。新增环境变量GOPATH,变量为go语言工程所在目录。 修改PATH变量,末尾增加GO的编译器路径“;%GOROOT%\bin",中间分隔符是【;】。 修改CLASSPATH变量,末尾增加GO的编译器路径“;%GOROOT%\lib",中间分隔符是【;】。
调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上,在下拉列表中选择“我的凭证”。 在“我的凭证”页面,可以查看用户名、账号名,在项目列表中查看项目。 图1 查看项目ID 多项目时,展开“所属区域”,从“项目ID”列获取子项目ID。 调用API获取项目ID
search_type 是 String 搜索类型,必须为服务实例支持的搜索类型,服务实例的搜索类型列表可在创建服务实例时进行配置。 说明: 可以使用枚举名或者枚举值(例如IMAGE/0),枚举值可能会变动,建议使用枚举名。 枚举值: IMAGE KEYWORD TEXT CATEGORY limit
name并单击“Save”。 请求方式修改为"POST",输入URL。 例如,以cn-north-4为例,URL为“https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens”。 在“Headers”列表中添加“KEY”为“Conten
Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。
计费说明 计费项 图像搜索服务的计费项包含索引存储数量和搜索查询次数。 表1 计费项说明 计费项 计费项说明 索引存储V2 通过添加数据V2、删除数据V2接口对实例中的索引存储数量进行管理。 搜索查询V2 搜索查询API的调用次数。 由于存在资源占用,单个服务实例的存储数量存在计
请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。
用户创建服务实例用于搜索什么类型的数据。 例如:IMAGE,表示用户需要搜索的为图像数据。 服务模板 服务模板,指用户搜索数据的基础业务流程,即用户需要在业务中按照什么流程进行数据搜索。 例如:IMAGE->商品搜索,表示用户需要按照商品搜索的流程进行图像数据的搜索。 服务类型
附录 状态码 错误码 获取项目ID和名称 获取账号名和账号ID
{query-string} 尽管请求URI包含在请求消息头中,但大多数语言或框架都要求您从请求消息中单独传递它,所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器
"error_msg":"Request api error! The API is not subscribed." } 表示您还未订阅该区域下的图像搜索服务,请您开通后再使用该服务。 出现其它错误码及错误信息说明请参考表-错误码说明,在调用方找不到错误原因时,可以联系华为云客服,并提供错误码,以便尽快帮您解决问题。
s.4603", "error_msg":"Obtaining the file from the URL failed." } 表示从URL获取图片数据失败。可通过以下几个方面进行排查: 请确保提供的URL支持HTTP/HTTPS请求协议,即格式为http/https url。
终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 图像搜索的终端节点 区域名称 区域 终端节点(Endpoint) 华北-北京四 cn-north-4 imagesearch
准备环境 在使用图像搜索SDK时,各语言需要准备的环境,参考表1。 表1 开发环境 开发语言 准备项 说明 JAVA 安装JDK JAVA环境开发配置,支持 Java JDK 1.8 及其以上版本,推荐通过Maven 安装依赖的方式使用JAVA版本SDK。 PYTHON 安装python
获取认证信息 使用服务API需要进行认证,推荐用户使用AK/SK方式。步骤如下: 登录华为云管理控制台。 鼠标移动至用户名处,在下拉列表中单击“我的凭证”。 选择“访问密钥”页签,单击“新增访问秘钥”按钮。 通过邮箱或者手机进行验证,输入对应的验证码。 单击“确定”,下载认证账号
0001", "error_msg": "Request is unauthorized." } 其中,error_code表示错误码,error_msg表示错误描述信息。 错误码说明 由于MMS服务部署依赖华为云相关平台能力,因此MMS服务错误码会出现“MMS”、“ModelA
必须为服务实例custom_tags中已存在的key,可在创建服务实例时进行配置,或在更新服务实例时进行新增。 value: 标签值列表,列表内多个标签值为“或”关系,即满足一个即可。列表长度范围为[1, 32],标签值类型为字符串,字符长度范围为[1, 64]。 custom_num_tags 否 Map<String