DescribeScalingInstances - Auto Scaling: Central de Documentação do Alibaba Cloud

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 spot 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. Você também pode filtrar instâncias ECS por status de verificação de integridade, estado do ciclo de vida ou 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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região onde o grupo de escalonamento está localizado.	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 ou da instância de contêiner elástico no grupo de escalonamento. Instâncias ECS ou instâncias de contêiner elástico que não estão no estado Running são consideradas não íntegras. Valores válidos: Healthy: A instância ECS ou a instância de contêiner elástico está íntegra. Unhealthy: A instância ECS ou a instância de contêiner elástico não está íntegra. O Auto Scaling remove automaticamente instâncias ECS ou instâncias de contêiner elástico não íntegras do grupo de escalonamento e libera as instâncias criadas por criação automática. A liberação de instâncias ECS ou instâncias de contêiner elástico 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 um pagamento em atraso, todas as instâncias ECS ou instâncias de contêiner elástico pós-pagas (incluindo instâncias pós-pagas e instâncias spot) serão interrompidas ou até mesmo liberadas. Para obter mais informações sobre como o status das instâncias ECS ou das instâncias de contêiner elástico em um grupo de escalonamento muda após a ocorrência de um pagamento em atraso, consulte Pagamentos em atraso.	Healthy
LifecycleState	string	Não	O estado do ciclo de vida da instância ECS, da instância de contêiner elástico ou da instância gerenciada no grupo de escalonamento. Valores válidos: InService: A instância é adicionada ao grupo de escalonamento e fornece serviços como Normal. Pending: A instância está sendo adicionada ao grupo de escalonamento. Durante esse procedimento, a instância também é adicionada ao grupo de servidores de backend da instância de load balancer associada e à lista de permissões de acesso da instância do ApsaraDB RDS associada. Pending:Wait: A instância está aguardando para ser adicionada. Se um hook de ciclo de vida que se aplica a atividades de scale-out for criado para o grupo de escalonamento, a instância será suspensa durante a atividade de scale-out e aguardará o fim do tempo limite do hook de ciclo de vida. Protected: A instância está protegida. A instância fornece serviços como Normal, mas o Auto Scaling não gerencia o ciclo de vida da instância. Você deve gerenciar manualmente o ciclo de vida da instância. Standby: A instância está no estado de standby. A instância 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. Você deve gerenciar manualmente o ciclo de vida da instância. Stopped: A instância está interrompida. A instância ECS, a instância de contêiner elástico ou a instância gerenciada está interrompida e não fornece serviços. Removing: A instância está sendo removida do grupo de escalonamento. Durante esse procedimento, a instância também é removida do grupo de servidores de backend da instância de load balancer associada e da lista de permissões de acesso da instância do ApsaraDB RDS associada. Removing:Wait: A instância está aguardando para ser removida. Se um hook de ciclo de vida que se aplica a atividades de scale-down for criado para o grupo de escalonamento, a instância será suspensa durante a atividade de scale-down e aguardará o fim do tempo limite do hook de ciclo de vida. Nota As instâncias gerenciadas não suportam hooks de ciclo de vida, associação de load balancer ou o recurso de verificação de integridade.	InService
CreationType	string	Não	O método usado para criar instâncias no grupo de escalonamento. Valores válidos: AutoCreated: A instância ECS ou a instância de contêiner elástico é criada por criação automática com base na origem da configuração da instância. Attached: A instância ECS ou a instância de contêiner elástico 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. Valor mínimo: 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página para paginação. Valor máximo: 100. Valor padrão: 10.	10
ScalingActivityId	string	Não	O ID da atividade de escalonamento.	asa-bp1c9djwrgxjyk31****
InstanceId	array	Não	Os IDs das instâncias no grupo de escalonamento.	i-bp109k5j3dum1ce6****
	string	Não	O ID de uma instância no grupo de escalonamento. Valores válidos de N: 1 a 20. 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. Você não pode especificar este parâmetro e CreationType simultaneamente. Valores válidos: AutoCreated: A instância ECS é criada por criação automática 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. Nota Ao configurar este parâmetro, você pode especificar vários tipos de criação (por exemplo, AutoCreated, Attached e Managed).	AutoCreated
LifecycleStates	array	Não	Os estados do ciclo de vida das instâncias ECS, das instâncias de contêiner elástico ou das instâncias gerenciadas 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, da instância de contêiner elástico ou da instância gerenciada no grupo de escalonamento. Valores válidos: InService: A instância é adicionada ao grupo de escalonamento e fornece serviços como Normal. Pending: A instância está sendo adicionada ao grupo de escalonamento. Durante esse procedimento, a instância também é adicionada ao grupo de servidores de backend da instância de load balancer associada e à lista de permissões de acesso da instância do ApsaraDB RDS associada. Pending:Wait: A instância está aguardando para ser adicionada. Se um hook de ciclo de vida que se aplica a atividades de scale-out for criado para o grupo de escalonamento, a instância será suspensa durante a atividade de scale-out e aguardará o fim do tempo limite do hook de ciclo de vida. Protected: A instância está protegida. A instância fornece serviços como Normal, mas o Auto Scaling não gerencia o ciclo de vida da instância. Você deve gerenciar manualmente o ciclo de vida da instância. Standby: A instância está no estado de standby. A instância 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. Você deve gerenciar manualmente o ciclo de vida da instância. Stopped: A instância está interrompida. A instância ECS, a instância de contêiner elástico ou a instância gerenciada está interrompida e não fornece serviços. Removing: A instância está sendo removida do grupo de escalonamento. Durante esse procedimento, a instância também é removida do grupo de servidores de backend da instância de load balancer associada e da lista de permissões de acesso da instância do ApsaraDB RDS associada. Removing:Wait: A instância está aguardando para ser removida. Se um hook de ciclo de vida que se aplica a atividades de scale-down for criado para o grupo de escalonamento, a instância será suspensa durante a atividade de scale-down e aguardará o fim do tempo limite do hook de ciclo de vida. Nota As instâncias gerenciadas não suportam hooks de ciclo de vida, associação de load balancer ou o recurso de verificação de integridade.	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 spot em execução no grupo de escalonamento atual.	4
TotalCount	integer	O número total de instâncias.	1
ScalingInstances	object
ScalingInstance	array<object>	A coleção de informações das instâncias.
	object	A coleção de informações das instâncias.
CreationTime	string	A hora em que a instância foi adicionada ao grupo de escalonamento. A hora é exibida em UTC no formato ISO 8601, com precisão de minutos.	2020-05-18T03:11Z
LoadBalancerWeight	integer	[Deprecated] O peso da instância de load balancer. Este parâmetro foi descontinuado.	50
LaunchTemplateId	string	O ID do modelo de inicialização.	lt-m5e3ofjr1zn1aw7****
InstanceId	string	O ID da instância.	i-bp109k5j3dum1ce6****
SpotStrategy	string	A política de preempção da instância spot. Valores válidos: SpotWithPriceLimit: A instância spot tem um preço máximo de lance. 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 ou da instância de contêiner elástico no grupo de escalonamento. Instâncias ECS ou instâncias de contêiner elástico que não estão no estado Running são consideradas não íntegras. Valores válidos: Healthy: A instância ECS ou a instância de contêiner elástico está íntegra. Unhealthy: A instância ECS ou a instância de contêiner elástico não está íntegra. O Auto Scaling remove automaticamente instâncias ECS ou instâncias de contêiner elástico não íntegras do grupo de escalonamento e libera as instâncias criadas por criação automática. A liberação de instâncias ECS ou instâncias de contêiner elástico 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 um pagamento em atraso, todas as instâncias ECS ou instâncias de contêiner elástico pós-pagas (incluindo instâncias pós-pagas e instâncias spot) serão interrompidas ou até mesmo liberadas. Para obter mais informações sobre como o status das instâncias ECS ou das instâncias de contêiner elástico em um grupo de escalonamento muda após a ocorrência de um pagamento 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. 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, da instância de contêiner elástico ou da instância gerenciada no grupo de escalonamento. Valores válidos: InService: A instância é adicionada ao grupo de escalonamento e fornece serviços como Normal. Pending: A instância está sendo adicionada ao grupo de escalonamento. Durante esse procedimento, a instância também é adicionada ao grupo de servidores de backend da instância de load balancer associada e à lista de permissões de acesso da instância do ApsaraDB RDS associada. Pending:Wait: A instância está aguardando para ser adicionada. Se um hook de ciclo de vida que se aplica a atividades de scale-out for criado para o grupo de escalonamento, a instância será suspensa durante a atividade de scale-out e aguardará o fim do tempo limite do hook de ciclo de vida. Protected: A instância está protegida. A instância fornece serviços como Normal, mas o Auto Scaling não gerencia o ciclo de vida da instância. Você deve gerenciar manualmente o ciclo de vida da instância. Standby: A instância está no estado de standby. A instância 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. Você deve gerenciar manualmente o ciclo de vida da instância. Stopped: A instância está interrompida. A instância ECS, a instância de contêiner elástico ou a instância gerenciada está interrompida e não fornece serviços. Removing: A instância está sendo removida do grupo de escalonamento. Durante esse procedimento, a instância também é removida do grupo de servidores de backend da instância de load balancer associada e da lista de permissões de acesso da instância do ApsaraDB RDS associada. Removing:Wait: A instância está aguardando para ser removida. Se um hook de ciclo de vida que se aplica a atividades de scale-down for criado para o grupo de escalonamento, a instância será suspensa durante a atividade de scale-down e aguardará o fim do tempo limite do hook de ciclo de vida. Nota As instâncias gerenciadas não suportam hooks de ciclo de vida, associação de load balancer ou o recurso de verificação de integridade.	InService
CreationType	string	O método usado para criar a instância no grupo de escalonamento. Valores válidos: AutoCreated: A instância ECS é criada por criação automática 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
ZoneId	string	O ID da zona onde a instância está localizada.	cn-hangzhou-g
ScalingConfigurationId	string	O ID da configuração de escalonamento associada.	asc-bp1i65jd06v04vdh****
Entrusted	boolean	Indica se a instância adicionada manualmente é gerenciada pelo grupo de escalonamento. Instâncias gerenciadas que são adicionadas manualmente são liberadas quando são removidas do grupo de escalonamento (exceto na remoção manual). Valores válidos: true: A instância é gerenciada pelo grupo de escalonamento. false: A instância não é gerenciada pelo grupo de escalonamento.	true
WeightedCapacity	integer	O peso do tipo de instância. O peso indica a capacidade que uma única instância desse tipo de instância representa 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 foi adicionada ao grupo de escalonamento. A hora é exibida em UTC no formato ISO 8601, com precisão de segundos.	2020-05-18T03:11:39Z
ScalingActivityId	string	O ID da atividade de escalonamento durante a qual a instância foi adicionada ao grupo de escalonamento.	asa-bp1c9djwrgxjyk31****
InstanceType	string	O tipo da instância.	ecs.n1.small
ScalingInstanceId	string	A identidade da instância no grupo de escalonamento, que tem um mapeamento um para um com a identidade da instância ECS ou da instância de contêiner elástico.	asi-j6cj1gcte640ekhb****
PrivateIpAddress	string	O endereço IP interno 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 correção de instância spot. 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 spot para pós-pago.	ReBalance

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "B13527BF-1FBD-4334-A512-20F5E9D3****",
  "PageSize": 10,
  "PageNumber": 1,
  "TotalSpotCount": 4,
  "TotalCount": 1,
  "ScalingInstances": {
    "ScalingInstance": [
      {
        "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****",
        "InstanceType": "ecs.n1.small",
        "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.