阿里雲Image SearchAPI支援基於URL發起HTTP/HTTPS請求。請求參數需要包含在URL中。本文列舉了API請求中的結構解釋,並提供了Image Search服務的接入地址(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上的訪問,例如您購買的Image Search執行個體是華東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";Java SDK 調用樣本請參考Add介面
VPC內網訪問:僅限同地區ECS或資源的訪問,例如您購買的Image Search執行個體是華東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);