Todos os produtos
Search
Central de documentação

:TagResources

Última atualização: Jul 08, 2026

Associa tags a um recurso especificado.

Observação

Use esta operação para classificar recursos no Message Queue for Apache RocketMQ e facilitar a busca e a agregação de recursos.

Limite de QPS

Esta operação não tem limite de consultas por segundo (QPS) para uma única conta Alibaba Cloud. Chame a operação conforme as necessidades do seu negócio. Para obter informações sobre o limite de QPS de cada operação, consulte Limites de taxa da API.

Autorização

Contas Alibaba Cloud podem chamar esta operação por padrão. Usuários do Resource Access Management (RAM) precisam receber as permissões necessárias antes de executar a chamada. A tabela a seguir descreve as permissões obrigatórias para que um usuário RAM invoque esta operação. Para saber como conceder permissões, consulte Políticas.

API

Action

Resource

TagResources

mq:QueryInstanceBaseInfo

mq:TagResources

acs:mq:::*

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimTagResources

A operação a ser executada. Defina o valor como TagResources.

InstanceIdStringNãoMQ_INST_188077086902****_BXSuW61e

ID da instância do Message Queue for Apache RocketMQ à qual pertence o recurso que receberá as tags.

Nota Este parâmetro é obrigatório ao associar tags a um tópico ou grupo.
ResourceTypeStringSimTOPIC

Tipo de recurso ao qual associar tags. Este campo aceita valores enumerados. Valores válidos:

  • INSTANCE
  • TOPIC
  • GROUP
Tag.N.KeyStringSimFinanceDept

Chave da tag a ser associada ao recurso especificado. Uma tag é definida pelos parâmetros Tag.N.Key e Tag.N.Value.

  • O valor de N pode variar de 1 a 20.
  • Este parâmetro não aceita string vazia.
  • O valor pode ter até 18 caracteres, não pode começar com acs: ou aliyun, nem conter http:// ou https://.
Tag.N.ValueStringSimFinanceJoshua

Valor da tag a ser associada ao recurso especificado. Uma tag é definida pelos parâmetros Tag.N.Key e Tag.N.Value.

  • O valor de N pode variar de 1 a 20.
  • Este parâmetro aceita string vazia.
  • O valor pode ter até 128 caracteres, não pode começar com acs: ou aliyun, nem conter http:// ou https://.
ResourceId.NStringSimTopicA

ID do recurso ao qual associar as tags especificadas.

  • Para instâncias do Message Queue for Apache RocketMQ, especifique o ID da instância.
  • Para tópicos, especifique o nome do tópico.
  • Para grupos, especifique o ID do grupo.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

301D2CBE-66F8-403D-AEC0-82582478****

ID da solicitação. O sistema gera um ID exclusivo para cada solicitação. Use este ID para solucionar problemas.

Exemplos

Exemplos de solicitações

http(s)://ons.cn-zhangjiakou.aliyuncs.com/?Action=TagResources
&ResourceId.1=TopicA
&ResourceType=TOPIC
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceJoshua
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<TagResourcesResponse>
<RequestId>301D2CBE-66F8-403D-AEC0-82582478****</RequestId>
</TagResourcesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "301D2CBE-66F8-403D-AEC0-82582478****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.

Associar tags a um recurso no console

No Message Queue for Apache RocketMQ console, você pode associar tags a um recurso. Para mais informações, consulte Gerenciar tags.