All Products
Search
Document Center

Cloud Parallel File Storage:Fileset management

Last Updated:Nov 24, 2025

A fileset is a partition within a file system that has an independent inode space and management capabilities. You can use a fileset as a workspace and set data policies and quotas for it.

Prerequisites

  • A CPFS for Lingjun file system has been created. For more information, see Create a file system.

  • You have been added to the whitelist for the fileset feature.

    Important

    The fileset feature is available only to whitelisted users. If you want to use this feature, you can submit a ticket to apply to be added to the whitelist.

Limits

Limitations

Description

File system

Only CPFS for Lingjun V2.7.0 and later support filesets.

Number of filesets that can be created in a single file system

By default, you can create 500 filesets.

If you require a higher quota, you can submit a ticket to request an increase. The quota can be increased to a maximum of 3,000.

Number of files or directories that can be created in a fileset

10 billion

Fileset

  • Nested filesets are not supported. If a parent directory is specified as a fileset, its subdirectories cannot be specified as filesets.

  • You cannot create hard links or perform rename operations across filesets.

Fileset path

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

  • The path must be a new path and cannot be an existing path. You cannot modify fileset paths.

  • If the fileset path is a multilayer directory, the parent directory must be an existing directory.

  • The maximum depth of a path is 8 layers. The root directory (/) is Layer 0. For example, if the fileset path is /workspace/dir1/, the path depth is 2.

  • The total length of the path cannot exceed 990 characters.

  • The name of a single-layer directory can be a maximum of 255 characters in length and can contain uppercase and lowercase letters, digits, underscores (_), periods (.), and hyphens (-).

Fileset deletion

You can delete filesets only in the console or by calling an API operation. If you delete a fileset, the storage space occupied by the fileset is not immediately released. The fileset is reclaimed after 24 hours.

If you want to immediately release the storage space, you can first clear the data in the fileset and then delete the fileset. Deleted data cannot be recovered. Proceed with caution.

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 where the destination file system is located.

    image

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

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

  6. On the Fileset tab, click Create Fileset.

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

    Parameter

    Description

    Fileset Path

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

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

    • The path must be a new path and cannot be an existing path.

    • If the fileset path is a multilayer directory, the parent directory must be an existing directory.

    • You cannot rename a fileset path. The path cannot be a symbolic link.

    • The maximum depth of a path is 8 layers.

    • The total length of the path cannot exceed 990 characters.

    • The name of a single-layer directory can be a maximum of 255 characters in length and can contain uppercase and lowercase letters, digits, underscores (_), periods (.), and hyphens (-).

    Fileset Name

    Specify a name for the fileset. The name must meet the following requirements:

    • The name must be 2 to 128 characters in length and can contain English and Chinese characters.

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

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

    (Optional) Deletion Protection

    Set the deletion protection feature for the fileset instance. After you enable deletion protection for a fileset instance, you cannot delete the fileset instance in the console or by calling an API operation. If you want to delete the fileset, you must disable the deletion protection feature.

Delete a fileset

Important
  • You can delete a fileset only in the console or by calling an API operation. If you delete a fileset, the storage space that is occupied by the fileset is not immediately released. The storage space is released after 24 hours. To immediately release the storage space, you can first clear the data in the fileset and then delete the fileset. Deleted data cannot be recovered. Proceed with caution.

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

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

  2. Review the details of the fileset that you want to delete and click Confirm Deletion.

Edit a fileset

You can modify the name of a fileset and configure the deletion protection feature.

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

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

View fileset capacity monitoring

You can view capacity monitoring data for a fileset only in the Cloud Monitor console or by calling Cloud Monitor API operations.

  • Use the Cloud Monitor console

    1. Log on to the Cloud Monitor console.

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

    3. On the Cloud Service Monitoring page, enter CPFS and click CPFS (Old version).

    4. On the CPFS (Old version) page, select a region, find the file system that you want to manage, and then click Monitoring Charts in the Actions column.

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

      You can also configure alert rules based on metrics to monitor the usage of capacity quotas or the number of files. When a metric for a capacity quota or the number of files reaches the specified alert threshold, Cloud Monitor automatically sends an alert notification. This lets you promptly identify and handle abnormal monitoring data. For more information, see Configure a basic alert rule.

      Metric

      Metric name

      Description

      BMCPFSFsetCapacityLimit

      Allocated capacity of a fileset

      The maximum storage space that can be used to write data to the fileset. After the quota is reached, you can no longer write data.

      BMCPFSFsetCapacityUsed

      Used capacity of a fileset

      The actual used capacity of the fileset.

      BMCPFSFsetInodeLimit

      Number of files allocated to a fileset

      The maximum number of files and directories that can be written to the fileset. After the quota is reached, you can no longer write data.

      BMCPFSFsetInodeUsed

      Number of files used by a fileset

      The actual number of files used by the fileset.

  • Use the Cloud Monitor API

    • DescribeMetricMetaList: Queries the descriptions of time-series metrics that are supported by Cloud Monitor.

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

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

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

    Name

    Description

    Namespace

    The namespace of the Alibaba Cloud service. The namespace of CPFS is acs_nas.

    MetricName

    The name of the metric. Valid values:

    • BMCPFSFsetCapacityLimit

    • BMCPFSFsetCapacityUsed

    • BMCPFSFsetInodeLimit

    • BMCPFSFsetInodeUsed

    Dimensions

    The dimension map that is used to query the monitoring data of a specified resource. Format:

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

    Note

    When you specify Dimensions, you must use a JSON string to represent the map object. The dimensions must be specified in order.