Todos os produtos
Search

Este produto

    Auto Scaling:DescribeScalingInstances

    Central de documentação

    Auto Scaling:DescribeScalingInstances

    Última atualização: Jul 16, 2026

    Consulta a lista de instâncias ECS em um grupo de escalonamento e as informações das instâncias pelo ID do grupo de escalonamento, incluindo o número total de instâncias preemptíveis em execução, o número total de instâncias ECS, o estado de aquecimento das instâncias ECS e o estado do ciclo de vida no grupo de escalonamento atual. Também permite filtrar instâncias ECS por status de integridade, estado do ciclo de vida e tipo de criação.

    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

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    ess:DescribeScalingInstances

    get

    *ScalingGroup.

    acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

    O ID da região do grupo de escalonamento.

    cn-hangzhou
    ScalingGroupId

    string

    Não

    O ID do grupo de escalonamento.

    asg-bp1igpak5ft1flyp****
    ScalingConfigurationId

    string

    Não

    O ID da configuração de escalonamento associada.

    asc-bp1i65jd06v04vdh****
    HealthStatus

    string

    Não

    O status da verificação de integridade da instância ECS no grupo de escalonamento. Instâncias ECS que não estão com o status de instância Running são consideradas não íntegras. Valores válidos:

    • Healthy: A instância ECS está íntegra.

    • Unhealthy: A instância ECS não está íntegra.

    O Auto Scaling remove automaticamente instâncias ECS não íntegras do grupo de escalonamento e libera instâncias ECS criadas por meio de criação automática.

    A liberação de instâncias ECS adicionadas manualmente depende do seu estado gerenciado. Se o ciclo de vida da instância não for gerenciado pelo grupo de escalonamento, a instância será apenas removida, mas não liberada. Se o ciclo de vida da instância for gerenciado pelo grupo de escalonamento, a instância será removida e liberada.

    Nota

    Certifique-se de que sua conta tenha cota ativa suficiente. Se sua conta tiver pagamentos em atraso, todas as instâncias ECS pay-as-you-go (incluindo instâncias pay-as-you-go e instâncias preemptíveis) serão interrompidas ou até mesmo liberadas. Para obter informações sobre como o status das instâncias ECS em um grupo de escalonamento muda após a ocorrência de pagamentos em atraso, consulte Pagamentos em atraso.

    Healthy
    LifecycleState

    string

    Não

    O estado do ciclo de vida da instância ECS no grupo de escalonamento. Valores válidos:

    • InService: A instância ECS foi adicionada com sucesso ao grupo de escalonamento e fornece serviços normalmente.

    • Pending: A instância ECS está sendo adicionada ao grupo de escalonamento. Durante esse procedimento, a instância ECS é adicionada aos grupos de servidores de backend das instâncias de balanceamento de carga associadas e às listas brancas de acesso das instâncias do ApsaraDB RDS associadas.

    • Pending:Wait: A instância ECS está aguardando para ser adicionada ao grupo de escalonamento. Se um hook de ciclo de vida aplicável a atividades de scale-out for criado para o grupo de escalonamento, a instância ECS será suspensa durante o processo de adição e aguardará o término do tempo limite do hook de ciclo de vida.

    • Protected: A instância ECS está protegida. A instância ECS fornece serviços normalmente, mas o Auto Scaling não gerencia o ciclo de vida da instância ECS. Você deve gerenciá-la manualmente.

    • Standby: A instância ECS está em estado de espera. A instância ECS não fornece serviços, o peso do servidor de backend do SLB é definido como zero e o Auto Scaling não gerencia o ciclo de vida da instância ECS. Você deve gerenciá-la manualmente.

    • Stopped: A instância ECS está parada e não fornece serviços.

    • Removing: A instância ECS está sendo removida do grupo de escalonamento. Durante esse procedimento, a instância ECS é removida dos grupos de servidores de backend das instâncias de balanceamento de carga associadas e das listas brancas de acesso das instâncias do ApsaraDB RDS associadas.

    • Removing:Wait: A instância ECS está aguardando para ser removida do grupo de escalonamento. Se um hook de ciclo de vida aplicável a atividades de scale-down for criado para o grupo de escalonamento, a instância ECS será suspensa durante o processo de remoção e aguardará o término do tempo limite do hook de ciclo de vida.

    InService
    CreationType

    string

    Não

    O método usado para criar a instância no grupo de escalonamento. Valores válidos:

    • AutoCreated: A instância ECS é criada por meio de criação automática pelo Auto Scaling com base na origem da configuração da instância.

    • Attached: A instância ECS não é criada pelo Auto Scaling, mas adicionada manualmente ao grupo de escalonamento.

    • Managed: A instância gerenciada não é criada pelo Auto Scaling, mas adicionada manualmente ao grupo de escalonamento.

    AutoCreated
    PageNumber

    integer

    Não

    O número da página da lista de instâncias ECS. Valor mínimo: 1.

    Valor padrão: 1.

    1
    PageSize

    integer

    Não

    O número de entradas por página para a consulta paginada. Valor máximo: 100. As configurações de paginação se aplicam a cada página.

    Valor padrão: 10.

    10
    ScalingActivityId

    string

    Não

    O ID da atividade de escalonamento.

    asa-bp1c9djwrgxjyk31****
    InstanceIds

    array

    Não

    Os IDs das instâncias ECS.

    Valores de InstanceId inválidos são ignorados nos resultados da consulta e nenhum erro é retornado.

    string

    Não

    Os IDs das instâncias ECS.

    Valores de InstanceId inválidos são ignorados nos resultados da consulta e nenhum erro é retornado.

    i-bp109k5j3dum1ce6****
    CreationTypes

    array

    Não

    Os métodos usados para criar instâncias no grupo de escalonamento. Você pode especificar apenas um entre este parâmetro e CreationType.

    string

    Não

    O método usado para criar instâncias no grupo de escalonamento. Valores válidos: AutoCreated, Attached e Managed.

    AutoCreated
    LifecycleStates

    array

    Não

    Os estados do ciclo de vida das instâncias ECS no grupo de escalonamento. Você pode especificar apenas um entre este parâmetro e LifecycleState. Recomendamos o uso deste parâmetro.

    string

    Não

    O estado do ciclo de vida da instância ECS no grupo de escalonamento. Valores válidos:

    • InService: A instância ECS foi adicionada com sucesso ao grupo de escalonamento e fornece serviços normalmente.

    • Pending: A instância ECS está sendo adicionada ao grupo de escalonamento. Durante esse procedimento, a instância ECS é adicionada aos grupos de servidores de backend das instâncias de balanceamento de carga associadas e às listas brancas de acesso das instâncias do ApsaraDB RDS associadas.

    • Pending:Wait: A instância ECS está aguardando para ser adicionada ao grupo de escalonamento. Se um hook de ciclo de vida aplicável a atividades de scale-out for criado para o grupo de escalonamento, a instância ECS será suspensa durante o processo de adição e aguardará o término do tempo limite do hook de ciclo de vida.

    • Protected: A instância ECS está protegida. A instância ECS fornece serviços normalmente, mas o Auto Scaling não gerencia o ciclo de vida da instância ECS. Você deve gerenciá-la manualmente.

    • Standby: A instância ECS está em estado de espera. A instância ECS não fornece serviços, o peso do servidor de backend do SLB é definido como zero e o Auto Scaling não gerencia o ciclo de vida da instância ECS. Você deve gerenciá-la manualmente.

    • Stopped: A instância ECS está parada e não fornece serviços.

    • Removing: A instância ECS está sendo removida do grupo de escalonamento. Durante esse procedimento, a instância ECS é removida dos grupos de servidores de backend das instâncias de balanceamento de carga associadas e das listas brancas de acesso das instâncias do ApsaraDB RDS associadas.

    • Removing:Wait: A instância ECS está aguardando para ser removida do grupo de escalonamento. Se um hook de ciclo de vida aplicável a atividades de scale-down for criado para o grupo de escalonamento, a instância ECS será suspensa durante o processo de remoção e aguardará o término do tempo limite do hook de ciclo de vida.

    InService

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID da solicitação.

    B13527BF-1FBD-4334-A512-20F5E9D3****
    PageSize

    integer

    O número de entradas por página.

    10
    PageNumber

    integer

    O número da página atual.

    1
    TotalSpotCount

    integer

    O número total de instâncias preemptíveis em execução no grupo de escalonamento atual.

    4
    TotalCount

    integer

    O número total de instâncias ECS.

    1
    ScalingInstances

    array<object>

    A coleção de informações das instâncias ECS.

    object

    A coleção de informações das instâncias ECS.

    CreationTime

    string

    A hora em que a instância ECS foi adicionada ao grupo de escalonamento. O valor tem precisão de minutos.

    2020-05-18T03:11Z
    LoadBalancerWeight

    integer

    O peso da instância de balanceamento de carga.

    Nota

    Este parâmetro está obsoleto e não é recomendado.

    50
    LaunchTemplateId

    string

    O ID do modelo de inicialização.

    lt-m5e3ofjr1zn1aw7****
    InstanceId

    string

    O ID da instância ECS.

    i-bp109k5j3dum1ce6****
    SpotStrategy

    string

    A política de preempção da instância preemptível. Valores válidos:

    • SpotWithPriceLimit: A instância preemptível tem um limite de preço máximo.

    • SpotAsPriceGo: O sistema faz lances automaticamente pelo preço de mercado atual.

    SpotWithPriceLimit
    LaunchTemplateVersion

    string

    A versão do modelo de inicialização.

    1
    HealthStatus

    string

    O status da verificação de integridade da instância ECS no grupo de escalonamento. Instâncias ECS que não estão com o status de instância Running são consideradas não íntegras. Valores válidos:

    • Healthy: A instância ECS está íntegra.

    • Unhealthy: A instância ECS não está íntegra.

    O Auto Scaling remove automaticamente instâncias ECS não íntegras do grupo de escalonamento e libera instâncias ECS criadas por meio de criação automática.

    A liberação de instâncias ECS adicionadas manualmente depende do seu estado gerenciado. Se o ciclo de vida da instância não for gerenciado pelo grupo de escalonamento, a instância será apenas removida, mas não liberada. Se o ciclo de vida da instância for gerenciado pelo grupo de escalonamento, a instância será removida e liberada.

    Nota

    Certifique-se de que sua conta tenha cota ativa suficiente. Se sua conta tiver pagamentos em atraso, todas as instâncias ECS pay-as-you-go (incluindo instâncias pay-as-you-go e instâncias preemptíveis) serão interrompidas ou até mesmo liberadas. Para obter informações sobre como o status das instâncias ECS em um grupo de escalonamento muda após a ocorrência de pagamentos em atraso, consulte Pagamentos em atraso.

    Healthy
    ScalingGroupId

    string

    O ID do grupo de escalonamento ao qual a instância pertence.

    asg-bp1igpak5ft1flyp****
    WarmupState

    string

    O estado de aquecimento da instância ECS. Valores válidos:

    • NoNeedWarmup: Nenhum aquecimento é necessário.

    • WaitingForInstanceWarmup: A instância está aguardando a conclusão do aquecimento.

    • InstanceWarmupFinish: O aquecimento foi concluído.

    NoNeedWarmup
    LifecycleState

    string

    O estado do ciclo de vida da instância ECS no grupo de escalonamento. Valores válidos:

    • InService: A instância ECS foi adicionada com sucesso ao grupo de escalonamento e fornece serviços normalmente.

    • Pending: A instância ECS está sendo adicionada ao grupo de escalonamento. Durante esse procedimento, a instância ECS é adicionada aos grupos de servidores de backend das instâncias de balanceamento de carga associadas e às listas brancas de acesso das instâncias do ApsaraDB RDS associadas.

    • Pending:Wait: A instância ECS está aguardando para ser adicionada ao grupo de escalonamento. Se um hook de ciclo de vida aplicável a atividades de scale-out for criado para o grupo de escalonamento, a instância ECS será suspensa durante o processo de adição e aguardará o término do tempo limite do hook de ciclo de vida.

    • Protected: A instância ECS está protegida. A instância ECS fornece serviços normalmente, mas o Auto Scaling não gerencia o ciclo de vida da instância ECS. Você deve gerenciá-la manualmente.

    • Standby: A instância ECS está em estado de espera. A instância ECS não fornece serviços, o peso do servidor de backend do SLB é definido como zero e o Auto Scaling não gerencia o ciclo de vida da instância ECS. Você deve gerenciá-la manualmente.

    • Stopped: A instância ECS está parada e não fornece serviços.

    • Removing: A instância ECS está sendo removida do grupo de escalonamento. Durante esse procedimento, a instância ECS é removida dos grupos de servidores de backend das instâncias de balanceamento de carga associadas e das listas brancas de acesso das instâncias do ApsaraDB RDS associadas.

    • Removing:Wait: A instância ECS está aguardando para ser removida do grupo de escalonamento. Se um hook de ciclo de vida aplicável a atividades de scale-down for criado para o grupo de escalonamento, a instância ECS será suspensa durante o processo de remoção e aguardará o término do tempo limite do hook de ciclo de vida.

    InService
    CreationType

    string

    O método usado para criar a instância ECS. Valores válidos:

    • AutoCreated: A instância ECS é criada por meio de criação automática pelo Auto Scaling com base na origem da configuração da instância.

    • Attached: A instância ECS não é criada pelo Auto Scaling, mas adicionada manualmente ao grupo de escalonamento.

    AutoCreated
    ZoneId

    string

    O ID da zona da instância ECS.

    cn-hangzhou-g
    ScalingConfigurationId

    string

    O ID da configuração de escalonamento associada.

    asc-bp1i65jd06v04vdh****
    Entrusted

    boolean

    Indica se o ciclo de vida da instância é gerenciado pelo grupo de escalonamento quando a instância é adicionada manualmente. Instâncias gerenciadas são liberadas quando removidas do grupo de escalonamento (exceto remoção manual). Valores válidos:

    • true: O ciclo de vida da instância é gerenciado pelo grupo de escalonamento.

    • false: O ciclo de vida da instância não é gerenciado pelo grupo de escalonamento.

    true
    WeightedCapacity

    integer

    O peso do tipo de instância, que representa a capacidade de computação de uma única instância desse tipo no grupo de escalonamento. Um peso maior significa que menos instâncias desse tipo são necessárias para atender à capacidade esperada.

    4
    CreatedTime

    string

    A hora em que a instância ECS foi adicionada ao grupo de escalonamento. O valor tem precisão de segundos.

    2020-05-18T03:11:39Z
    ScalingActivityId

    string

    O ID da atividade de escalonamento durante a qual a instância ECS foi adicionada ao grupo de escalonamento.

    asa-bp1c9djwrgxjyk31****
    ScalingInstanceId

    string

    A identidade da instância no grupo de escalonamento, que possui um mapeamento um para um com a identidade da instância ECS ou a identidade da instância ECI.

    asi-j6cj1gcte640ekhb****
    PrivateIpAddress

    string

    O endereço IP privado da instância no grupo de escalonamento.

    1**.2*.1**.2**
    ReplaceStatus

    string

    O processo de substituição de instância no qual a instância se encontra. Valores válidos:

    • Normal: A instância não está em nenhum processo de substituição.

    • ReBalance: A instância está no processo de substituição de rebalanceamento do grupo de escalonamento.

    • SpotRemedy: A instância está no processo de substituição de compensação de instância preemptível.

    • MaxInstanceLifetimeExpire: A instância está no processo de substituição por expiração do tempo de vida máximo da instância.

    • InstanceRefresh: A instância está no processo de substituição de atualização de instância.

    • SpotReplaceOnDemand: A instância está no processo de substituição de instância preemptível para pay-as-you-go.

    ReBalance

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "B13527BF-1FBD-4334-A512-20F5E9D3****",
  "PageSize": 10,
  "PageNumber": 1,
  "TotalSpotCount": 4,
  "TotalCount": 1,
  "ScalingInstances": [
    {
      "CreationTime": "2020-05-18T03:11Z",
      "LoadBalancerWeight": 50,
      "LaunchTemplateId": "lt-m5e3ofjr1zn1aw7****",
      "InstanceId": "i-bp109k5j3dum1ce6****",
      "SpotStrategy": "SpotWithPriceLimit",
      "LaunchTemplateVersion": "1",
      "HealthStatus": "Healthy",
      "ScalingGroupId": "asg-bp1igpak5ft1flyp****",
      "WarmupState": "NoNeedWarmup",
      "LifecycleState": "InService",
      "CreationType": "AutoCreated",
      "ZoneId": "cn-hangzhou-g",
      "ScalingConfigurationId": "asc-bp1i65jd06v04vdh****",
      "Entrusted": true,
      "WeightedCapacity": 4,
      "CreatedTime": "2020-05-18T03:11:39Z",
      "ScalingActivityId": "asa-bp1c9djwrgxjyk31****",
      "ScalingInstanceId": "asi-j6cj1gcte640ekhb****",
      "PrivateIpAddress": "1**.2*.1**.2**",
      "ReplaceStatus": "ReBalance"
    }
  ]
}

    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.