UntagResources - File Storage NAS - Alibaba Cloud Documentation Center

Removes tags from a file system.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
nas:UntagResources	delete	All Resources *	none	none

Request parameters

Parameter	Type	Required	Description	Example
ResourceType	string	Yes	The resource type. Set the value to filesystem.	filesystem
All	boolean	No	Specifies whether to remove all tags from the file system. This parameter is valid only if the TagKey.N parameter is not specified. Valid values: true: All tags are removed from the file system. If the file system does not have tags, a success message is returned. false (default): No tags are removed from the file system and a success message is returned.	false
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 Cloud Parallel File Storage (CPFS) file systems must start with gcpfs-g, for example, cpfs-125487. Note** CPFS file systems are available only on the China site (aliyun.com).	31a8e4****
TagKey	array	No	The tag keys of the resources. Valid values of N: 1 to 20.
	string	No	The tag key of the file system.	test

Response parameters

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

Examples

Sample success responses

JSONformat

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

Error codes

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	Duplicate.ResourceId	The request contains duplicated ResourceId.	ResourceId cannot be duplicated.
400	MissingParameter.ResourceIds	You must specify ResourceIds.	You must specify ResourceId.
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	Duplicate.TagKey	The Tag.N.Key contains a duplicated key.	The specified TagKey is duplicated.

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

Change history

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