All Products
Search

This Product

    MaxCompute:Endpoints

    Document Center

    MaxCompute:Endpoints

    Last Updated:Nov 28, 2023

    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 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.

      MaxCompute also supports external tables. After you create an external table, you can use MaxCompute to read data from Object Storage Service (OSS), Tablestore, Hologres, ApsaraDB for HBase, or ApsaraDB RDS. For more information, see OSS external tables, Create a Tablestore external table, and Hologres external tables.

    • Tunnel service: The connection address is a Tunnel endpoint, which varies based on the region and network connection mode that you select. The Tunnel 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 (classic network), and Endpoints in different regions (VPC).

    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

    Precautions

    Before you use the Tunnel 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 (classic network).

    • 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 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.

    Network connection modes

    You can access the MaxCompute service and Tunnel service in the following network connection modes:

    • Internet

    • Classic network

    • VPC

    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 classic network or VPC 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 classic network or VPC, connectivity issues may occur.

    Billing rules

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

    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 service to upload data.

    When you use the Tunnel 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. If you want to encrypt requests, use HTTPS endpoints.

    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

    China

    China (Hangzhou)

    Yes

    http://service.cn-hangzhou.maxcompute.aliyun.com/api

    http://dt.cn-hangzhou.maxcompute.aliyun.com

    China

    China (Shanghai)

    Yes

    http://service.cn-shanghai.maxcompute.aliyun.com/api

    http://dt.cn-shanghai.maxcompute.aliyun.com

    China

    China (Beijing)

    Yes

    http://service.cn-beijing.maxcompute.aliyun.com/api

    http://dt.cn-beijing.maxcompute.aliyun.com

    China

    China (Shenzhen)

    Yes

    http://service.cn-shenzhen.maxcompute.aliyun.com/api

    http://dt.cn-shenzhen.maxcompute.aliyun.com

    China

    China (Hong Kong)

    Yes

    http://service.cn-hongkong.maxcompute.aliyun.com/api

    http://dt.cn-hongkong.maxcompute.aliyun.com

    Asia Pacific

    Singapore

    Yes

    http://service.ap-southeast-1.maxcompute.aliyun.com/api

    http://dt.ap-southeast-1.maxcompute.aliyun.com

    Asia Pacific

    Australia (Sydney)

    Yes

    http://service.ap-southeast-2.maxcompute.aliyun.com/api

    http://dt.ap-southeast-2.maxcompute.aliyun.com

    Asia Pacific

    Malaysia (Kuala Lumpur)

    Yes

    http://service.ap-southeast-3.maxcompute.aliyun.com/api

    http://dt.ap-southeast-3.maxcompute.aliyun.com

    Asia Pacific

    Indonesia (Jakarta)

    Yes

    http://service.ap-southeast-5.maxcompute.aliyun.com/api

    http://dt.ap-southeast-5.maxcompute.aliyun.com

    Asia Pacific

    Japan (Tokyo)

    Yes

    http://service.ap-northeast-1.maxcompute.aliyun.com/api

    http://dt.ap-northeast-1.maxcompute.aliyun.com

    Europe and Americas

    Germany (Frankfurt)

    Yes

    http://service.eu-central-1.maxcompute.aliyun.com/api

    http://dt.eu-central-1.maxcompute.aliyun.com

    Europe and Americas

    US (Silicon Valley)

    Yes

    http://service.us-west-1.maxcompute.aliyun.com/api

    http://dt.us-west-1.maxcompute.aliyun.com

    Europe and Americas

    US (Virginia)

    Yes

    http://service.us-east-1.maxcompute.aliyun.com/api

    http://dt.us-east-1.maxcompute.aliyun.com

    Europe and Americas

    UK (London)

    Yes

    http://service.eu-west-1.maxcompute.aliyun.com/api

    http://dt.eu-west-1.maxcompute.aliyun.com

    Middle East and India

    India (Mumbai)

    Yes

    http://service.ap-south-1.maxcompute.aliyun.com/api

    http://dt.ap-south-1.maxcompute.aliyun.com

    Middle East and India

    UAE (Dubai)

    Yes

    http://service.me-east-1.maxcompute.aliyun.com/api

    http://dt.me-east-1.maxcompute.aliyun.com

    Endpoints in different regions (classic network)

    Note

    HTTP and HTTPS endpoints are supported. If you want to encrypt requests, use HTTPS endpoints.

    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

    China

    China (Hangzhou)

    Yes

    http://service.cn-hangzhou.maxcompute.aliyun-inc.com/api

    http://dt.cn-hangzhou.maxcompute.aliyun-inc.com

    China

    China (Shanghai)

    Yes

    http://service.cn-shanghai.maxcompute.aliyun-inc.com/api

    http://dt.cn-shanghai.maxcompute.aliyun-inc.com

    China

    China (Beijing)

    Yes

    http://service.cn-beijing.maxcompute.aliyun-inc.com/api

    http://dt.cn-beijing.maxcompute.aliyun-inc.com

    China

    China (Shenzhen)

    Yes

    http://service.cn-shenzhen.maxcompute.aliyun-inc.com/api

    http://dt.cn-shenzhen.maxcompute.aliyun-inc.com

    China

    China (Hong Kong)

    Yes

    http://service.cn-hongkong.maxcompute.aliyun-inc.com/api

    http://dt.cn-hongkong.maxcompute.aliyun-inc.com

    Asia Pacific

    Singapore

    Yes

    http://service.ap-southeast-1.maxcompute.aliyun-inc.com/api

    http://dt.ap-southeast-1.maxcompute.aliyun-inc.com

    Asia Pacific

    Australia (Sydney)

    Yes

    http://service.ap-southeast-2.maxcompute.aliyun-inc.com/api

    http://dt.ap-southeast-2.maxcompute.aliyun-inc.com

    Asia Pacific

    Malaysia (Kuala Lumpur)

    Yes

    http://service.ap-southeast-3.maxcompute.aliyun-inc.com/api

    http://dt.ap-southeast-3.maxcompute.aliyun-inc.com

    Asia Pacific

    Indonesia (Jakarta)

    Yes

    http://service.ap-southeast-5.maxcompute.aliyun-inc.com/api

    http://dt.ap-southeast-5.maxcompute.aliyun-inc.com

    Asia Pacific

    Japan (Tokyo)

    Yes

    http://service.ap-northeast-1.maxcompute.aliyun-inc.com/api

    http://dt.ap-northeast-1.maxcompute.aliyun-inc.com

    Europe and Americas

    Germany (Frankfurt)

    Yes

    http://service.eu-central-1.maxcompute.aliyun-inc.com/api

    http://dt.eu-central-1.maxcompute.aliyun-inc.com

    Europe and Americas

    US (Silicon Valley)

    Yes

    http://service.us-west-1.maxcompute.aliyun-inc.com/api

    http://dt.us-west-1.maxcompute.aliyun-inc.com

    Europe and Americas

    US (Virginia)

    Yes

    http://service.us-east-1.maxcompute.aliyun-inc.com/api

    http://dt.us-east-1.maxcompute.aliyun-inc.com

    Europe and Americas

    UK (London)

    Yes

    http://service.eu-west-1.maxcompute.aliyun-inc.com/api

    http://dt.eu-west-1.maxcompute.aliyun-inc.com

    Middle East and India

    India (Mumbai)

    Yes

    http://service.ap-south-1.maxcompute.aliyun-inc.com/api

    http://dt.ap-south-1.maxcompute.aliyun-inc.com

    Middle East and India

    UAE (Dubai)

    Yes

    http://service.me-east-1.maxcompute.aliyun-inc.com/api

    http://dt.me-east-1.maxcompute.aliyun-inc.com

    Endpoints in different regions (VPC)

    Note

    HTTP and HTTPS endpoints are supported. If you want to encrypt requests, use HTTPS endpoints.

    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

    China

    China (Hangzhou)

    Yes

    http://service.cn-hangzhou.maxcompute.aliyun-inc.com/api

    http://dt.cn-hangzhou.maxcompute.aliyun-inc.com

    China

    China East 2 Finance

    Yes

    http://service.cn-shanghai-finance-1.maxcompute.aliyun-inc.com/api

    http://dt.cn-shanghai-finance-1.maxcompute.aliyun-inc.com

    China

    China (Beijing)

    Yes

    http://service.cn-beijing.maxcompute.aliyun-inc.com/api

    http://dt.cn-beijing.maxcompute.aliyun-inc.com

    China

    China (Shenzhen)

    Yes

    http://service.cn-shenzhen.maxcompute.aliyun-inc.com/api

    http://dt.cn-shenzhen.maxcompute.aliyun-inc.com

    China

    China (Hong Kong)

    Yes

    http://service.cn-hongkong.maxcompute.aliyun-inc.com/api

    http://dt.cn-hongkong.maxcompute.aliyun-inc.com

    Asia Pacific

    Singapore

    Yes

    http://service.ap-southeast-1.maxcompute.aliyun-inc.com/api

    http://dt.ap-southeast-1.maxcompute.aliyun-inc.com

    Asia Pacific

    Australia (Sydney)

    Yes

    http://service.ap-southeast-2.maxcompute.aliyun-inc.com/api

    http://dt.ap-southeast-2.maxcompute.aliyun-inc.com

    Asia Pacific

    Malaysia (Kuala Lumpur)

    Yes

    http://service.ap-southeast-3.maxcompute.aliyun-inc.com/api

    http://dt.ap-southeast-3.maxcompute.aliyun-inc.com

    Asia Pacific

    Indonesia (Jakarta)

    Yes

    http://service.ap-southeast-5.maxcompute.aliyun-inc.com/api

    http://dt.ap-southeast-5.maxcompute.aliyun-inc.com

    Asia Pacific

    Japan (Tokyo)

    Yes

    http://service.ap-northeast-1.maxcompute.aliyun-inc.com/api

    http://dt.ap-northeast-1.maxcompute.aliyun-inc.com

    Europe and Americas

    Germany (Frankfurt)

    Yes

    http://service.eu-central-1.maxcompute.aliyun-inc.com/api

    http://dt.eu-central-1.maxcompute.aliyun-inc.com

    Europe and Americas

    US (Silicon Valley)

    Yes

    http://service.us-west-1.maxcompute.aliyun-inc.com/api

    http://dt.us-west-1.maxcompute.aliyun-inc.com

    Europe and Americas

    US (Virginia)

    Yes

    http://service.us-east-1.maxcompute.aliyun-inc.com/api

    http://dt.us-east-1.maxcompute.aliyun-inc.com

    Europe and Americas

    UK (London)

    Yes

    http://service.eu-west-1.maxcompute.aliyun-inc.com/api

    http://dt.eu-west-1.maxcompute.aliyun-inc.com

    Middle East and India

    India (Mumbai)

    Yes

    http://service.ap-south-1.maxcompute.aliyun-inc.com/api

    http://dt.ap-south-1.maxcompute.aliyun-inc.com

    Middle East and India

    UAE (Dubai)

    Yes

    http://service.me-east-1.maxcompute.aliyun-inc.com/api

    http://dt.me-east-1.maxcompute.aliyun-inc.com