A MaxCompute endpoint is the access point used to connect to the MaxCompute service. Specify an endpoint when configuring MaxCompute client tools, SDKs, or APIs to ensure proper connectivity and successful submission of operations.
How to choose an endpoint
MaxCompute endpoints support both HTTP and HTTPS protocols. Choose an endpoint based on your region and network connectivity method.
-
Region selection: Use the endpoint that matches the region of your MaxCompute project. Otherwise, you cannot access the target project.
-
Network selection:
-
If your client runs inside Alibaba Cloud (such as on an ECS instance), use the VPC endpoint. VPC connections are more secure and stable.
-
If your client runs outside Alibaba Cloud (such as on an office computer), use the public endpoint. If your VPC network has not enabled public network access, you can only use the VPC endpoint.
-
Public endpoint
Configure only the public endpoint. MaxCompute will automatically resolve the public Tunnel endpoint for data transmission.
|
Region |
City (region) |
Public endpoint |
Public Tunnel endpoint |
|
China |
China (Hangzhou) |
https://service.cn-hangzhou.maxcompute.aliyun.com/api |
https://dt.cn-hangzhou.maxcompute.aliyun.com |
|
China |
China (Shanghai) |
https://service.cn-shanghai.maxcompute.aliyun.com/api |
https://dt.cn-shanghai.maxcompute.aliyun.com |
|
China |
China (Beijing) |
https://service.cn-beijing.maxcompute.aliyun.com/api |
https://dt.cn-beijing.maxcompute.aliyun.com |
|
China |
China (Ulanqab) |
https://service.cn-wulanchabu.maxcompute.aliyun.com/api |
https://dt.cn-wulanchabu.maxcompute.aliyun.com |
|
China |
China (Shenzhen) |
https://service.cn-shenzhen.maxcompute.aliyun.com/api |
https://dt.cn-shenzhen.maxcompute.aliyun.com |
|
China |
Hong Kong |
https://service.cn-hongkong.maxcompute.aliyun.com/api |
https://dt.cn-hongkong.maxcompute.aliyun.com |
|
Asia-Pacific |
Singapore |
https://service.ap-southeast-1.maxcompute.aliyun.com/api |
https://dt.ap-southeast-1.maxcompute.aliyun.com |
|
Asia-Pacific |
Malaysia (Kuala Lumpur) |
https://service.ap-southeast-3.maxcompute.aliyun.com/api |
https://dt.ap-southeast-3.maxcompute.aliyun.com |
|
Asia-Pacific |
Indonesia (Jakarta) |
https://service.ap-southeast-5.maxcompute.aliyun.com/api |
https://dt.ap-southeast-5.maxcompute.aliyun.com |
|
Asia-Pacific |
Thailand (Bangkok) |
https://service.ap-southeast-7.maxcompute.aliyun.com/api |
https://dt.ap-southeast-7.maxcompute.aliyun.com |
|
Asia-Pacific |
Japan (Tokyo) |
https://service.ap-northeast-1.maxcompute.aliyun.com/api |
https://dt.ap-northeast-1.maxcompute.aliyun.com |
|
Asia-Pacific |
South Korea (Seoul) |
https://service.ap-northeast-2.maxcompute.aliyun.com/api |
https://dt.ap-northeast-2.maxcompute.aliyun.com |
|
Europe and Americas |
Germany (Frankfurt) |
https://service.eu-central-1.maxcompute.aliyun.com/api |
https://dt.eu-central-1.maxcompute.aliyun.com |
|
Europe and Americas |
US (Silicon Valley) |
https://service.us-west-1.maxcompute.aliyun.com/api |
https://dt.us-west-1.maxcompute.aliyun.com |
|
Europe and Americas |
US (Virginia) |
https://service.us-east-1.maxcompute.aliyun.com/api |
https://dt.us-east-1.maxcompute.aliyun.com |
|
Europe and Americas |
UK (London) |
https://service.eu-west-1.maxcompute.aliyun.com/api |
https://dt.eu-west-1.maxcompute.aliyun.com |
|
Europe and Americas |
Mexico |
https://service.na-south-1.maxcompute.aliyun.com/api |
https://dt.na-south-1.maxcompute.aliyun.com |
|
Middle East and India |
UAE (Dubai) |
https://service.me-east-1.maxcompute.aliyun.com/api |
https://dt.me-east-1.maxcompute.aliyun.com |
|
Middle East and India |
SAU (Riyadh - Partner Region) |
https://service.me-central-1.maxcompute.aliyun.com/api |
https://dt.me-central-1.maxcompute.aliyun.com |
VPC endpoint
Configure only the VPC endpoint. MaxCompute will automatically resolve the VPC Tunnel endpoint for data transmission.
|
Region |
City (region) |
VPC endpoint |
VPC Tunnel endpoint |
|
China |
China (Hangzhou) |
https://service.cn-hangzhou-vpc.maxcompute.aliyun-inc.com/api |
https://dt.cn-hangzhou-vpc.maxcompute.aliyun-inc.com |
|
China |
China (Shanghai) |
https://service.cn-shanghai-vpc.maxcompute.aliyun-inc.com/api |
https://dt.cn-shanghai-vpc.maxcompute.aliyun-inc.com |
|
China |
China (Beijing) |
https://service.cn-beijing-vpc.maxcompute.aliyun-inc.com/api |
https://dt.cn-beijing-vpc.maxcompute.aliyun-inc.com |
|
China |
China (Ulanqab) |
https://service.cn-wulanchabu-vpc.maxcompute.aliyun-inc.com/api |
https://dt.cn-wulanchabu-vpc.maxcompute.aliyun-inc.com |
|
China |
China (Shenzhen) |
https://service.cn-shenzhen-vpc.maxcompute.aliyun-inc.com/api |
https://dt.cn-shenzhen-vpc.maxcompute.aliyun-inc.com |
|
China |
Hong Kong |
https://service.cn-hongkong-vpc.maxcompute.aliyun-inc.com/api |
https://dt.cn-hongkong-vpc.maxcompute.aliyun-inc.com |
|
Asia-Pacific |
Singapore |
https://service.ap-southeast-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.ap-southeast-1-vpc.maxcompute.aliyun-inc.com |
|
Asia-Pacific |
Malaysia (Kuala Lumpur) |
https://service.ap-southeast-3-vpc.maxcompute.aliyun-inc.com/api |
https://dt.ap-southeast-3-vpc.maxcompute.aliyun-inc.com |
|
Asia-Pacific |
Indonesia (Jakarta) |
https://service.ap-southeast-5-vpc.maxcompute.aliyun-inc.com/api |
https://dt.ap-southeast-5-vpc.maxcompute.aliyun-inc.com |
|
Asia-Pacific |
Thailand (Bangkok) |
https://service.ap-southeast-7-vpc.maxcompute.aliyun-inc.com/api |
https://dt.ap-southeast-7-vpc.maxcompute.aliyun-inc.com |
|
Asia-Pacific |
Japan (Tokyo) |
https://service.ap-northeast-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.ap-northeast-1-vpc.maxcompute.aliyun-inc.com |
|
Asia-Pacific |
South Korea (Seoul) |
https://service.ap-northeast-2-vpc.maxcompute.aliyun-inc.com/api |
https://dt.ap-northeast-2-vpc.maxcompute.aliyun-inc.com |
|
Europe and Americas |
Germany (Frankfurt) |
https://service.eu-central-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.eu-central-1-vpc.maxcompute.aliyun-inc.com |
|
Europe and Americas |
US (Silicon Valley) |
https://service.us-west-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.us-west-1-vpc.maxcompute.aliyun-inc.com |
|
Europe and Americas |
US (Virginia) |
https://service.us-east-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.us-east-1-vpc.maxcompute.aliyun-inc.com |
|
Europe and Americas |
UK (London) |
https://service.eu-west-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.eu-west-1-vpc.maxcompute.aliyun-inc.com |
|
Europe and Americas |
Mexico |
https://service.na-south-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.na-south-1-vpc.maxcompute.aliyun-inc.com |
|
Middle East and India |
UAE (Dubai) |
https://service.me-east-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.me-east-1-vpc.maxcompute.aliyun-inc.com |
|
Middle East and India |
SAU (Riyadh - Partner Region) |
https://service.me-central-1-vpc.maxcompute.aliyun-inc.com/api |
https://dt.me-central-1-vpc.maxcompute.aliyun-inc.com |
Interconnected cloud product endpoint
Appendix: View endpoints in the console
You can view endpoints in the MaxCompute console for the following regions: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), and China (Chengdu).
-
Log in to the MaxCompute console and select a region in the upper-left corner.
-
In the left-side navigation pane, choose .
You can then view endpoint information in the console.
References
-
Scenarios that require endpoint configuration include the following:
-
Connecting to MaxCompute using tools:
-
To connect to a MaxCompute project using the MaxCompute client (odpscmd), configure the odps_config.ini file. For more information, see Install and configure the MaxCompute client.
-
To connect to a MaxCompute project using MaxCompute Studio, see Manage project connections.
-
To connect to a MaxCompute data source using DataWorks, see Configure a MaxCompute data source.
-
-
Connecting to a MaxCompute project through code configuration:
-
To connect to a MaxCompute project using an SDK, see Java SDK overview and Python SDK example: SQL.
-
To connect to a MaxCompute project using JDBC, see JDBC overview. The JDBC connection URL format is
jdbc:odps:<endpoint>?project=<project_name>. Replace<endpoint>with the endpoint address listed above and<project_name>with your MaxCompute project name. Use the driver classcom.aliyun.odps.jdbc.OdpsDriverand authenticate using your AccessKey ID and AccessKey secret. For detailed usage and code examples of generic JDBC connections, see Usage instructions. -
To export SQL query results using SQLTask with the Data Transmission Service, see Export data using SQLTask with Tunnel.
-
-
-
For information about Alibaba Cloud regions and zones, including definitions, selection guidance, their relationship, and supported regions and zones, see Regions and zones.