All Products
Search

This Product

    Cloud Parallel File Storage:Manage VPC mount points

    Document Center

    Cloud Parallel File Storage:Manage VPC mount points

    Last Updated:Jul 29, 2026

    A VPC mount point is the connection point that a CPFS for Lingjun file system exposes within a VPC network. Its domain name has the format cpfs-***-vpc-***.<Region>.cpfs.aliyuncs.com. This topic describes how to create, view, manage, and delete a VPC mount point.

    Note

    Prerequisites

    • You have created a CPFS for Lingjun file system (version 2.5.0 or later; you can check the version on the Basic Information page of the file system).

    • You have created a VPC and vSwitch that are in the same region and VPC as the CPFS file system. For more information, see Create a VPC and vSwitch.

    • VPC consistency requirement: The VPC that the VPC mount point belongs to must be the same VPC as the target client (K8s cluster / ECS / ACS). If you need cross-VPC access, connect the VPCs through Express Connect, Cloud Enterprise Network (CEN), or VPC Peering.

    Create a VPC mount point

    1. Log on to the CPFS console.

    2. In the left-side navigation pane, choose File System > File System List.

    3. In the top menu bar, select a region.

    4. In the Actions column for the target file system, click Add Mount Target.

    5. In the Add Mount Target dialog box, configure the following parameters:

      Parameter

      Description

      VPC

      Select the VPC where your compute resources are located. It must be in the same region as the CPFS file system.

      vSwitch

      Select the vSwitch where your compute resources are located.

      Permission group

      Select an existing permission group to control access permissions. If you have not created one, first see Create a permission group.

    6. Click OK. After the mount target is created, its domain name has the format cpfs-***-vpc-***.<Region>.cpfs.aliyuncs.com.

      Record the mount target domain name. You will use it for:

      • ACK scenario: Enter it in the PV's csi.volumeAttributes.vpcMountTarget field.

      • ACS scenario (VPC network): Enter it in the PV's csi.volumeAttributes.server field.

      • ECS/EGS scenario: Enter it as the mount source in the mount command.

    View the mount target domain name

    1. In the file system list, click the name of the target file system.

    2. Click the Mount Targets tab.

    3. In the Mount Target column of the mount target list, hover over image to view and copy the mount target domain name.

    View the list of mounted clients

    Use this to troubleshoot mount issues, or to check which compute resources are currently using this mount target.

    Currently, only PAI general-purpose computing resources that have used the CPFS for Lingjun file system within the last minute are shown. Some resources that are mounted but not actively in use may not appear in this list.

    1. Log on to CPFS console.

    2. In the left-side navigation pane, choose File Systems > File System List.

    3. Click the target file system to go to its details page.

    4. Click the Mount Targets tab.

    5. In the Actions column of the mount target list, click Client List.

    6. View the IP addresses of the compute resources that have mounted this file system.

    Delete a mount target

    After a mount target is deleted, it cannot be recovered. Proceed with caution. Before deleting it, make sure no tasks or instances are using the mount target; otherwise, access will fail.

    1. In the Actions column of the mount target list, click Delete.

    2. In the confirmation dialog box, click OK.

    Next steps

    After configuring the VPC mount point, continue configuring storage mounting based on the platform you use: