Todos os produtos
Search
Central de documentação

Auto Scaling:ListTagResources

Última atualização: Sep 17, 2026

Consulta as tags associadas a um ou mais recursos do Auto Scaling.

Descrição da operação

Descrição da operação

  • Especifique pelo menos um parâmetro de solicitação: ResourceId.N ou Tag.N (Tag.N.Key e Tag.N.Value) para determinar o objeto da consulta.

  • Se você especificar tanto Tag.N quanto ResourceId.N, a resposta conterá apenas os recursos do Auto Scaling que atendem a ambos os critérios condicionais.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região do recurso. Você pode chamar DescribeRegions para consultar a lista mais recente de regiões.

cn-hangzhou

ResourceType

string

Sim

O tipo de recurso. Somente grupos de escalonamento são suportados. Valores válidos: scalinggroup.

scalinggroup

NextToken

string

Não

O token que determina o ponto inicial da próxima consulta.

caeba0bbb2be03f84eb48b699f0a4883

ResourceId

array

Não

O ID do recurso. Valores válidos para N: 1 a 50.

asg-bp17xb4x1vr29lgt****

string

Não

O ID do recurso. Valores válidos para N: 1 a 50.

asg-bp17xb4x1vr29lgt****

Tag

array<object>

Não

As tags.

object

Não

As tags.

Key

string

Não

A chave da tag usada para realizar uma busca exata por recursos do Auto Scaling. A chave da tag deve ter de 1 a 128 caracteres. Valores válidos para N: 1 a 20.

Tag.N é usado para realizar uma busca exata por recursos do Auto Scaling que possuem as tags especificadas associadas. Uma tag é um par chave-valor.

  • Se você especificar apenas Tag.N.Key, todos os recursos associados à chave da tag serão retornados.

  • Se você especificar apenas Tag.N.Value, o erro MissingParameter.TagKey será retornado.

  • Se você especificar vários pares de chave-valor de tag simultaneamente, apenas os recursos do Auto Scaling que correspondem a todos os pares de chave-valor de tag especificados serão retornados.

TestKey

Value

string

Não

O valor da tag usado para realizar uma busca exata por recursos do Auto Scaling. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres. Valores válidos para N: 1 a 20.

TestValue

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

NextToken

string

O token que determina o ponto inicial da próxima consulta.

caeba0bbb2be03f84eb48b699f0a4883

RequestId

string

O ID da solicitação.

DE65F6B7-7566-4802-9007-96F2494A****

TagResources

object

TagResource

array<object>

A coleção de recursos e tags, que contém informações como o ID do recurso, o tipo de recurso e os pares de chave-valor da tag.

object

A coleção de recursos e tags, que contém informações como o ID do recurso, o tipo de recurso e os pares de chave-valor da tag.

TagValue

string

O valor da tag do recurso.

TestValue

ResourceType

string

O tipo de recurso.

ALIYUN::ESS::SCALINGGROUP

ResourceId

string

O ID do recurso.

asg-bp17xb4x1vr29lgt****

TagKey

string

A chave da tag do recurso.

TestKey

Propagate

boolean

Indica se a tag é uma tag propagável. Valores válidos:

  • true: A tag no grupo de escalonamento é propagada apenas para instâncias que estão prestes a ser criadas durante eventos de scale-out. A tag não é propagada para instâncias que já estão em execução no grupo de escalonamento.

  • false: A tag no grupo de escalonamento não é propagada para as instâncias.

false

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "DE65F6B7-7566-4802-9007-96F2494A****",
  "TagResources": {
    "TagResource": [
      {
        "TagValue": "TestValue",
        "ResourceType": "ALIYUN::ESS::SCALINGGROUP",
        "ResourceId": "asg-bp17xb4x1vr29lgt****",
        "TagKey": "TestKey",
        "Propagate": false
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.