All Products
Search
Document Center

Lindorm:UntagResources

Last Updated:Mar 03, 2024

Removes a tag from an instance. If the tag is not associated with another instance, the tag is deleted.

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 resource type. Set the value to INSTANCE.

INSTANCE
ResourceIdarrayYes

The IDs of instances.

stringYes

The IDs of the instances from which you want to remove tags. You can specify multiple instance IDs to remove tags from the instances. You can call the GetLindormInstanceList operation to query the instance IDs.

ld-bp17j28j2y7pm****
TagKeyarrayNo

The list of keys of the tags that you want to remove.

stringNo

The key of the tag that you want to remove.

Note You can specify multiple TagKeys to remove tags from multiple instances. For example, you can set the value of the first TagKey to the key of the tag you want to remove from the instance with a resource ID, and set the value of the second TagKey to the key of the tag you want to remove from the instance with another resource ID.
test
AllbooleanNo

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

  • true: Remove all tags from the instances.
  • false: Do not remove all tags from the instances.
Note
  • The default value of this parameter is false.

  • If you specify the TagKey parameter together with this parameter, this parameter does not take effect.

false

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

8CACBBCE-7519-545C-8695-86D4F09CED7E

Examples

Sample success responses

JSONformat

{
  "RequestId": "8CACBBCE-7519-545C-8695-86D4F09CED7E"
}

Error codes

HTTP status codeError codeError message
400Lindorm.Errorcode.ParameterInvaildThe parameter is invalid.
400Lindorm.Errorcode.InvalidParameter.TagKeyThe Tag.N.Key parameter is invalid.
400Lindorm.Errorcode.Tags.ExceedLimitationThe maximum number of Tags is exceeded.
400Lindorm.Errorcode.Duplicate.TagKeyThe Tag.N.Key contains duplicate keys.
400Lindorm.Errorcode.InvalidTagKey.MalformedThe Tag.N.Key parameter is invalid.
400Lindorm.Errorcode.ParameterInvaild.TagKeysOrDeleteAllThe TagKeys or DeleteAll parameter is invalid.
400Lindorm.Errorcode.InvalidResourceId.NotFoundThe specified ResourceIds are not found in our records.
400Lindorm.Errorcode.NumberExceed.ResourceIdsThe ResourceIds parameter's number is exceed.
403Lindorm.Errorcode.OperationDeniedYou are not authorized to operate on the specified resource.
403Lindorm.Errorcode.ServiceLinkedRoleNoPermissionNo permission to create service linked role.

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

Change history

Change timeSummary of changesOperation
No change history