Docs

File Storage vePFS

Fileset

CreateFileset - Create a fileset

Call the CreateFileset API to create a Fileset.

Debug

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Only the unique request parameters for this API and some common parameters are listed below. For more information, see Common Parameters.

Action string required Example value: CreateFileset

Action to perform. Valid value: CreateFileset.

Version string required Example: 2022-01-01

API version: 2022-01-01.

FilesetName string required Example: fileset1

Fileset naming rules:

Start with English letters or Chinese characters.

The permission group name can only contain Chinese characters, letters, numbers, periods (.), underscores (_), or hyphens (-).

Length must be between 1 and 128 characters.

FilesetPath string required Example value: /fileset1/

The path for the fileset in the vePFS file system. Constraints are as follows:

Must be an absolute path in the file system, which starts and ends with a forward slash (/).

The path format should be /<parent directory>/<subdirectory>/, where:

The parent directory must be an existing directory.

The subdirectory is the directory name that needs to be created during this Fileset setup. It corresponds to the Fileset and is automatically created by the system.

Directory example: /dir/Filesetdir/.

The path cannot exceed 8 directory levels.

Be between 1 and 255 characters long.

FileSystemId string required Example value: vepfs-cnbj532c51d8****

File System ID.

Response parameters

Only the unique response parameters for this API are listed below. For more information, see Response Structure.

FilesetId string Example value: fset-413b****

Fileset ID created.

Sample request

POST /?Action=CreateFileset&Version=2022-01-01 HTTP/1.1​
Host: https://api.volcengine.com/api-explorer/?action=DescribeMountServices&groupName=%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F&serviceCode=vepfs&version=2022-01-01​
Content-Type: application/json; charset=UTF-8​
X-Date: 20250728T082112Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250728/cn-beijing/vepfs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "FilesetName": "fileset1",​
  "FilesetPath": "/fileset1/",​
  "FileSystemId": "vepfs-cnbj532c51d8****"​
}​

Return example

{​
  "ResponseMetadata": {​
    "RequestId": "202507281621160160672320355C****",​
    "Action": "CreateFileset",​
    "Version": "2022-01-01",​
    "Service": "vepfs",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "FilesetId": "fset-413b****"​
  }​
}​

Error codes

You can visit the public error codes to get more information about error codes.

Last updated: 2026.03.03 10:36:48