This topic describes the endpoints used across various regions and network connection modes, along with the network connectivity and billing rules when MaxCompute interacts with other Alibaba Cloud services.
Background information
MaxCompute offers the MaxCompute service and Tunnel data transmission service:
-
MaxCompute service: The connection address, known as an endpoint, varies depending on the selected region and network connection mode. You can send all requests, except for data upload and download, to MaxCompute, such as creating a table, deleting a function, or running a computing job.
-
Tunnel data transmission service: The connection address for this service is a Tunnel endpoint, which also varies by region and network connection mode. This service enables the upload and download of data from local or cloud data sources.
For more information about network connection modes, see network connection modes.
For a comparison of endpoints and Tunnel endpoints across different regions and networks, see endpoints in different regions (Internet connection mode), endpoints in different regions (VPC), and endpoints in different regions (Alibaba Cloud product interconnection mode).
Scenarios
You must configure a MaxCompute endpoint or Tunnel endpoint in the following scenarios:
-
Connecting to MaxCompute using a tool:
-
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 MaxCompute data sources.
-
-
Connecting to MaxCompute projects by configuring code:
-
To connect to a MaxCompute project using the SDK, see Java SDK introduction and Python SDK example: SQL.
-
To connect to a MaxCompute project using JDBC, see JDBC introduction.
-
To export SQL execution results using SQLTask with Tunnel data transmission service, see export using SQLTask with Tunnel.
-
Precautions
-
When using Tunnel data transmission service, consider the following:
-
If a Tunnel endpoint is not configured, the MaxCompute client automatically retrieves one from MaxCompute. The returned Tunnel endpoint is determined by factors such as the network type requested by the client and the workloads of Tunnel endpoints.
The Tunnel endpoint provided by MaxCompute to the client is not fixed. To ensure the client can access the retrieved Tunnel endpoint as expected, plan security policies for the client's network, including network whitelists, firewall rules, and VPC security group rules.
NoteTunnel endpoints dynamically provided by MaxCompute include long-term and short-term endpoints. Short-term endpoints are for MaxCompute's high availability and are automatically created and deleted by MaxCompute. Do not save short-term Tunnel endpoints. For information on long-term Tunnel endpoints, see endpoints in different regions (Internet connection mode) and endpoints in different regions (Alibaba Cloud product interconnection mode).
-
If you have configured a Tunnel endpoint, the MaxCompute client will use the specified endpoint instead of retrieving one from MaxCompute.
-
Tunnel endpoints do not support cross-domain connections. Ensure you configure a Tunnel endpoint in the same region and with the same network type as the MaxCompute client for normal access.
-
Billing rules for Tunnel data transmission service vary by region and network type. For billing details, see billing rules.
-
To avoid compatibility issues with data integration tools or products, select those that are more compatible with MaxCompute, such as DataWorks data integration.
-
-
The classic network connection mode for MaxCompute on Alibaba Cloud will be discontinued on Wednesday, November 30, 2024. It will be replaced by the Alibaba Cloud product interconnection network connection mode. Ensure you switch to the Alibaba Cloud VPC network connection mode or the Alibaba Cloud product interconnection network connection mode promptly to prevent any disruptions to your business.
NoteFor more details on the discontinuation of the classic network connection mode for MaxCompute on Alibaba Cloud, see October 15, 2024 - Discontinuation of the classic network connection mode for MaxCompute on Alibaba Cloud and update of endpoint addresses.
-
You can only connect to a MaxCompute project through the endpoint in the region where the project is located.
Network connection modes
The following three connection modes are available for accessing MaxCompute service and Tunnel data transmission service through the endpoint in the region where the MaxCompute project is located:
-
Access MaxCompute service and Tunnel data transmission service from the Internet.
-
Access MaxCompute service and Tunnel data transmission service from the Alibaba Cloud VPC network.
-
Access MaxCompute service and Tunnel data transmission service from the Alibaba Cloud product interconnection network.
When using MaxCompute to read from and write to OSS or Tablestore, keep in mind the following:
-
If MaxCompute and Tablestore or OSS are in the same region, all three connection modes are available. For better performance, the Alibaba Cloud VPC network or the cloud product interconnection network connection mode is recommended.
-
If MaxCompute and Tablestore or OSS are in different regions, the Internet connection mode is recommended. Using the Alibaba Cloud VPC network or the cloud product interconnection network connection mode may result in connectivity issues.
Billing rules
The billing rules for MaxCompute service and Tunnel data transmission service are as follows.
Service type | Billing rules |
MaxCompute service | You are charged for data computing when you develop different types of jobs or run SQL jobs to read data from and write data to data sources by using external tables. The billing rules depend on the billing method that you select when you create a MaxCompute project. For more information, see computing fees. |
Data transmission service (Tunnel) | No fees are charged when you upload data by using Tunnel data transmission service. When you download data from cloud data sources or local data sources by using Tunnel data transmission service in any region:
|
Endpoints in different regions (Internet connection mode)
Endpoints support both HTTPS and HTTP connections. HTTPS connections are secured using TLS v1.2.
The following Tunnel endpoints apply only to parameters or options named tunnel endpoint
.
Region | City | Status | Internet endpoint | Internet tunnel endpoint |
China | China (Hangzhou) | Active | https://service.cn-hangzhou.maxcompute.aliyun.com/api | https://dt.cn-hangzhou.maxcompute.aliyun.com |
China | China (Shanghai) | Active | https://service.cn-shanghai.maxcompute.aliyun.com/api | https://dt.cn-shanghai.maxcompute.aliyun.com |
China | China (Beijing) | Active | https://service.cn-beijing.maxcompute.aliyun.com/api | https://dt.cn-beijing.maxcompute.aliyun.com |
China | China (Ulanqab) | Active | https://service.cn-wulanchabu.maxcompute.aliyun.com/api | https://dt.cn-wulanchabu.maxcompute.aliyun.com |
China | China (Shenzhen) | Active | https://service.cn-shenzhen.maxcompute.aliyun.com/api | https://dt.cn-shenzhen.maxcompute.aliyun.com |
China | Hong Kong | Active | https://service.cn-hongkong.maxcompute.aliyun.com/api | https://dt.cn-hongkong.maxcompute.aliyun.com |
Asia Pacific | Singapore | Active | https://service.ap-southeast-1.maxcompute.aliyun.com/api | https://dt.ap-southeast-1.maxcompute.aliyun.com |
Asia Pacific | Malaysia (Kuala Lumpur) | Active | https://service.ap-southeast-3.maxcompute.aliyun.com/api | https://dt.ap-southeast-3.maxcompute.aliyun.com |
Asia Pacific | Indonesia (Jakarta) | Active | https://service.ap-southeast-5.maxcompute.aliyun.com/api | https://dt.ap-southeast-5.maxcompute.aliyun.com |
Asia Pacific | Japan (Tokyo) | Active | https://service.ap-northeast-1.maxcompute.aliyun.com/api | https://dt.ap-northeast-1.maxcompute.aliyun.com |
Europe & Americas | Germany (Frankfurt) | Active | https://service.eu-central-1.maxcompute.aliyun.com/api | https://dt.eu-central-1.maxcompute.aliyun.com |
Europe & Americas | US (Silicon Valley) | Active | https://service.us-west-1.maxcompute.aliyun.com/api | https://dt.us-west-1.maxcompute.aliyun.com |
Europe & Americas | US (Virginia) | Active | https://service.us-east-1.maxcompute.aliyun.com/api | https://dt.us-east-1.maxcompute.aliyun.com |
Europe & Americas | UK (London) | Active | https://service.eu-west-1.maxcompute.aliyun.com/api | https://dt.eu-west-1.maxcompute.aliyun.com |
Middle East & India | UAE (Dubai) | Active | https://service.me-east-1.maxcompute.aliyun.com/api | https://dt.me-east-1.maxcompute.aliyun.com |
Middle East & India | SAU (Riyadh - Partner Region) | Active | https://service.me-central-1.maxcompute.aliyun.com/api | https://dt.me-central-1.maxcompute.aliyun.com |
Endpoints in different regions (VPC)
Endpoints support both HTTPS and HTTP connections. HTTPS connections are secured using TLS v1.2.
The following Tunnel endpoints apply only to parameters or options named tunnel endpoint
.
Region | City | Status | VPC endpoint | VPC tunnel endpoint |
China | China (Hangzhou) | Active | https://service.cn-hangzhou-vpc.maxcompute.aliyun-inc.com/api | https://dt.cn-hangzhou-vpc.maxcompute.aliyun-inc.com |
China | China (Shanghai) | Active | https://service.cn-shanghai-vpc.maxcompute.aliyun-inc.com/api | https://dt.cn-shanghai-vpc.maxcompute.aliyun-inc.com |
China | China (Beijing) | Active | https://service.cn-beijing-vpc.maxcompute.aliyun-inc.com/api | https://dt.cn-beijing-vpc.maxcompute.aliyun-inc.com |
China | China (Ulanqab) | Active | https://service.cn-wulanchabu-vpc.maxcompute.aliyun-inc.com/api | https://dt.cn-wulanchabu-vpc.maxcompute.aliyun-inc.com |
China | China (Shenzhen) | Active | https://service.cn-shenzhen-vpc.maxcompute.aliyun-inc.com/api | https://dt.cn-shenzhen-vpc.maxcompute.aliyun-inc.com |
China | Hong Kong | Active | https://service.cn-hongkong-vpc.maxcompute.aliyun-inc.com/api | https://dt.cn-hongkong-vpc.maxcompute.aliyun-inc.com |
Asia Pacific | Singapore | Active | 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) | Active | 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) | Active | https://service.ap-southeast-5-vpc.maxcompute.aliyun-inc.com/api | https://dt.ap-southeast-5-vpc.maxcompute.aliyun-inc.com |
Asia Pacific | Japan (Tokyo) | Active | https://service.ap-northeast-1-vpc.maxcompute.aliyun-inc.com/api | https://dt.ap-northeast-1-vpc.maxcompute.aliyun-inc.com |
Europe & Americas | Germany (Frankfurt) | Active | https://service.eu-central-1-vpc.maxcompute.aliyun-inc.com/api | https://dt.eu-central-1-vpc.maxcompute.aliyun-inc.com |
Europe & Americas | US (Silicon Valley) | Active | https://service.us-west-1-vpc.maxcompute.aliyun-inc.com/api | https://dt.us-west-1-vpc.maxcompute.aliyun-inc.com |
Europe & Americas | US (Virginia) | Active | https://service.us-east-1-vpc.maxcompute.aliyun-inc.com/api | https://dt.us-east-1-vpc.maxcompute.aliyun-inc.com |
Europe & Americas | UK (London) | Active | https://service.eu-west-1-vpc.maxcompute.aliyun-inc.com/api | https://dt.eu-west-1-vpc.maxcompute.aliyun-inc.com |
Middle East & India | UAE (Dubai) | Active | https://service.me-east-1-vpc.maxcompute.aliyun-inc.com/api | https://dt.me-east-1-vpc.maxcompute.aliyun-inc.com |
Middle East & India | SAU (Riyadh - Partner Region) | Active | https://service.me-central-1-vpc.maxcompute.aliyun-inc.com/api | https://dt.me-central-1-vpc.maxcompute.aliyun-inc.com |
Endpoints in different regions (Alibaba Cloud product interconnection mode)
Endpoints support both HTTPS and HTTP connections. HTTPS connections are secured using TLS v1.2.
The following Tunnel endpoints apply only to parameters or options named tunnel endpoint
.
Region | City | Status | Cloud product interconnection endpoint | Cloud product interconnection tunnel endpoint |
China | China (Hangzhou) | Active | https://service.cn-hangzhou-intranet.maxcompute.aliyun-inc.com/api | https://dt.cn-hangzhou-intranet.maxcompute.aliyun-inc.com |
China | China (Shanghai) | Active | https://service.cn-shanghai-intranet.maxcompute.aliyun-inc.com/api | https://dt.cn-shanghai-intranet.maxcompute.aliyun-inc.com |
China | China (Beijing) | Active | https://service.cn-beijing-intranet.maxcompute.aliyun-inc.com/api | https://dt.cn-beijing-intranet.maxcompute.aliyun-inc.com |
China | China (Ulanqab) | Active | https://service.cn-wulanchabu-intranet.maxcompute.aliyun-inc.com/api | https://dt.cn-wulanchabu-intranet.maxcompute.aliyun-inc.com |
China | China (Shenzhen) | Active | https://service.cn-shenzhen-intranet.maxcompute.aliyun-inc.com/api | https://dt.cn-shenzhen-intranet.maxcompute.aliyun-inc.com |
China | Hong Kong | Active | https://service.cn-hongkong-intranet.maxcompute.aliyun-inc.com/api | https://dt.cn-hongkong-intranet.maxcompute.aliyun-inc.com |
Asia Pacific | Singapore | Active | https://service.ap-southeast-1-intranet.maxcompute.aliyun-inc.com/api | https://dt.ap-southeast-1-intranet.maxcompute.aliyun-inc.com |
Asia Pacific | Malaysia (Kuala Lumpur) | Active | https://service.ap-southeast-3-intranet.maxcompute.aliyun-inc.com/api | https://dt.ap-southeast-3-intranet.maxcompute.aliyun-inc.com |
Asia Pacific | Indonesia (Jakarta) | Active | https://service.ap-southeast-5-intranet.maxcompute.aliyun-inc.com/api | https://dt.ap-southeast-5-intranet.maxcompute.aliyun-inc.com |
Asia Pacific | Japan (Tokyo) | Active | https://service.ap-northeast-1-intranet.maxcompute.aliyun-inc.com/api | https://dt.ap-northeast-1-intranet.maxcompute.aliyun-inc.com |
Europe & Americas | Germany (Frankfurt) | Active | https://service.eu-central-1-intranet.maxcompute.aliyun-inc.com/api | https://dt.eu-central-1-intranet.maxcompute.aliyun-inc.com |
Europe & Americas | US (Silicon Valley) | Active | https://service.us-west-1-intranet.maxcompute.aliyun-inc.com/api | https://dt.us-west-1-intranet.maxcompute.aliyun-inc.com |
Europe & Americas | US (Virginia) | Active | https://service.us-east-1-intranet.maxcompute.aliyun-inc.com/api | https://dt.us-east-1-intranet.maxcompute.aliyun-inc.com |
Europe & Americas | UK (London) | Active | https://service.eu-west-1-intranet.maxcompute.aliyun-inc.com/api | https://dt.eu-west-1-intranet.maxcompute.aliyun-inc.com |
Middle East & India | UAE (Dubai) | Active | https://service.me-east-1-intranet.maxcompute.aliyun-inc.com/api | https://dt.me-east-1-intranet.maxcompute.aliyun-inc.com |
Middle East & India | SAU (Riyadh - Partner Region) | Active | https://service.me-central-1-intranet.maxcompute.aliyun-inc.com/api | https://dt.me-central-1-intranet.maxcompute.aliyun-inc.com |