Consultar rótulos de recursos especificados - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente exemplos de código da operação para diferentes SDKs.

Sintaxe da solicitação

GET /tags?resource_ids=["String"]&resource_type=String&region_id=String&tags=[{"key":"String","value":"String"}]&next_token=String HTTP/1.1
Content-Type:application/json

Parâmetros da solicitação

Tabela 1. Parâmetros de consulta da solicitação
Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
resource_ids	Array of String	Sim	c71cf3d796c374bf48644482cb0c3****	ID do cluster.
resource_type	String	Sim	CLUSTER	Tipo do recurso. Valores válidos:`CLUSTER`.
region_id	String	Sim	cn-beijing	ID da região.
tags	Array de rótulo	Não		Lista de rótulos a serem consultados. Especifique até 20 rótulos.
next_token	String	Não	***	Token usado para iniciar a próxima consulta.

Sintaxe da resposta

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

{
  "next_token" : "String",
  "request_id" : "String",
  "tag_resources" : {
    "tag_resource" : [ {
      "tag_key" : "String",
      "tag_value" : "String",
      "resource_id" : "String",
      "resource_type" : "String"
    } ]
  }
}

Parâmetros da resposta

Tabela 2. Parâmetros do corpo da resposta
Parâmetro	Tipo	Exemplo	Descrição
next_token	String	c374bf4864448****	Token usado para iniciar a próxima consulta.
request_id	String	E368C761-F8F6-4A36-9B58-BD53D5CD0CEB	ID da solicitação.
tag_resources	object		Detalhes dos rótulos e recursos consultados.
tag_resource	Array of tag_resource		Rótulos do recurso.
tag_key	String	ack.aliyun.com	Chave do rótulo.
tag_value	String	c71cf3d796c374bf48644482cb0c3****	Valor do rótulo.
resource_id	String	i-xxx	ID do recurso.
resource_type	String	CLUSTER	Tipo do recurso. Para mais informações, consulte Rótulos.

Exemplos

Exemplos de solicitações

GET /tags?resource_ids=["c71cf3d796c374bf48644482cb0c3****"]&resource_type=CLUSTER&region_id=cn-beijing&tags=[{"key":"env","value":"prod"}]&next_token=*** HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

Exemplos de respostas de sucesso

Formato XML

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

<next_token>c374bf4864448****</next_token>
<request_id>E368C761-F8F6-4A36-9B58-BD53D5CD0CEB</request_id>
<tag_resources>
    <tag_resource>
        <tag_key>ack.aliyun.com</tag_key>
        <tag_value>c71cf3d796c374bf48644482cb0c3****</tag_value>
        <resource_id>i-xxx</resource_id>
        <resource_type>CLUSTER</resource_type>
    </tag_resource>
</tag_resources>

Formato JSON

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

{
  "next_token" : "c374bf4864448****",
  "request_id" : "E368C761-F8F6-4A36-9B58-BD53D5CD0CEB",
  "tag_resources" : {
    "tag_resource" : [ {
      "tag_key" : "ack.aliyun.com",
      "tag_value" : "c71cf3d796c374bf48644482cb0c3****",
      "resource_id" : "i-xxx",
      "resource_type" : "CLUSTER"
    } ]
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.