You need to enable JavaScript to run this app.
File Storage vePFS

File Storage vePFS

Copy page
Download PDF
Tags
TagResources - Bind tags
Copy page
Download PDF
TagResources - Bind tags
Call the TagResources API to bind tags to vePFS-related resources.​
Notice​
Refer to the detailed tag configuration guidelines in Tagging rules.​
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.
​
Request parameters​
The following lists only the specific request parameters for this interface and some public parameters. For more information, see public parameters.​
Action string required Example value: TagResources​
The operation to be performed: TagResources.​
​
Version string required Example value: 2022-01-01​
API version: 2022-01-01.​
​
ResourceType string required Example value: filesystem​
The types of resources that require tag binding are described as follows:​
filesystem: vePFS file system.​
​
ResourceIds string[] required Example: ["vepfs-cn0212gzmh2xs****","vepfs-cn0212gz1h2xs****"]​
Specify the list of resources to bind. You can pass up to 20 file system IDs at a time, separated by commas (,).​
tip​
You can use the DescribeFileSystems - query file systems API to view basic information about all file systems in the target region, including file system IDs.​
​
Tags object[] required Example value: "Tags": [ { "Value": "value", "Key": "key" }, { "Value": "value1", "Key": "key1" } ]​
List of tags to be bound to the resource. You can add up to 20 tag key-value pairs at a time. Detailed descriptions of the options are as follows.​
Key string optional Example value: key​
Tag key value details are as follows:​
  • Valid characters include: Unicode letters (e.g., Chinese characters and English letters), numbers, spaces, and special characters such as _.:/=+-@.​
  • Length: 1–128 characters.​
  • Case sensitivity: Type and type are considered two different tag keys.​
  • Tag key must be unique.​
  • volc: is a reserved tag key. When adding tags, do not use any case variant of volc: as the start of a tag key.​
​
Value string Optional Example: value​
Description of tag value options:​
  • Supports any language letters or characters (such as Chinese, English letters, etc.), numbers, spaces, and the following special characters: _.:/=+-@.​
  • Case sensitivity: Extreme and extreme are considered two different tag values.​
  • Length: 0-256 characters. The tag value can be empty.​
​
​
​
​
Response parameters​
This interface has no specific response parameters. For more information, see Response structure.​
Sample request​
​
POST /?Action=TagResources&Version=2022-01-01 HTTP/1.1​
Host: open.volcengineapi.com​
Authorization: HMAC-SHA256 Credential=AKLTOGJhY2E1NTdkZGFmNDg0Yjk0ZDFiNjE5Y2NjZjI****/20230907/cn-beijing/vepfs/request, SignedHeaders=host;x-date;x-content-sha256;content-type, Signature=7f1119a75111535b1d6e7929700f22e1474af0fb4fe26c59f5ac5cdba0cc****​
Content-Type: application/json; charset=utf-8​
X-Content-Sha256: 567112abe45bd6a09504fd244237f14c0ba120491da0d35097afd54d87bd****​
X-Date: 20230907T124910Z​
{​
"ResourceType": "filesystem",​
"ResourceIds": [​
"vepfs-cn0212gzmh2xs****",​
"vepfs-cn0212gz1h2xs****"​
],​
"Tags": [​
{​
"Value": "value",​
"Key": "key"​
},​
{​
"Value": "value1",​
"Key": "key1"​
}​
]​
}​
​
Sample response​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420010010023228002****",​
"Action": "TagResources",​
"Version": "2022-01-01",​
"Service": "vepfs",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
Error Code​
You can visit Public Error Codes to get more information about error codes.​
Last updated: 2026.03.03 10:36:48