Image Search API uses URL-based HTTP/HTTPS requests with parameters included in the URL. This page lists the endpoints, VPC addresses, and request structure for each supported region.
Endpoints
|
Region |
Region |
Endpoint |
VPC Network Address |
|
China (Hangzhou) |
cn-hangzhou |
imagesearch.cn-hangzhou.aliyuncs.com |
imagesearch-vpc.cn-hangzhou.aliyuncs.com |
|
China (Shanghai) |
cn-shanghai |
imagesearch.cn-shanghai.aliyuncs.com |
imagesearch-vpc.cn-shanghai.aliyuncs.com |
|
China (Beijing) |
cn-beijing |
imagesearch.cn-beijing.aliyuncs.com |
imagesearch-vpc.cn-beijing.aliyuncs.com |
|
China (Shenzhen) |
cn-shenzhen |
imagesearch.cn-shenzhen.aliyuncs.com |
imagesearch-vpc.cn-shenzhen.aliyuncs.com |
|
Asia-Pacific SE 1 (Singapore) |
ap-southeast-1 |
imagesearch.ap-southeast-1.aliyuncs.com |
imagesearch-vpc.ap-southeast-1.aliyuncs.com |
|
China (Hong Kong) |
cn-hongkong |
imagesearch.cn-hongkong.aliyuncs.com |
imagesearch-vpc.cn-hongkong.aliyuncs.com |
|
Asia-Pacific NE 1 (Tokyo) |
ap-northeast-1 |
imagesearch.ap-northeast-1.aliyuncs.com |
imagesearch-vpc.ap-northeast-1.aliyuncs.com |
|
Europe Central 1 (Frankfurt) |
eu-central-1 |
imagesearch.eu-central-1.aliyuncs.com |
imagesearch-vpc.eu-central-1.aliyuncs.com |
-
Accounts on the Alibaba Cloud China site can select only the following regions in the console: China (Shanghai), China (Hangzhou), China (Shenzhen), and China (Beijing).
-
VPC network access: Image Search is accessible only from ECS instances or other resources in the same region. For example, an Image Search instance in China (Hangzhou) requires your ECS instance or other resources to also be in China (Hangzhou). Cross-region VPC calls fail.
-
VPC endpoint: Traffic through a VPC endpoint does not consume Internet traffic on your ECS instance, reducing public bandwidth costs. VPC usage example.
Domain whitelist
Add the following domain names to your O&M whitelist based on your service region.
|
Region |
Region |
Domain Names |
|
China (Hangzhou) |
cn-hangzhou |
openplatform.aliyuncs.com hangzhou-imagesearch-transfer-station.oss-cn-hangzhou.aliyuncs.com imagesearch.cn-hangzhou.aliyuncs.com |
|
China (Shanghai) |
cn-shanghai |
openplatform.aliyuncs.com sh-imagesearch-transfer-station.oss-cn-shanghai.aliyuncs.com imagesearch.cn-shanghai.aliyuncs.com |
|
China (Beijing) |
cn-beijing |
openplatform.aliyuncs.com bj-imagesearch-transfer-station.oss-cn-beijing.aliyuncs.com imagesearch.cn-beijing.aliyuncs.com |
|
China (Shenzhen) |
cn-shenzhen |
openplatform.aliyuncs.com sz-imagesearch-transfer-station.oss-cn-shenzhen.aliyuncs.com imagesearch.cn-shenzhen.aliyuncs.com |
|
Asia-Pacific SE 1 (Singapore) |
ap-southeast-1 |
openplatform.aliyuncs.com sg-imagesearch-transfer-station-new.oss-ap-southeast-1.aliyuncs.com imagesearch.ap-southeast-1.aliyuncs.com |
|
China (Hong Kong) |
cn-hongkong |
openplatform.aliyuncs.com hk-imagesearch-transfer-station.oss-cn-hongkong.aliyuncs.com imagesearch.cn-hongkong.aliyuncs.com |
|
Asia-Pacific NE 1 (Tokyo) |
ap-northeast-1 |
openplatform.aliyuncs.com jp-imagesearch-transfer-station.oss-ap-northeast-1.aliyuncs.com imagesearch.ap-northeast-1.aliyuncs.com |
|
Europe Central 1 (Frankfurt) |
eu-central-1 |
openplatform.aliyuncs.com de-imagesearch-transfer-station.oss-eu-central-1.aliyuncs.com imagesearch.eu-central-1.aliyuncs.com |
Communication protocols
HTTP and HTTPS are supported. HTTPS is recommended for security.
Request methods
All requests use the HTTP POST method.
Request parameters
Each request includes common header parameters and operation-specific parameters.
Character encoding
All requests and responses use UTF-8 encoding.
VPC usage example
SDK v3:
# Use the VPC domain name
authConfig.endpoint = "imagesearch-vpc.cn-shanghai.aliyuncs.com";
# Add a new configuration
authConfig.endpointType = "internal";-
For a Java SDK example, refer to the Add operation.
-
VPC network access: Image Search is accessible only from ECS instances or other resources in the same region. For example, an Image Search instance in China (Hangzhou) requires your ECS instance to also be in China (Hangzhou). Cross-region VPC calls fail.
SDKs earlier than v3:
// An Alibaba Cloud account AccessKey has full permissions for all APIs. For better security, use a RAM user for API calls and daily O&M.
// Do not hard-code your AccessKey ID and AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked and the security of all the resources in your account may be compromised.
// This example shows how to store the AccessKey ID and AccessKey secret in environment variables. You can also store them in a configuration file as needed.
IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", System.getenv("CC_AK_ENV"), System.getenv("CC_SK_ENV"));
// Use the VPC domain name
DefaultProfile.addEndpoint("cn-shanghai", "ImageSearch", "imagesearch-vpc.cn-shanghai.aliyuncs.com");
this.client = new DefaultAcsClient(profile);