All Products
Search
Document Center

ApsaraMQ for Kafka:UntagResources

Last Updated:Mar 11, 2026

Removes tags from ApsaraMQ for Kafka resources, including instances, topics, and consumer groups.

Debugging

OpenAPI Explorer automatically calculates the signature value and generates SDK sample code. Use it to debug and test this operation.

Authorization information

The following table describes the authorization information for this API operation. Use this information in the Action policy element to grant a Resource Access Management (RAM) user or RAM role the permissions to call this operation.

OperationAccess levelResource typeCondition keyAssociated operation
alikafka:UntagResourcesupdateAll resources\*NoneNone
  • Operation: the value that you 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 resource on which you can authorize the RAM user or RAM role to perform the operation. Required resource types are highlighted. If permissions cannot be granted at the resource level, All resources is used.

  • Condition key: the condition key defined by the Alibaba Cloud service.

  • Associated operation: other operations that the RAM user or RAM role must have permissions to perform to complete this operation.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYesThe region ID of the resource.cn-hangzhou
ResourceTypestringYesThe type of resource to untag. Valid values: INSTANCE, TOPIC, CONSUMERGROUP. This value is not case-sensitive.INSTANCE
AllbooleanNoWhether to remove all tags from the resource. This parameter takes effect only when TagKey is not specified. Default value: false.false
ResourceIdarray of stringYesThe resource IDs. The ID format varies by resource type:
  • Instance: instanceId
  • Topic: Kafka_instanceId_topic
  • Consumer group: Kafka_instanceId_consumerGroup
For example, to untag the instance alikafka_post-cn-v0h1fgs2xxxx, the topic test-topic, and the consumer group test-consumer-group, set the resource IDs to alikafka_post-cn-v0h1fgs2xxxx, Kafka_alikafka_post-cn-v0h1fgs2xxxx_test-topic, and Kafka_alikafka_post-cn-v0h1fgs2xxxx_test-consumer-group.
alikafka_post-cn-v0h1fgs2\*\*\*\*
TagKeyarray of stringNoThe tag keys to remove.
  • If not specified and All is set to true, all tags are removed from the resource.
  • Maximum length: 128 characters.
  • Cannot contain http:// or https://.
  • Cannot start with acs: or aliyun.
FinanceDept

Response parameters

ParameterTypeDescriptionExample
RequestIdstringThe request ID.C46FF5A8-C5F0-4024-8262-B16B6392\*\*\*\*

Examples

Sample success responses

JSON format

{
  "RequestId": "C46FF5A8-C5F0-4024-8262-B16B6392****"
}

Error codes

For a list of error codes, see Common error codes.

Change history

DateDescriptionDetails
2024-08-15Updated the API operation description.

View change details

2023-11-09Updated internal configurations. The API behavior remains unchanged.

View change details