PrivateLink lets you establish secure and stable private connections between a virtual private cloud (VPC) and Alibaba Cloud services, which simplifies the network architecture. Accessing OSS over a private network using PrivateLink helps you avoid the potential security risks of public network access. This topic describes how to use an endpoint to privately access MaxCompute resources.
Regions
Usage | Region |
Direct access | China (Hangzhou) |
China (Shanghai) | |
China (Beijing) | |
China (Zhangjiakou) | |
China (Ulanqab) | |
China (Shenzhen) | |
China (Chengdu) | |
China (Hong Kong) | |
Ticket required | Singapore |
Malaysia (Kuala Lumpur) | |
Indonesia (Jakarta) | |
Japan (Tokyo) | |
Frankfurt | |
Silicon Valley | |
Virginia |
Billing
There is no charge for activating PrivateLink. After you activate the service, you are charged on an hourly pay-as-you-go basis. The fees include instance fees and data transfer fees. For more information, see PrivateLink billing.
PrivateLink uses a service consumer-pays model. For more information, see PrivateLink billing.
For dedicated services, the service consumer is also responsible for the service fees.
Components
PrivateLink involves components related to two main entities: the service consumer and the service provider.
Entity | Related components |
Service consumer |
|
Service provider |
|
For more information, see What is PrivateLink.
Procedure
Step 1: Create endpoints
Create a virtual private cloud (VPC) and a vSwitch. For more information, see Virtual Private Cloud and vSwitches.
Create the frontend interface endpoint. The endpoint, VPC, and vSwitch must be in the same region.
Log on to the Virtual Private Cloud (VPC) console.
In the navigation pane on the left, click Endpoints. In the upper-left corner, select a region.
This example uses China (Shenzhen).
On the Endpoints page, select the Interface Endpoint tab.
Click Create Endpoint. If this is your first time accessing the service, click Enable PrivateLink first.
On the Create Endpoint page, configure the parameters as follows. Keep the default configurations for other parameters.
Parameter
Description
Endpoint Name
Enter a custom name for the endpoint.
Endpoint Type
Select Interface Endpoint. This indicates that the service consumer accesses the service from the service provider through an interface endpoint.
Endpoint Service
In this example, select Alibaba Cloud Service, enter
com.aliyuncs.privatelink.cn-shenzhen.maxcompute.frontendin the Endpoint Service Name search box, and select the endpoint service.An endpoint can be associated with only one endpoint service.
VPC
Select the VPC where you want to create the endpoint.
Security Groups
Select a security group to associate with the endpoint ENI. The security group controls data communication for the endpoint ENI.
Zone and vSwitch
Select the zone that corresponds to the endpoint service, and then select a vSwitch in that zone. The system automatically creates an endpoint ENI in each vSwitch.
Create the tunnel-associated endpoint.
On the Endpoints page, select the Interface Endpoint tab.
Click the Create Endpoint button.
On the Create Endpoint page, configure the parameters as follows. Keep the default configurations for other parameters.
Parameter
Description
Endpoint Name
Enter a custom name for the endpoint.
Endpoint Type
Select Interface Endpoint, which indicates that the service consumer accesses the service from the service provider through an interface endpoint.
Endpoint Service
In this example, select Alibaba Cloud Service, enter
com.aliyuncs.privatelink.cn-shenzhen.maxcompute.tunnel.sharein the Endpoint Service Name search box, and select the endpoint service.An endpoint can be associated with only one endpoint service.
VPC
Select the VPC where you want to create the endpoint.
Security Groups
Select a security group to associate with the endpoint ENI. The security group controls data communication for the endpoint ENI.
Zone and vSwitch
Select the zone that corresponds to the endpoint service, and then select a vSwitch in that zone. The system automatically creates an endpoint ENI in each vSwitch.
The two endpoints are interdependent. You must enable both at the same time. Otherwise, connectivity may fail.
Step 2: Enable domain name access
Log on to the Virtual Private Cloud (VPC) console.
In the navigation pane on the left, click Endpoints. In the upper-left corner, select a region.
On the Endpoints page, click the name of the target endpoint.
In this example, select the frontend node.
On the endpoint details page, click the Basic Information tab.
In the Domain Name of Endpoint Service section, turn on the Custom Domain Name switch.
Domain names by region
Region | City | Status | MaxCompute Endpoint | Tunnel Endpoint |
China | China (Hangzhou) | Launched | http://service-pvl.cn-hangzhou-vpc.maxcompute.aliyun-inc.com/api | http://dt-pvl.cn-hangzhou-vpc.maxcompute.aliyun-inc.com |
China | China (Shanghai) | Launched | http://service-pvl.cn-shanghai-vpc.maxcompute.aliyun-inc.com/api | http://dt-pvl.cn-shanghai-vpc.maxcompute.aliyun-inc.com |
China | China (Beijing) | Launched | http://service-pvl.cn-beijing-vpc.maxcompute.aliyun-inc.com/api | http://dt-pvl.cn-beijing-vpc.maxcompute.aliyun-inc.com |
China | China (Zhangjiakou) | Launched | http://service-pvl.cn-zhangjiakou-vpc.maxcompute.aliyun-inc.com/api | http://dt-pvl.cn-zhangjiakou-vpc.maxcompute.aliyun-inc.com |
China | China (Ulanqab) | Launched | http://service-pvl.cn-wulanchabu-vpc.maxcompute.aliyun-inc.com/api | http://dt-pvl.cn-wulanchabu-vpc.maxcompute.aliyun-inc.com |
China | China (Shenzhen) | Launched | http://service-pvl.cn-shenzhen-vpc.maxcompute.aliyun-inc.com/api | http://dt-pvl.cn-shenzhen-vpc.maxcompute.aliyun-inc.com |
China | China (Chengdu) | Launched | http://service-pvl.cn-chengdu-vpc.maxcompute.aliyun-inc.com/api | http://dt-pvl.cn-chengdu-vpc.maxcompute.aliyun-inc.com |
China | Hong Kong | Launched | http://service-pvl.cn-hongkong-vpc.maxcompute.aliyun-inc.com/api | http://dt-pvl.cn-hongkong-vpc.maxcompute.aliyun-inc.com |
Step 3: Usage
Download and install the MaxCompute client (odpscmd).
Configure the odps_config.ini file. For detailed steps and parameter descriptions, see Connect using a local client (odpscmd). The following figure shows an example:
end_point:
http://service-pvl.cn-shenzhen-vpc.maxcompute.aliyun-inc.com/apitunnel_endpoint:
http://dt-pvl.cn-shenzhen-vpc.maxcompute.aliyun-inc.com

The following figure shows a successful connection:
