Endpoints

This topic describes the endpoints that are used in different regions and different network connection modes. This topic also describes the network connectivity and billing rules when MaxCompute communicates with other Alibaba Cloud services.

Background information

MaxCompute provides the MaxCompute service and Tunnel data transfer service.

MaxCompute service: The connection address is an endpoint, which varies based on the region and network connection mode that you select. You can send all requests except data upload and download requests to MaxCompute. For example, you can send a request to create a table, delete a function, or run a computing job.
Tunnel data transfer service: The connection address is a Tunnel endpoint, which varies based on the region and network connection mode that you select. The Tunnel data transfer service allows you to upload data to or download data from on-premises or cloud data sources.

For more information about the network connection modes, see Network connection modes.

For more information about the MaxCompute endpoints and Tunnel endpoints that are used in different regions and network connection modes, see Endpoints in different regions (Internet), Endpoints in different regions (VPC), and Endpoints in different regions (internal network for connecting cloud products).

Scenarios

You must configure a MaxCompute endpoint or Tunnel endpoint in the following scenarios:

Connect to MaxCompute by using a tool
- Use the MaxCompute client (odpscmd) to connect to MaxCompute projects. In this case, you must configure the odps_config.ini file. For more information about how to install and configure the MaxCompute client, see Install and configure the MaxCompute client.
- Use MaxCompute Studio to connect to MaxCompute projects. For more information, see Manage project connections.
- Use DataWorks to connect to MaxCompute data sources. For more information about how to configure MaxCompute data sources in DataWorks, see Add a MaxCompute data source.
Connect to MaxCompute projects by configuring code
- Use an SDK to connect to MaxCompute projects. For more information, see SDK for Java and Examples of using the SDK for Python: SQL statements.
- Use a Java Database Connectivity (JDBC) driver to connect to MaxCompute projects. For more information, see JDBC.
- Use the SQLTask class with the Tunnel data transfer service to export the execution results of SQL statements. For more information, see Use SQLTask and Tunnel to export data.

Precautions

Before you use the Tunnel data transfer service, take note of the following points:
- If you do not configure a Tunnel endpoint, the MaxCompute client automatically obtains a Tunnel endpoint from MaxCompute. MaxCompute returns a Tunnel endpoint to the MaxCompute client based on factors such as the network type requested by the MaxCompute client and the workloads of Tunnel endpoints. The network types requested by the MaxCompute client include Internet and virtual private cloud (VPC).
  The Tunnel endpoint that the MaxCompute client automatically obtains from MaxCompute is not fixed. We recommend that you plan security policies for the network in which the MaxCompute client resides, including but not limited to network whitelists, firewall rules, and VPC security group rules. This ensures that the MaxCompute client can access the obtained Tunnel endpoint as expected.
  Note
  Tunnel endpoints that the MaxCompute client dynamically obtains from MaxCompute include long-term and short-term Tunnel endpoints. Short-term Tunnel endpoints serve for the high availability of MaxCompute. MaxCompute automatically creates and deletes short-term Tunnel endpoints. We recommend that you do not save short-term Tunnel endpoints. For more information about long-term Tunnel endpoints, see Endpoints in different regions (Internet) and Endpoints in different regions (internal network for connecting cloud products).
- If you have configured a Tunnel endpoint, the MaxCompute client uses the Tunnel endpoint that you configured instead of obtaining a Tunnel endpoint from MaxCompute.
- You must configure a Tunnel endpoint that resides in the same region as the MaxCompute client and has the same network type as the MaxCompute client to ensure that the Tunnel endpoint can be normally accessed.
- The billing rules for the Tunnel data transfer service vary based on the region and the network type that you select. For more information about the billing rules, see Billing rules.
- To avoid compatibility issues, we recommend that you use data integration tools or services that are compatible with MaxCompute, such as Data Integration of DataWorks.
The MaxCompute classic network will be discontinued on November 30, 2024 (Wednesday). It will be replaced by the internal network for connecting cloud products. Please confirm and switch to the VPC or the internal network to avoid any disruption to your business due to network connection interruptions.
Note
For more details on the discontinuation of the classic network connection mode for MaxCompute on Alibaba Cloud, see October 15, 2024 (UTC+8): Notice on the discontinuation of the Alibaba Cloud classic network connection mode and updates of endpoints in MaxCompute.
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 from Internet.
Tunnel data transfer service.
Access MaxCompute service and Tunnel data transfer service from a VPC.
Access MaxCompute service and Tunnel data transfer service from the internal network for connecting cloud products.

Before you use MaxCompute to read data from and write data to OSS or Tablestore, take note of the following points:

If MaxCompute and Tablestore or OSS are deployed in the same region, all the preceding connection modes are supported. We recommend that you use the VPC or the internal network for connecting cloud products for better performance.
If MaxCompute and Tablestore or OSS are not deployed in the same region, we recommend that you use the Internet. If you use the VPC or the internal network for connecting cloud products, connectivity issues may occur.

Billing rules

The following table describes the billing rules for the MaxCompute service and Tunnel data transfer service.

Service type	Billing rule

Service type	Billing rule
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 vary based on the billing method that you select when you create a MaxCompute project. For more information, see Computing pricing.
Tunnel service	You are not charged when you use the Tunnel data transfer service to upload data. When you use the Tunnel data transfer service to download data from cloud data sources or on-premises data sources in a region, the following billing rules apply: If your Elastic Compute Service (ECS) instance and MaxCompute project are in the same region, you can download data over the classic network or a VPC free of charge. If your ECS instance and MaxCompute project are not in the same region or if the two are in the same region but your ECS instance cannot access MaxCompute, you are charged when you download data across regions over the Internet. For more information about the billing rules, see Download pricing (pay-as-you-go). Note The deployment mode and network connection mode of the Tunnel service in different regions of the Alibaba Cloud data center may be different. You cannot use the Tunnel service to access data of a MaxCompute project that resides in a region different from the region in which the Tunnel service is deployed.

Endpoints in different regions (Internet)

Note

HTTP and HTTPS endpoints are supported. HTTPS uses TLS v1.2 to establish a secure connection.

The Tunnel endpoints provided in the following table can be configured only for the tunnel endpoint parameter.

District	Region	MaxCompute available or not	Public endpoint	Public Tunnel endpoint

District	Region	MaxCompute available or not	Public endpoint	Public Tunnel endpoint
China	China (Hangzhou)	Yes	https://service.cn-hangzhou.maxcompute.aliyun.com/api	https://dt.cn-hangzhou.maxcompute.aliyun.com
China	China (Shanghai)	Yes	https://service.cn-shanghai.maxcompute.aliyun.com/api	https://dt.cn-shanghai.maxcompute.aliyun.com
China	China (Beijing)	Yes	https://service.cn-beijing.maxcompute.aliyun.com/api	https://dt.cn-beijing.maxcompute.aliyun.com
China	China (Ulanqab)	Yes	https://service.cn-wulanchabu.maxcompute.aliyun.com/api	https://dt.cn-wulanchabu.maxcompute.aliyun.com
China	China (Shenzhen)	Yes	https://service.cn-shenzhen.maxcompute.aliyun.com/api	https://dt.cn-shenzhen.maxcompute.aliyun.com
China	China (Hong Kong)	Yes	https://service.cn-hongkong.maxcompute.aliyun.com/api	https://dt.cn-hongkong.maxcompute.aliyun.com
Asia Pacific	Singapore	Yes	https://service.ap-southeast-1.maxcompute.aliyun.com/api	https://dt.ap-southeast-1.maxcompute.aliyun.com
Asia Pacific	Malaysia (Kuala Lumpur)	Yes	https://service.ap-southeast-3.maxcompute.aliyun.com/api	https://dt.ap-southeast-3.maxcompute.aliyun.com
Asia Pacific	Indonesia (Jakarta)	Yes	https://service.ap-southeast-5.maxcompute.aliyun.com/api	https://dt.ap-southeast-5.maxcompute.aliyun.com
Asia Pacific	Japan (Tokyo)	Yes	https://service.ap-northeast-1.maxcompute.aliyun.com/api	https://dt.ap-northeast-1.maxcompute.aliyun.com
Europe and Americas	Germany (Frankfurt)	Yes	https://service.eu-central-1.maxcompute.aliyun.com/api	https://dt.eu-central-1.maxcompute.aliyun.com
Europe and Americas	US (Silicon Valley)	Yes	https://service.us-west-1.maxcompute.aliyun.com/api	https://dt.us-west-1.maxcompute.aliyun.com
Europe and Americas	US (Virginia)	Yes	https://service.us-east-1.maxcompute.aliyun.com/api	https://dt.us-east-1.maxcompute.aliyun.com
Europe and Americas	UK (London)	Yes	https://service.eu-west-1.maxcompute.aliyun.com/api	https://dt.eu-west-1.maxcompute.aliyun.com
Middle East and India	UAE (Dubai)	Yes	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)	Yes	https://service.me-central-1.maxcompute.aliyun.com/api	https://dt.me-central-1.maxcompute.aliyun.com

Endpoints in different regions (VPC)

Note

HTTP and HTTPS endpoints are supported. HTTPS uses TLS v1.2 to establish a secure connection.

The Tunnel endpoints provided in the following table can be configured only for the tunnel endpoint parameter.

District	Region	MaxCompute available or not	VPC endpoint	VPC Tunnel endpoint

Endpoints in different regions (internal network for connecting cloud products)

Note

HTTP and HTTPS endpoints are supported. HTTPS uses TLS v1.2 to establish a secure connection.

The Tunnel endpoints provided in the following table can be configured only for the tunnel endpoint parameter.

District	Region	MaxCompute available or not	Classic network endpoint	Classic network Tunnel endpoint

Background information

Scenarios

Precautions

Network connection modes

Billing rules

Endpoints in different regions (Internet)

Endpoints in different regions (VPC)

Endpoints in different regions (internal network for connecting cloud products)

Sales Support

Technical Support

Connect & Report Abuse

About Alibaba Cloud

Our Global Network

Quick Start

Global Offices

Olympic Games Paris 2024 New

Stade Roland Garros – Glitz from the Past New

Place de la Concorde – “Breaking” the Barriers New

Vaires-sur-Marne Nautical Stadium – Sports with Sustainability New

International Broadcast Center – Images, Sounds, and Data that Captivate Billions New

Customer Success Stories New

Trust Center

Security & Compliance Center

Cloud Compliance Resources

Security Compliance FAQs

Product & Feature Update New

Cloud Forward

Press Room

Alibaba Cloud e-Magazine New

Alibaba Cloud in Analyst Research

Notice

Go Global Service New

Go Global Alliance with Alibaba Cloud

Asia Accelerator Hot

Information Compliance

China Gateway - MLPS 2.0 Compliance New

China Gateway - Networking

China Gateway - Global Application Acceleration New

China Gateway - Security

China Gateway - Data Security New

ICP Support Hot

China Gateway - Omnichannel Data Mid-End New

China Gateway - Organizational Data Mid-End New

China Gateway - Business Mid-End New

China Gateway - AI Service for Conversational Chatbots New

China Gateway - Online Education

China Gateway - Domain Registration

Work at Alibaba Cloud

Experienced Professionals

Students and Graduates

Free Trial

Pricing

Promo Center

Price Reduction

Pay Less and Deploy More

FinOps

Elastic Compute Service (ECS)

Simple Application Server (SAS)

Elastic GPU Service

Elastic Desktop Service (EDS)

Object Storage Service (OSS)

Cloud Enterprise Network (CEN)

Web Application Firewall (WAF)

Domain Names

Container Compute Service (ACS)

Secure Access Service Edge (SASE)

Intelligent Media Services(IMS)

Edge Security Acceleration (ESA)(Original DCDN)

Intelligent Media Management

DingTalk Enterprise

YiDA

Alibaba Cloud Model Studio

Apsara Prime - For Easy Cloud Product Selection

Alibaba Cloud ECS - Cater All Your Cloud Hosting Needs

1TB CDN—Get Free 1 TB Outbound Traffic Plan Now

Security—Under Attack? Get Free Security Support

Short Message Service - Free Testing is Available

Elastic Compute Service (ECS) Hot

CloudBox

Compute Nest

Dedicated Host Hot

ECS Bare Metal Instance

Elastic GPU Service Featured

Simple Application Server (SAS) Hot

Auto Scaling

Cloud Phone Beta

Elastic Desktop Service (EDS) Featured

Batch Compute

Elastic High Performance Computing (E-HPC)

Super Computing Cluster (SCC)

Function Compute (FC)