MaxCompute:Endpoint

Choose an endpoint

Two factors determine which endpoint to use: the region of your MaxCompute project and your network connectivity type.

Region: Always use an endpoint in the same region as your MaxCompute project. Cross-region access is not supported.

Network type:

• Client running on Alibaba Cloud (for example, on an Elastic Compute Service (ECS) instance) — use a VPC endpoint. VPC connections are more secure and stable.

• Client running outside Alibaba Cloud (for example, on an office computer) — use a public endpoint. If public network access is not enabled for your VPC, use a VPC endpoint instead.

• Alibaba Cloud product connecting to MaxCompute (for example, Quick BI) — use an endpoint for interconnected cloud products.

MaxCompute endpoints support both the HTTP and HTTPS protocols.

URL patterns

All MaxCompute endpoints follow a consistent URL pattern. Once you know your region ID, you can derive the endpoint directly:

For example, for China (Hangzhou), the region ID is cn-hangzhou, and the public endpoint is https://service.cn-hangzhou.maxcompute.aliyun.com/api.

Configure only the service endpoint. MaxCompute automatically resolves the corresponding Tunnel endpoint for data transmission.

Exception: Mexico (region ID na-south-1) uses -vpc instead of -intranet for the interconnected service endpoint. See the interconnected endpoints table below for the exact URL.

Public endpoints

Use a public endpoint if your client is outside Alibaba Cloud.

VPC endpoints

Use a VPC endpoint if your client is on Alibaba Cloud (for example, on an ECS instance).

View endpoints in the console

The MaxCompute console displays endpoint information for the following China regions: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), and China (Chengdu).

1. Log on to the MaxCompute console and select a region in the top-left corner.

2. In the left navigation pane, choose Manage Configurations > Endpoint Management.

Configure your client

After you identify the correct endpoint, configure it in your tool or SDK.

MaxCompute client (odpscmd)

Set the endpoint in odps_config.ini:

project_name=<your_project_name>
access_id=<your_access_key_id>
access_key=<your_access_key_secret>
end_point=https://service.cn-hangzhou.maxcompute.aliyun.com/api

Replace the endpoint value with the endpoint for your region and network type.

For full setup instructions, see Install and configure the MaxCompute client.

Other tools and SDKs

• MaxCompute Studio: Manage project connections

• DataWorks: Configure a MaxCompute data source

• Java SDK: Java SDK introduction

• Python SDK: Python SDK example: SQL

• Java Database Connectivity (JDBC): JDBC introduction

• SQLTask with Tunnel service: Export data using SQLTask with Tunnel

For background on Alibaba Cloud regions and zones, see Regions and zones.