All Products
Search
Document Center

Resource Access Management:UntagResources

Last Updated:May 08, 2024

Removes tags from a resource.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ResourceTypestringYes

The type of the resource. Valid value:

  • user: a RAM user
user
AllbooleanNo

Specifies whether to remove all tags from the resource. Valid values:

  • true: remove all tags from the resources.
  • false (default): does not remove all tags from the resources.
Note This parameter takes effect only when TagKey.N is not set in the request.
false
ResourcePrincipalNamearrayYes

The names of resources.

Valid values of N: 1 to 50. If the ResourceType parameter is set to user, the resource name is the name of the RAM user.

Note You must specify only one of the following parameters: ResourceId and ResourcePrincipalName.
stringYes

The name of resource N.

Valid values of N: 1 to 50. If the ResourceType parameter is set to user, the resource name is the name of the RAM user.

Note You must specify only one of the following parameters: ResourceId and ResourcePrincipalName.
test@example.onaliyun.com
ResourceIdarrayYes

The IDs of resources.

Valid values of N: 1 to 50. If the ResourceType parameter is set to user, the resource ID is the ID of the RAM user.

Note You must specify only one of the following parameters: ResourceId and ResourcePrincipalName.
stringYes

The ID of resource N.

Valid values of N: 1 to 50. If the ResourceType parameter is set to user, the resource ID is the ID of the RAM user.

Note You must specify only one of the following parameters: ResourceId and ResourcePrincipalName.
20732900249392****
TagKeyarrayNo

The tag keys of resources.

Valid values of N: 1 to 20. N must be consecutive.

stringNo

The tag key of resource N.

Valid values of N: 1 to 20. N must be consecutive.

operator

For more information about common request parameters, see API Reference.

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

6AC79B74-9A78-58E2-818B-1D38EDC64D67

Examples

Sample success responses

JSONformat

{
  "RequestId": "6AC79B74-9A78-58E2-818B-1D38EDC64D67"
}

Error codes

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

Change history

Change timeSummary of changesOperation
2023-09-19The internal configuration of the API is changed, but the call is not affectedsee changesets
Change itemChange content
The internal configuration of the API is changed, but the call is not affected.