ListTagResources - : Central de Documentação do Alibaba Cloud

Observação

Ao chamar a operação ListTagResources, é obrigatório especificar pelo menos um dos seguintes parâmetros na solicitação: Tag.N.Key ou ResourceId.N. Especifique um ID de recurso para consultar todas as tags associadas ao recurso indicado. Alternativamente, especifique uma chave de tag para obter o valor da tag e identificar o recurso ao qual ela está vinculada.

Caso você configure o parâmetro Tag.N.Key na solicitação, o retorno incluirá o valor da tag e o ID do recurso associado.
Se o parâmetro ResourceId.N for definido na requisição, serão retornadas as chaves e valores de todas as tags vinculadas ao recurso especificado.

Limite de QPS

Cada conta Alibaba Cloud pode invocar esta operação até 10 vezes por segundo. O envio de solicitações acima desse limite de consultas por segundo (QPS) aciona o mecanismo de limitação de taxa, o que pode interromper seus serviços. Para mais detalhes sobre os limites de QPS de cada operação, consulte Limites de taxa da API.

Autorização

Contas Alibaba Cloud possuem permissão nativa para executar esta operação. Usuários do Resource Access Management (RAM) precisam receber as permissões adequadas antes de realizar a chamada. A tabela abaixo detalha as permissões necessárias para usuários RAM. Para instruções sobre como conceder acesso, consulte Políticas.

API

Action

Resource

ListTagResources

mq:QueryInstanceBaseInfo

mq:ListTagResources

acs:mq:::*

acs:mq:::{InstanceId}

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ListTagResources	A operação a ser executada. Defina o valor como ListTagResources.
InstanceId	String	Não	MQ_INST_188077086902****_BXSuW61e	ID da instância do Message Queue for Apache RocketMQ à qual pertence o recurso cujas tags serão consultadas. Nota Este parâmetro é obrigatório ao consultar tags de tópicos ou grupos.
ResourceType	String	Sim	TOPIC	Tipo do recurso alvo da consulta de tags. Este campo aceita valores enumerados específicos: INSTANCE TOPIC GROUP
NextToken	String	Não	caeba0****be03f84eb48b699f0a4883	Token utilizado para recuperar a próxima página de resultados.
Tag.N.Key	String	Não	CartService	Chave da tag que se deseja consultar. O valor de N deve estar entre 1 e 20. Quando incluído na solicitação, este parâmetro não aceita strings vazias. O conteúdo pode ter no máximo 128 caracteres, não pode iniciar com acs: ou aliyun, nem conter http:// ou https://.
Tag.N.Value	String	Não	ServiceA	Valor correspondente à tag consultada. Aceita valores numéricos de 1 a 20 para N. É permitido o uso de string vazia neste campo. Limite de 128 caracteres; proíbidos os prefixos acs: e aliyun, bem como os protocolos http:// e https://.
ResourceId.N	String	Não	test	Identificador do recurso para consulta de tags. Para instâncias do Message Queue for Apache RocketMQ, informe o ID da instância. Em caso de tópicos, utilize o nome do tópico. Para grupos, forneça o ID do grupo correspondente.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NextToken	String	caeba0****be03f84eb48b699f0a4883	Token necessário para paginar e acessar a próxima lista de resultados.
RequestId	String	301D2CBE-66F8-403D-AEC0-82582478****	Identificador único gerado pelo sistema para cada solicitação. Utilize este ID para rastrear e solucionar problemas.
TagResources	Array of TagResource		Conjunto de informações detalhando recursos e suas tags, incluindo IDs, tipos e pares chave-valor.
ResourceType	String	ALIYUN::MQ::TOPIC	Categoria do recurso identificado. ALIYUN::MQ::INSTANCE: refere-se a uma instância do Message Queue for Apache RocketMQ. ALIYUN::MQ::TOPIC: indica um tópico de mensagens. ALIYUN::MQ::GROUP: representa um grupo de consumidores ou produtores.
InstanceId	String	MQ_INST_188077086902****_BXSuW61e	Identificação da instância do Message Queue for Apache RocketMQ onde o recurso está hospedado.
TagValue	String	ServiceA	Valor atribuído à tag.
ResourceId	String	TopicA	Identificador único do recurso.
TagKey	String	CartService	Chave definida para a tag.

Exemplos

Exemplo de solicitação

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=ListTagResources
&ResourceType=TOPIC
&ResourceId.1=TopicA
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

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

<ListTagResourcesResponse>
<RequestId>301D2CBE-66F8-403D-AEC0-82582478****</RequestId>
<NextToken>caeba0****be03f84eb48b699f0a4883</NextToken>
<TagResources>
    <ResourceId>TopicA</ResourceId>
    <InstanceId>MQ_INST_188077086902****_BXSuW61e</InstanceId>
    <TagKey>CartService</TagKey>
    <ResourceType>ALIYUN::MQ::TOPIC</ResourceType>
    <TagValue>ServiceA</TagValue>
</TagResources>
</ListTagResourcesResponse>

Formato JSON

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

{
  "RequestId" : "301D2CBE-66F8-403D-AEC0-82582478****",
  "NextToken" : "caeba0****be03f84eb48b699f0a4883",
  "TagResources" : {
    "ResourceId" : "TopicA",
    "InstanceId" : "MQ_INST_188077086902****_BXSuW61e",
    "TagKey" : "CartService",
    "ResourceType" : "ALIYUN::MQ::TOPIC",
    "TagValue" : "ServiceA"
  }
}

Códigos de erro

Consulte a lista de códigos de erro na Central de Erros da API.

Visualize tags de um recurso no console

No Message Queue for Apache RocketMQ console, é possível verificar as tags associadas aos seus recursos. Para mais informações, consulte Gerencie tags.