All Products
Search
Document Center

Virtual Private Cloud:UnTagResources

Last Updated:Aug 28, 2026

Removes tags from resources.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ResourceType

string

Yes

The resource type. Valid values:

  • VPC

  • VSWITCH

  • ROUTETABLE

  • EIP

  • VpnGateway

  • NATGATEWAY

  • COMMONBANDWIDTHPACKAGE: EIP bandwidth plan

VPC

All

boolean

No

Whether to remove all tags from the specified resource. Valid values:

  • true

  • false (default)

false

ResourceId

array

Yes

The resource ID. You can specify up to 20 resource IDs.

vpc-bp16qjewdsunr41m1****

string

No

The resource ID. You can specify up to 20 resource IDs.

vpc-bp16qjewdsunr41m1****

TagKey

array

No

The tag key to remove. You can specify up to 20 tag keys. The key can be an empty string.

The key cannot exceed 64 characters in length and can contain digits, periods (.), underscores (_), and hyphens (-). The key must start with a letter but cannot start with aliyun or acs:. The key cannot contain http:// or https://.

FinanceDept

string

No

The tag key to remove. You can specify up to 20 tag keys. The key can be an empty string.

The key cannot exceed 64 characters in length and can contain digits, periods (.), underscores (_), and hyphens (-). The key must start with a letter but cannot start with aliyun or acs:. The key cannot contain http:// or https://.

FinanceDept

RegionId

string

Yes

The region ID of the resource.

Call the DescribeRegions operation to query the most recent region list.

cn-hangzhou

Response elements

Element

Type

Description

Example

object

The request ID.

RequestId

string

The request ID.

C46FF5A8-C5F0-4024-8262-B16B639225A0

Examples

Success response

JSON format

{
  "RequestId": "C46FF5A8-C5F0-4024-8262-B16B639225A0\t"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidTagKey The tag keys are not valid. The tag index is invalid.
400 InvalidTagValue The tag values are not valid. The tag value is invalid.
400 MissingParam %s
400 InvalidInstanceType.NotFound The instance type is not found The instance type is not found.
400 InvalidInstanceIds.NotFound The instanceIds are not found The instance ID is not found.
400 Forbidden.TagKeys The request do not allow to operate the tag keys You do not have the permissions to set the TagKeys parameter.
400 QuotaExceeded.TagNum Custom Tags quota exceeded The upper limit is reached.
400 Forbidden.NotAllowedCategary The System tag is not valid The error message returned because the system tag is invalid.
400 Forbidden.TagKey.Duplicated The specified tag key already exists. The tag resources are duplicate.
400 SizeLimitExceeded.TagNum The maximum number of tags is exceeded. The number of tags has reached the upper limit.
400 SizeLimitExceeded.ResourceId The maximum number of resource IDs is exceeded. The number of resource group IDs has reached the upper limit.
400 DuplicatedParam.ResourceIds The parameter of ResourceIds contains duplicate values.
403 Forbidden User not authorized to operate on the specified resource. You do not have the permissions to manage the specified resource. Apply for the permissions and try again.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.