全部产品
Search
文档中心

图像搜索:服务节点地址及内网(VPC)调用方式

更新时间:Feb 21, 2024

阿里云图像搜索API支持基于URL发起HTTP/HTTPS请求。请求参数需要包含在URL中。本文列举了API请求中的结构解释,并提供了图像搜索服务的接入地址(Endpoint)。

服务地址

地域

Region

接入地址

VPC内网地址

华东1 (杭州)

cn-hangzhou

imagesearch.cn-hangzhou.aliyuncs.com

imagesearch-vpc.cn-hangzhou.aliyuncs.com

华东2(上海)

cn-shanghai

imagesearch.cn-shanghai.aliyuncs.com

imagesearch-vpc.cn-shanghai.aliyuncs.com

华北2(北京)

cn-beijing

imagesearch.cn-beijing.aliyuncs.com

imagesearch-vpc.cn-beijing.aliyuncs.com

华南1(深圳)

cn-shenzhen

imagesearch.cn-shenzhen.aliyuncs.com

imagesearch-vpc.cn-shenzhen.aliyuncs.com

亚太东南 1 (新加坡)

ap-southeast-1

imagesearch.ap-southeast-1.aliyuncs.com

imagesearch-vpc.ap-southeast-1.aliyuncs.com

中国(香港)

cn-hongkong

imagesearch.cn-hongkong.aliyuncs.com

imagesearch-vpc.cn-hongkong.aliyuncs.com

亚太东北1(东京)

ap-northeast-1

imagesearch.ap-northeast-1.aliyuncs.com

imagesearch-vpc.ap-northeast-1.aliyuncs.com

欧洲中部1(法兰克福)

eu-central-1

imagesearch.eu-central-1.aliyuncs.com

imagesearch-vpc.eu-central-1.aliyuncs.com

说明
  • 当前中国站账号在控制台中只支持选择华东2(上海)华东1(杭州)华南1(深圳)华北2(北京)

  • VPC内网访问:仅限同区域ECS上的访问,例如您购买的图像搜索实例是华东1(杭州),那么您的ECS或资源也必须在华东1(杭州)才能通过内网VPC地址访问图搜服务,否则会调用不通。

  • VPC内网地址:使用内网服务入口访问时不会消耗ECS公网流量,帮助您节约ECS公网带宽资源。详情请参见VPC使用示例

通信协议

支持通过HTTP或HTTPS通道进行请求通信。为了获得更高的安全性,推荐您使用HTTPS通道发送请求。

请求方法

支持HTTP/POST方法发送请求。

请求参数

每个操作都需要包含公共请求Header参数,以及各操作所特有的请求参数。

字符编码

请求及返回结果都使用UTF-8字符集进行编码。

VPC使用示例

v3版本SDK:

# 使用vpc域名
authConfig.endpoint = "imagesearch-vpc.cn-shanghai.aliyuncs.com";
# 新增配置
authConfig.endpointType = "internal";
说明
  1. Java SDK 调用示例请参考Add接口

  2. VPC内网访问:仅限同区域ECS或资源的访问,例如您购买的图像搜索实例是华东1(杭州),那么您的ECS或资源也必须在华东1(杭州)才能通过内网VPC地址访问图搜服务,否则会调用不通。

v3之前版本SDK:

// 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
// 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
// 本示例以将AccessKey ID和AccessKey Secret保存在环境变量为例说明。您也可以根据业务需要,保存到配置文件里。
IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", System.getenv("CC_AK_ENV"), System.getenv("CC_SK_ENV"));
# 使用vpc域名
DefaultProfile.addEndpoint("cn-shanghai", "ImageSearch", "imagesearch-vpc.cn-shanghai.aliyuncs.com");
this.client = new DefaultAcsClient(profile);