All Products
Search
Document Center

Cloud Parallel File Storage:Fileset management

Last Updated:Apr 16, 2026

A fileset is an independent namespace partition within a CPFS file system, with its own inode space and management capabilities. Use filesets as isolated workspaces to enforce data policies and quotas.

Prerequisites

Limitations

Limitation

Description

File system

Filesets are supported only in CPFS for Lingjun 2.7.0 and later.

Number of filesets per file system

Default: 500.

To increase the quota (up to 3,000), submit a ticket.

Number of files or directories per fileset

10 billion

Fileset

  • Nested filesets are not supported. A subdirectory of an existing fileset cannot be designated as another fileset.

  • Cross-fileset hard links and rename operations are not supported.

Fileset path

  • The path must start and end with a forward slash (/).

  • The path must not already exist. The path of a fileset cannot be modified.

  • If the fileset path contains multiple directory levels, the parent directory must already exist.

  • The maximum path depth is 8 levels. The root directory (/) is considered level 0. For example, the path /workspace/dir1/ has a depth of 2.

  • The total path length cannot exceed 990 characters.

  • The name of a single directory in the path can be up to 255 characters long and can contain uppercase and lowercase letters, digits, underscores (_), periods (.), and hyphens (-).

Fileset deletion

Filesets can be deleted only from the console or by calling an API operation. Deletion does not immediately release storage space. The space is reclaimed within 24 hours.

To release the storage space immediately, clear all data in the fileset before deleting it. Deleted data cannot be recovered.

Create a fileset

  1. Log on to the NAS console.

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

  3. In the upper-left corner of the page, select the resource group and region of the file system.

    image

  4. On the File System List page, click the name of the file system.

  5. On the details page of the file system, click the Fileset tab.

  6. On the Fileset tab, click Create Fileset.

  7. In the Create Fileset dialog box, enter the fileset path and name, and then click OK.

    Parameter

    Description

    Fileset Path

    The absolute path of the fileset in the file system. The path must meet the following requirements:

    • The path must start and end with a forward slash (/).

    • The path must not already exist.

    • If the path contains multiple directory levels, the parent directory must exist.

    • The fileset path cannot be renamed. The path cannot be a symbolic link.

    • The maximum path depth is 8 levels.

    • The total path length cannot exceed 990 characters.

    • The name of a single directory in the path can be up to 255 characters long and can contain uppercase and lowercase letters, digits, underscores (_), periods (.), and hyphens (-).

    Fileset Name

    The name of the fileset. Naming rules:

    • The name must be 2 to 128 characters in length.

    • The name must start with a letter or a Chinese character. It cannot start with http:// or https://.

    • The name can contain digits, colons (:), underscores (_), and hyphens (-).

    (Optional) Deletion Protection

    Enables or disables deletion protection for the fileset. When deletion protection is enabled, the fileset cannot be deleted from the console or by calling an API operation. Disable deletion protection before deleting the fileset.

Delete a fileset

Important
  • Filesets can be deleted only from the console or by calling an API operation. Deletion does not immediately release storage space. The space is reclaimed within 24 hours. To release the space immediately, clear all data from the fileset before deletion. This action is irreversible.

  • If deletion protection is enabled for the fileset, you must disable it before you can delete the fileset.

  1. On the Fileset tab, find the fileset that you want to delete and click Delete in the Actions column.

  2. In the dialog box that appears, confirm the information about the fileset to be deleted and click Confirm Deletion.

Edit a fileset

Modify the name of a fileset or configure deletion protection.

  1. On the Fileset tab, find the fileset that you want to edit and click Edit in the Actions column.

  2. In the dialog box that appears, modify the fileset name or configure deletion protection.

Fileset capacity monitoring

Fileset capacity monitoring data is available only through the CloudMonitor console or CloudMonitor API operations.

  • Use the CloudMonitor console

    1. Log on to the CloudMonitor console.

    2. In the left-side navigation pane, choose Cloud Resource Monitoring > Cloud Service Monitoring.

    3. On the Cloud Service Monitoring page, enter CPFS and click File Storage CPFS.

    4. On the File Storage CPFS page, select a region, find the target file system, and then click Monitoring Charts in the Actions column.

    5. On the Monitoring Charts page, click the File System Monitoring tab to view the monitoring details of the file system.

      Alert rules can also be configured based on monitoring metrics to track capacity usage or file counts. When a metric reaches the specified threshold, CloudMonitor automatically sends alert notifications for timely response to anomalies. For more information, see Configure a basic alert rule.

      Metric

      Metric name

      Description

      BMCPFSFsetCapacityLimit

      Allocated capacity of a fileset

      The maximum storage capacity allocated to the fileset. No new data can be written after this quota is reached.

      BMCPFSFsetCapacityUsed

      Used capacity of a fileset

      The actual storage capacity used by the fileset.

      BMCPFSFsetInodeLimit

      Number of files allocated to a fileset

      The maximum number of files and directories that the fileset can contain. No new data can be written after this quota is reached.

      BMCPFSFsetInodeUsed

      Number of files used by a fileset

      The actual number of files and directories used by the fileset.

  • Use the CloudMonitor API

    • DescribeMetricMetaList: Queries the descriptions of time-series metrics that are available in CloudMonitor.

    • DescribeMetricList: Queries the monitoring data of a time-series metric for an Alibaba Cloud service within a specified time period.

    • DescribeMetricLast: Queries the latest monitoring data of a specified object.

    The following table lists the request parameters for CPFS for Lingjun.

    Parameter

    Description

    Namespace

    The data namespace of the cloud service. Set this parameter to acs_nas for CPFS.

    MetricName

    The name of the metric. Valid values:

    • BMCPFSFsetCapacityLimit

    • BMCPFSFsetCapacityUsed

    • BMCPFSFsetInodeLimit

    • BMCPFSFsetInodeUsed

    Dimensions

    A dimension map used to query the monitoring data of a specific resource. Format:

    {"userId":"xxxxxx","fileSystemId":"bmcpfs-xxxxx"}.

    Note

    The Dimensions parameter must be a JSON string representation of the map object. The dimensions must be specified in order.