实例查网时

图像搜索用户指南1.
2.
3.
用户指南控制台介绍概览页地域信息:点击可切换不同地域.
左侧导航栏:点击可选择概览信息或者不同的服务类型.
资源内容区:显示了用户不同服务类型下的实例概览.
实例列表页图像搜索用户指南11.
2.
3.
----qq4.
5.
6.
1.
2.
3.
4.
地域信息:点击可切换不同地域.
左侧导航栏:点击可选择概览信息或者不同的服务类型.
实例列表区实例ID:实例唯一ID,同一地域不重复,点击可进入实例详情页.
实例名称:实例唯一名称,由英文字母和数字组成,同一地域不重复.
实例状态:当前实例状态,主要有:新建、初始化中、初始化失败、正常运行、清空中、清空失败、已欠费、已停用等,不同的状态会对应不同的操作.
操作按钮区管理:点击后进入实例详情页.
更多:点击后会根据当前实例状态展示相应的操作.
创建实例:点击后会跳转到实例购买页面刷新:点击后会刷新当前实例列表实例搜索区:在输入框输入实例名称,点击"搜索"按钮可进行模糊搜索实例详情页实例的基本信息.
实例增量状态信息:点击后可以看到实例增量操作的历史记录.
实例全量状态信息:点击后可以看到实例全量操作的历史记录.
当前实例对应的相关操作.
图像搜索用户指南2数据管理清空数据数据清空操作:将存储的图片特征信息清空,但是并不会释放机器资源.
该操作在控制台完成.
具体操作示例如下:实例列表页操作在实例列表页找到相应的实例,单击更多>清空.
实例详情页操作在实例详情页的右上角单击清空按钮.
图像搜索用户指南3搜索方法目前搜索服务提供三种搜索方式,通过API调用、SDK调用和控制台进行搜索测试,推荐使用SDK调用方式.
API调用通过Http或Https协议直接访问,需要按照给定的签名机制进行身份验证,发送请求的RequestBody需要按照给定的格式进行传输,详情见API参考.
SDK调用目前提供JAVA版本的SDK,您不需要再关注签名验证以及RequestBody格式拼装等繁琐的事情,推荐使用该种方式,详情见SDK参考.
控制台搜索测试当图片数据新增到实例中以后,这时用户可以进入到测试服务页面,进行搜索测试.

用户填入类目、开始序号和显示条数等参数后(参考查询API),选择需要搜索的图片,然后点击开始测试,在右边会显示出搜索的结果数据.
访问控制RAM图像搜索用户指南4--qqqRAM中可授权的资源类型RAM中可授权的资源目前图像搜索产品支持且仅支持instance一种资源类型,通过RAM授权时资源描述方式如下:资源类型:instance授权策略中的资源描述方式:acs:imagesearch:$regionid:$accountid:instance/$instance$regionid应为某个region的ID,或者(*).
$accountid是您云账号主账号的数字ID,可以用(*)代替.
$instance应为某个具体实例name,比如demo123,或者(*).
不同资源对应的Actions权限资源Actionsinstance/*ClearInstance,DescribeInstance,IncreaseInstance,InitInstance,RemoveInstance,ListInstance,SearchItem,DeleteItem,AddItem,ListIncrementinstance/$instanceClearInstance,DescribeInstance,IncreaseInstance,InitInstance,RemoveInstance,SearchItem,DeleteItem,AddItem,ListIncrementActions权限名称权限描述ClearInstance清空实例.
DescribeInstance查看实例详情.
IncreaseInstance触发实例增量.
InitInstance初始化实例.
RemoveInstance删除实例.
ListInstance查看实例列表.
SearchItem搜索商品/图片.
DeleteItem删除商品/图片.
AddItem添加商品/图片.
ListIncrement查看实例增量.
图像搜索用户指南5----1.
RAM支持区域授权访问鉴权规则使用通用权限策略我们有为常见访问需求的用户提供以下2种通用权限策略,可从以下2种通用权限中,选择适合自己的权限.
可直接从"可选授权策略名称"中搜以下括号中策略名进行选择.
只读访问Imagesearch的权限,可用于只读用户(AliyunImagesearchReadOnlyAccess).
管理Imagesearch的权限,可用于管理员(AliyunImagesearchFullAccess).
【提示】若以上2种通用权限策略无法满足您的需求,可参考下面的描述自定义符合您需求的权限策略.

RAM授权样例参考Resource中的变量含义(例如:$regionid,$accountid,$instance等).
Resource中的实例也可以使用通配符(*)来表示.
授权样例参考(1)给accountid为1234的主账号下的某个子账号,赋予华东2区所有实例在控制台中拥有(除了清空、删除)之外的所有操作权限,同时限制只能指定的IP才能访问.
该策略在主账号控制台中创建后,需再通过主账号在RAM控制台中对子账号授权,或通过RAMSDK对子账号授权.
创建一个策略.
地域RegionId华东2(上海)cn-shanghai亚太东南1(新加坡)ap-southeast-1中国香港cn-hongkong亚太东北1(东京)ap-northeast-1欧洲中部1(法兰克福)eu-central-1{"Statement":[图像搜索用户指南62.
1.
2.
把当前策略授权给您指定的子账号.
授权样例参考(2)给accountid为1234的主账号下的某个子账号,赋予所有图像搜索服务支持区域,所有实例在控制台及API中拥有所有操作权限.
该策略在主账号控制台中创建后,需再通过主账号在RAM控制台中对子账号授权,或通过RAMSDK对子账号授权.
创建一个策略.
把当前策略授权给您指定的子账号.
授权样例参考(3)给accountId为1234的主账号下的某个子账号,赋予所有图像搜索支持区域,指定实例拥有某一实例(本例实例名称为instance12138)的所有操作权限.
该策略在主账号控制台中创建后,需再通过主账号在RAM控制台中对子账号授权,或通过RAMSDK对子账号授权.
{"Action":["imagesearch:ListInstance","imagesearch:DescribeInstance","imagesearch:IncreaseInstance","imagesearch:InitInstance","imagesearch:ListIncrement"],"Condition":{"IpAddress":{"acs:SourceIp":"xxx.
xx.
xxx.
x/xx"}},"Effect":"Allow","Resource":"acs:imagesearch:cn-shanghai:1234:instance/*"}],"Version":"1"}{"Statement":[{"Action":["imagesearch:*"],"Effect":"Allow","Resource":"acs:imagesearch:*:1234:instance/*"}],"Version":"1"}图像搜索用户指南71.
2.
--创建一个策略.
把当前策略授权给您指定的子账号.
条件过滤功能介绍支持用户搜索的时候,只返回满足某些过滤条件的图像结果,比如只返回ownerId为1000的图像结果,或者只返回公司名称为"alibaba"的图像结果.
支持版本该功能仅18/03/27以后创建的实例方可支持,老版本的实例如需要升级,请提交工单申请.
使用说明1、目前支持按照int_attr和str_attr两个字段进行过滤,分别表示整型字段和字符串类型字段.

2、新增图片时,用户可以指定上述任意一个字段值:通过离线的方式上传时,样例如下:通过最新版SDK(1.
0.
3及以后)中AddItemRequest的setIntAttr和setStrAttr方法来设置相应的值.

{"Statement":[{"Action":["imagesearch:*",],"Effect":"Allow","Resource":"acs:imagesearch:*:1234:instance/instance12138"}],"Version":"1"}{"OperationType":"ADD","ProductId":"1000","CategoryId":0,"IntAttr":0,"StrAttr":"value1","CustomContent":"k1:v1,k2:v2,k3:v3","PicName":"girl_cloth1.
jpg"}图像搜索用户指南8--1.
2.
3.
4.
5.
----3、查询时,用户需要指定filter条件,int_attr支持的操作符有>str_attr支持的操作符有=和!
=,多个条件之支持AND和OR进行连接.
样例如下:直接通过API查询时,需要将filter参数的值设置为上述条件;通过SDK进行查询时,需要调用SearchItemRequest的setFilterClause方法来进行设置.

场景限制该功能仅适用于单个类目的数据量小于200万的场景.
当单个类目的数据量大于200万,并且用户没有提交过离线全量任务时,也能够正确的返回结果,但此时有可能导致查询超时.
标签管理图像搜索实例提供标签管理功能,方便您通过标签对实例进行分类.
使用限制每个标签都由一对键值对组成,标签的使用限制如下:目前不支持未绑定实例的空标签存在,标签必须绑定在某个图像搜索实例上.

一个实例最多可以绑定20个标签,区分大小写.
一个实例上的每个标签的标签键必须唯一,相同标签键的标签会被覆盖.

实例被删除后,对应的标签也会被清理.
新建标签时有以下限制:键是必选项,不建议过长,最多支持64个字符,不能以aliyun或acs:开头,不能包含http://和https://值是可选项,不建议过长,最多支持128个字符,不能以aliyun或acs:开头,不能包含http://和https://同一个资源,标签键不能重复,相同标签键的标签会被覆盖.
一个资源如果已经绑定了20个标签,再次新建标签会失败,您需要解绑部分标签后才能再绑定新的标签.
添加标签int_attr>=100str_attr!
="value1"int_attr=1000ANDstr_attr="value1"图像搜索用户指南91.
a.
b.
1.
4.
1.
2.
3.
登陆图像搜索控制台在实例列表页面可以看到标签栏,鼠标移动到标签图标上可以看到实例已有的标签,并会展示"编辑标签"选项.
点击"编辑标签"选项,会弹出"编辑标签"页面;有两种方式新增标签:方法1:点击"新增标签",会展开标签键值对的填写栏,正确填写内容,点击"确定"完成添加;方法2:可以选择添加本类型其他实例已有的标签:点击已有标签,会展开已有标签的下拉列表.
选择并点击对应的标签键和标签值,完成添加.
点击关闭,退出标签编辑.
搜索标签登陆图像搜索控制台在实例列表页面点击上方的"标签"图标,弹出的下拉列表会展现当前图片搜索类型下所有实例的标签,点击选择对应的标签内容即可展示经过标签过滤后的实例列表;可选择多个标签,多个标签之间是"与"逻辑;可以只选择标签的键进行过滤.

点击"重置"按钮,可清空已选择的标签过滤项.
删除标签登陆图像搜索控制台在实例列表页面可以看到标签栏,鼠标移动到标签图标上可以看到实例已有的标签,并会展示"编辑标签"选项.
点击"编辑标签"选项,会弹出"编辑标签"页面;点击想要删除的标签内容后面的"X"图标即可.
点击关闭,退出标签编辑.
图像搜索用户指南10系统限制实例数据量限制图像搜索实例支持的图片最大容量可在控制台中查看,为您购买时所选择的最大容量.
当前可支持250万、500万、1000万、2000万、3000万、4000万、5000万等共7种规格.
实例查询、新增和删除操作并发量限制查询操作默认的最大访问频率可在控制台中查看,为您购买时所选择的访问频次(QPS),当前支持5QPS、10QPS;删除操作默认的并发量为20,也就是每秒钟最多处理20个删除请求;上述操作超过限制的并发量将进行限流处理,如有特殊情况请提交工单或者通过邮件imagesearch-support@alibaba-inc.
com联系我们.
新增和查询图像大小以及像素要求图像的大小必须新建RAM角色.
ii.
在新建RAM角色对话框中,选择阿里云服务>图像搜索.
{"OperationType":"ADD","ProductId":"1000","CategoryId":0,"CustomContent":"k1:v1,k2:v2,k3:v3","PicName":"girl_cloth1.
jpg"}{"OperationType":"ADD","ProductId":"1001","CategoryId":1,"CustomContent":"k1:v1,k2:v2,k3:v3","PicName":"girl_cloth3.
jpg"}{"OperationType":"ADD","ProductId":"1002","CategoryId":0,"CustomContent":"k1:v1,k2:v2,k3:v3","PicName":"girl_cloth4.
jpg"}{"OperationType":"ADD","ProductId":"1003","CustomContent":"k1:v1,k2:v2,k3:v3","PicName":"girl_cloth6.
jpg"}{"OperationType":"DELETE","ProductId":"1004","PicName":"fengyi.
jpg"}{"OperationType":"DELETE","ProductId":"1005"}图像搜索用户指南13iii.
配置RAM角色名称.
图像搜索用户指南14--角色授权创建完角色之后,角色是没有任何权限的,需要创建一个授权策略来为服务账号来授予相应的权限.

授权策略如下:${bucket}:表示您在OSS上创建的bucket.
${path}:表示您的增量文件存储的路径.
示例以用户的bucket为imagesearch-increment,文件存储路径为/increment为例,授权策略如下:具体授权操作步骤如下:在RAM控制台上,选择权限管理>权限策略管理>新建权限策略.
{"Version":"1","Statement":[{"Effect":"Allow","Action":["oss:GetObject"],"Resource":["acs:oss:*:*:${bucket}${path}/*"]}]}{"Version":"1","Statement":[{"Effect":"Allow","Action":["oss:GetObject"],"Resource":["acs:oss:*:*:imagesearch-increment/increment/*"]}]}图像搜索用户指南15在新建自定义权限策略页面,填入策略名称,选择脚本配置,并配置策略内容.

单击确认.
图像搜索用户指南16返回RAM控制台首页,选择RAM角色管理.
通过RAM角色名称找到需要授权的角色,单击添加权限.
在添加权限对话框中,从左侧权限策略名称列中勾选需要授予当前角色的权限策略,单击确定,完成给角色授权.
提交增量在实例列表页或者实例详情页单击增量按钮,填入相应信息后,单击提交按钮,将触发后台服务从OSS上拉取数据,进行更新.
资源名称(Arn):单击上述授权访问部分新建的角色,取Arn字段,示例如下:图像搜索用户指南17--Bucket名称:OSS上创建的相应的bucket名称.
请确保开通的OSS服务与已购买的图像搜索服务在同一个地域.
数据路径:增量数据存储的路径.
路径以/符号开头,如:/imagesearch以Bucket名称:imagesearch1,数据路径:/imagesearch为例,如下增量历史在实例详情页,点击查看增量历史后,可以看到所有的增量任务的历史信息.