TagResources - Apsara File Storage NAS - Alibaba Cloud Documentation Center

Creates tags and binds the tags to file systems.

Debugging

There is currently no authorization information disclosed in the API.

Parameter	Type	Required	Description	Example
ResourceType	string	Yes	The resource type. Set the value to filesystem.	filesystem
ResourceId	array	Yes	The resource IDs. Valid values of N: 1 to 50.
	string	Yes	The ID of the file system. Sample ID of a General-purpose NAS file system: 31a8e4**. The IDs of Extreme NAS file systems must start with `extreme-`, for example, `extreme-0015`. The IDs of CPFS file systems must start with `cpfs-`, for example, `cpfs-125487`. Note** You can bind a tag to one or more file systems. You can specify up to 50 file system IDs. CPFS file systems are available only on the China site (aliyun.com).	31a8e4****
Tag	array<object>	Yes	The details about the tags.
	object	Yes
Key	string	Yes	The key of tag N to add to the resource. Limits: The tag key cannot be left empty. Valid values of N: 1 to 20. The tag key must be 1 to 128 characters in length. The tag key cannot start with `aliyun` or `acs:`. The tag key cannot contain `http://` or `https://`.	nastest
Value	string	Yes	The value of tag N to add to the resource. Limits: Valid values of N: 1 to 20. The tag value must be 1 to 128 characters in length. The tag value cannot start with `aliyun` or `acs:`. The tag value cannot contain `http://` or `https://`.	filetest

Parameter	Type	Description	Example
	object
RequestId	string	The request ID.	2D69A58F-345C-4FDE-88E4-BF518948****

Sample success responses

JSONformat

{
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****"
}

HTTP status code	Error code	Error message	Description
400	NumberExceed.ResourceIds	The maximum number of ResourceIds is exceeded. The maximum is 50.	The maximum number of resource ID is exceeded. The maximum is 50.
400	MissingParameter.ResourceIds	You must specify ResourceIds.	You must specify ResourceId.
400	Duplicate.ResourceId	The request contains duplicated ResourceId.	ResourceId cannot be duplicated.
400	NumberExceed.Tags	The maximum number of Tags is exceeded. The maximum is 20.	The maximum number of Tags is exceeded. The maximum is 20.
400	Duplicate.TagKey	The Tag.N.Key contains a duplicated key.	The specified TagKey is duplicated.
400	InvalidResourceId.NotFound	The ResourceId does not exist.	The specified ResourceId does not exist.
400	InvalidParameter.TagKey	The specified Tag.n.Key is invalid.	The specified TagKey is invalid.
400	InvalidParameter.TagValue	The specified Tag.n.Value is invalid.	The specified TagValue is invalid.
400	CustomTag.NumberExceed	The maximum number of system tags for each resource is 20.	The maximum number of user tags for each resource is 20.
403	OperationDenied.KeyValueNotNull	The key value cannot be null.	You must specify tag value.

For a list of error codes, visit the Service error codes.

Change time	Summary of changes	Operation
2024-09-05	API Description Update. The Error code has changed	View Change Details