All Products
Search
Document Center

Hologres:UntagResources

Last Updated:May 21, 2026

Removes tags from one or more instances.

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 syntax

POST /api/v1/tag/unTag HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

No

The region ID.

cn-hangzhou

body

object

No

The request body.

category

string

No

The resource category.

Valid values:

  • Custom :

    custom tag

  • System :

    system tag

Custom

resourceType

string

No

The resource type.

Valid values:

  • INSTANCE :

    The resource is an instance.

INSTANCe

tagOwnerUid

integer

No

The account ID of the tag owner.

1062017779051424

resourceIds

array

No

An array of instance IDs.

string

No

An instance ID.

hgprecn-cn-zpr3686u9008

tagKeys

array

No

An array of tag keys. To remove tags, you only need to provide the corresponding tag keys.

string

No

A tag key.

your_tag

Response elements

Element

Type

Description

Example

object

The response object.

RequestId

string

The request ID.

CE1C813B-3445-57EC-9504-342E45D1C7EA

Data

boolean

Indicates whether the operation was successful.

Valid values:

  • true :

    The operation was successful.

  • false :

    The operation failed.

true

Success

boolean

Indicates whether the request was successfully processed. This parameter does not indicate the outcome of the untagging operation.

Valid values:

  • true :

    The request was successful.

  • false :

    The request failed.

true

ErrorCode

string

The error code.

404

ErrorMessage

string

The error message.

Internal server error.

HttpStatusCode

string

The HTTP status code.

200

Examples

Success response

JSON format

{
  "RequestId": "CE1C813B-3445-57EC-9504-342E45D1C7EA",
  "Data": true,
  "Success": true,
  "ErrorCode": "404",
  "ErrorMessage": "Internal server error.",
  "HttpStatusCode": "200"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.