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

Consulta instâncias em um grupo de dimensionamento. Utilize a operação DescribeScalingInstances para obter detalhes das instâncias, como a quantidade de instâncias preemptivas no estado Running, o número de instâncias do Elastic Compute Service (ECS), o status de aquecimento e o status do ciclo de vida das instâncias ECS no grupo. É possível especificar o ID do grupo de dimensionamento ao chamar esta operação. Além disso, filtre as instâncias com base em condições como status de saúde, status do ciclo de vida e método de criação.

Depuração

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

Parâmetros de solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeScalingInstances	A operação a ser executada. Defina o valor como DescribeScalingInstances.
RegionId	String	Yes	cn-hangzhou	O ID da região do grupo de dimensionamento.
ScalingGroupId	String	No	asg-bp1igpak5ft1flyp****	O ID do grupo de dimensionamento.
ScalingConfigurationId	String	No	asc-bp1i65jd06v04vdh****	O ID da configuração de dimensionamento.
HealthStatus	String	No	Healthy	O status de saúde das instâncias. Uma instância ECS ou de contêiner elástico que não esteja no estado Running é considerada não saudável. Valores válidos: Healthy Unhealthy O Auto Scaling remove instâncias ECS ou de contêiner elástico não saudáveis dos grupos de dimensionamento. Se as instâncias não saudáveis foram criadas automaticamente, o Auto Scaling libera essas instâncias após a remoção. O status de gerenciamento da instância determina se as instâncias ECS ou de contêiner elástico adicionadas manualmente a um grupo de dimensionamento serão liberadas. Caso o ciclo de vida das instâncias não seja gerenciado pelo grupo de dimensionamento, o Auto Scaling remove as instâncias do grupo, mas não as libera. Se o ciclo de vida for gerenciado pelo grupo, o Auto Scaling remove e libera as instâncias. Nota Certifique-se de que sua conta Alibaba Cloud tenha saldo suficiente. Se houver pagamentos em atraso na sua conta Alibaba Cloud, todas as instâncias ECS ou de contêiner elástico com pagamento conforme o uso e preemptivas poderão ser interrompidas ou liberadas em casos específicos. Para obter informações sobre como o status das instâncias ECS e de contêineres elásticos muda devido a pagamentos em atraso, consulte Pagamentos em atraso.
LifecycleState	String	No	InService	O status do ciclo de vida das instâncias. Valores válidos: InService: As instâncias foram adicionadas ao grupo de dimensionamento e fornecem serviços conforme esperado. Pending: As instâncias estão sendo adicionadas ao grupo de dimensionamento. Quando uma instância ECS ou de contêiner elástico está sendo adicionada ao grupo, ela também é anexada ao balanceador de carga associado e seu endereço IP privado é incluído na lista de permissões de endereços IP da instância ApsaraDB RDS associada. Pending:Wait: As instâncias estão aguardando para serem adicionadas ao grupo de dimensionamento. Se um hook de ciclo de vida de expansão for criado no grupo, a instância sairá do estado Pending Wait somente após o tempo limite do hook de ciclo de vida de expansão expirar. Protected: As instâncias estão protegidas. Instâncias ECS ou de contêiner elástico no estado Protected podem fornecer serviços normalmente, mas você deve gerenciar manualmente o ciclo de vida delas. Standby: As instâncias estão em espera. Instâncias ECS ou de contêiner elástico no estado Standby não podem fornecer serviços conforme esperado e seus pesos de balanceamento de carga são redefinidos para zero. É necessário gerenciar manualmente o ciclo de vida dessas instâncias. Stopped: As instâncias estão paradas. Instâncias ECS, de contêiner elástico ou de terceiros gerenciadas pela Alibaba Cloud no estado Stopped não podem fornecer serviços conforme esperado. Removing: As instâncias estão sendo removidas do grupo de dimensionamento. Durante a remoção de uma instância ECS ou de contêiner elástico do grupo, ela também é desanexada do balanceador de carga associado e seu endereço IP privado é removido da lista de permissões de endereços IP da instância ApsaraDB RDS associada. Removing:Wait: As instâncias estão aguardando para serem removidas do grupo de dimensionamento. Se um hook de ciclo de vida de redução for criado no grupo, a instância sairá do estado Removing Wait somente após o tempo limite do hook de ciclo de vida de redução expirar. Nota Instâncias de terceiros gerenciadas pela Alibaba Cloud não oferecem suporte aos recursos de hook de ciclo de vida, anexação a balanceadores de carga e verificação de saúde.
CreationType	String	No	AutoCreated	O método de criação da instância. Valores válidos: AutoCreated: O Auto Scaling cria automaticamente instâncias ECS ou de contêiner elástico com base no source de configuração da instância. Attached: Você adiciona manualmente instâncias ECS independentes ou de contêiner elástico ao grupo de dimensionamento. Managed: Você adiciona manualmente instâncias de terceiros gerenciadas pela Alibaba Cloud ao grupo de dimensionamento.
PageNumber	Integer	No	1	O número da página. A numeração começa em 1. Valor padrão: 1.
PageSize	Integer	No	10	A quantidade de entradas por página. Valor máximo: 100. Valor padrão: 10.
ScalingActivityId	String	No	asa-bp1c9djwrgxjyk31****	O ID da atividade de dimensionamento.
InstanceId.N	String	No	i-bp109k5j3dum1ce6****	O ID da instância N no grupo de dimensionamento. Valores válidos para N: 1 a 20. IDs de instância inválidos não aparecem no resultado da consulta e nenhum erro é relatado.
CreationTypes.N	String	No	AutoCreated	Os métodos de criação das instâncias. Se você especificar este parâmetro, não poderá especificar CreationType. Valores válidos: AutoCreated: O Auto Scaling cria automaticamente instâncias ECS com base no source de configuração da instância. Attached: Você adiciona manualmente instâncias ECS independentes ao grupo de dimensionamento. Managed: Você adiciona manualmente instâncias de terceiros gerenciadas pela Alibaba Cloud ao grupo de dimensionamento. Nota É possível especificar um ou mais valores para este parâmetro. Por exemplo, você pode definir AutoCreated, Attached e Managed simultaneamente.
LifecycleStates.N	String	No	InService	O status do ciclo de vida das instâncias. Valores válidos: InService: As instâncias foram adicionadas ao grupo de dimensionamento e fornecem serviços conforme esperado. Pending: As instâncias estão sendo adicionadas ao grupo de dimensionamento. Quando uma instância ECS ou de contêiner elástico está sendo adicionada ao grupo, ela também é anexada ao balanceador de carga associado e seu endereço IP privado é incluído na lista de permissões de endereços IP da instância ApsaraDB RDS associada. Pending:Wait: As instâncias estão aguardando para serem adicionadas ao grupo de dimensionamento. Se um hook de ciclo de vida de expansão for criado no grupo, a instância sairá do estado Pending Wait somente após o tempo limite do hook de ciclo de vida de expansão expirar. Protected: As instâncias estão protegidas. Instâncias ECS ou de contêiner elástico no estado Protected podem fornecer serviços normalmente, mas você deve gerenciar manualmente o ciclo de vida delas. Standby: As instâncias estão em espera. Instâncias ECS ou de contêiner elástico no estado Standby não podem fornecer serviços conforme esperado e seus pesos de balanceamento de carga são redefinidos para zero. É necessário gerenciar manualmente o ciclo de vida dessas instâncias. Stopped: As instâncias estão paradas. Instâncias ECS, de contêiner elástico ou de terceiros gerenciadas pela Alibaba Cloud no estado Stopped não podem fornecer serviços conforme esperado. Removing: As instâncias estão sendo removidas do grupo de dimensionamento. Durante a remoção de uma instância ECS ou de contêiner elástico do grupo, ela também é desanexada do balanceador de carga associado e seu endereço IP privado é removido da lista de permissões de endereços IP da instância ApsaraDB RDS associada. Removing:Wait: As instâncias estão aguardando para serem removidas do grupo de dimensionamento. Se um hook de ciclo de vida de redução for criado no grupo, a instância sairá do estado Removing Wait somente após o tempo limite do hook de ciclo de vida de redução expirar. Nota Instâncias de terceiros gerenciadas pela Alibaba Cloud não oferecem suporte aos recursos de hook de ciclo de vida, anexação a balanceadores de carga e verificação de saúde.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	B13527BF-1FBD-4334-A512-20F5E9D3****	O ID da solicitação.
PageSize	Integer	10	A quantidade de entradas por página.
PageNumber	Integer	1	O número da página.
TotalSpotCount	Integer	4	O número total de instâncias preemptivas em execução conforme esperado no grupo de dimensionamento.
TotalCount	Integer	1	O número total de instâncias.
ScalingInstances	Array of ScalingInstance		As informações sobre as instâncias.
ScalingInstance
CreationTime	String	2020-05-18T03:11Z	O momento em que as instâncias foram adicionadas ao grupo de dimensionamento. O valor tem precisão de minutos.
LoadBalancerWeight	Integer	50	O peso de balanceamento de carga de cada instância no grupo de dimensionamento. Nota Este parâmetro foi descontinuado. Recomendamos que você não o especifique.
LaunchTemplateId	String	lt-m5e3ofjr1zn1aw7****	O ID do modelo de inicialização.
InstanceId	String	i-bp109k5j3dum1ce6****	O ID da instância.
SpotStrategy	String	SpotWithPriceLimit	A política de preempção das instâncias preemptivas. Valores válidos: SpotWithPriceLimit: As instâncias foram criadas como instâncias preemptivas com um preço máximo por hora definido pelo usuário. SpotAsPriceGo: As instâncias foram criadas como instâncias preemptivas nas quais o preço de mercado no momento da compra foi usado automaticamente como lance.
LaunchTemplateVersion	String	1	O número da versão do modelo de inicialização.
HealthStatus	String	Healthy	O status de saúde da instância. Uma instância ECS ou de contêiner elástico que não esteja no estado Running é considerada não saudável. Valores válidos: Healthy Unhealthy O Auto Scaling remove instâncias ECS ou de contêiner elástico não saudáveis dos grupos de dimensionamento. Se as instâncias não saudáveis foram criadas automaticamente, o Auto Scaling libera essas instâncias após a remoção. O status de gerenciamento da instância determina se as instâncias ECS ou de contêiner elástico adicionadas manualmente a um grupo de dimensionamento serão liberadas. Caso o ciclo de vida das instâncias não seja gerenciado pelo grupo de dimensionamento, o Auto Scaling remove as instâncias do grupo, mas não as libera. Se o ciclo de vida for gerenciado pelo grupo, o Auto Scaling remove e libera as instâncias. Nota Certifique-se de que sua conta Alibaba Cloud tenha saldo suficiente. Se houver pagamentos em atraso na sua conta Alibaba Cloud, todas as instâncias ECS ou de contêiner elástico com pagamento conforme o uso e preemptivas poderão ser interrompidas ou liberadas em casos específicos. Para obter informações sobre como o status das instâncias ECS e de contêineres elásticos muda devido a pagamentos em atraso, consulte Pagamentos em atraso.
ScalingGroupId	String	asg-bp1igpak5ft1flyp****	O ID do grupo de dimensionamento.
WarmupState	String	NoNeedWarmup	O status de aquecimento das instâncias. Valores válidos: NoNeedWarmup: Nenhum aquecimento é necessário. WaitingForInstanceWarmup: As instâncias estão em processo de aquecimento. InstanceWarmupFinish: O aquecimento das instâncias foi concluído.
LifecycleState	String	InService	O status do ciclo de vida das instâncias. Valores válidos: InService: As instâncias foram adicionadas ao grupo de dimensionamento e fornecem serviços conforme esperado. Pending: As instâncias estão sendo adicionadas ao grupo de dimensionamento. Quando uma instância ECS ou de contêiner elástico está sendo adicionada ao grupo, ela também é anexada ao balanceador de carga associado e seu endereço IP privado é incluído na lista de permissões de endereços IP da instância ApsaraDB RDS associada. Pending:Wait: As instâncias estão aguardando para serem adicionadas ao grupo de dimensionamento. Se um hook de ciclo de vida de expansão for criado no grupo, a instância sairá do estado Pending Wait somente após o tempo limite do hook de ciclo de vida de expansão expirar. Protected: As instâncias estão protegidas. Instâncias ECS ou de contêiner elástico no estado Protected podem fornecer serviços normalmente, mas você deve gerenciar manualmente o ciclo de vida delas. Standby: As instâncias estão em espera. Instâncias ECS ou de contêiner elástico no estado Standby não podem fornecer serviços conforme esperado e seus pesos de balanceamento de carga são redefinidos para zero. É necessário gerenciar manualmente o ciclo de vida dessas instâncias. Stopped: As instâncias estão paradas. Instâncias ECS, de contêiner elástico ou de terceiros gerenciadas pela Alibaba Cloud no estado Stopped não podem fornecer serviços conforme esperado. Removing: As instâncias estão sendo removidas do grupo de dimensionamento. Durante a remoção de uma instância ECS ou de contêiner elástico do grupo, ela também é desanexada do balanceador de carga associado e seu endereço IP privado é removido da lista de permissões de endereços IP da instância ApsaraDB RDS associada. Removing:Wait: As instâncias estão aguardando para serem removidas do grupo de dimensionamento. Se um hook de ciclo de vida de redução for criado no grupo, a instância sairá do estado Removing Wait somente após o tempo limite do hook de ciclo de vida de redução expirar. Nota Instâncias de terceiros gerenciadas pela Alibaba Cloud não oferecem suporte aos recursos de hook de ciclo de vida, anexação a balanceadores de carga e verificação de saúde.
CreationType	String	AutoCreated	O método de criação da instância. Valores válidos: AutoCreated: O Auto Scaling cria automaticamente instâncias ECS com base no source de configuração da instância. Attached: Você adiciona manualmente instâncias ECS independentes ao grupo de dimensionamento. Managed: Você adiciona manualmente instâncias de terceiros gerenciadas pela Alibaba Cloud ao grupo de dimensionamento.
ZoneId	String	cn-hangzhou-g	O ID da zona.
ScalingConfigurationId	String	asc-bp1i65jd06v04vdh****	O ID da configuração de dimensionamento.
Entrusted	Boolean	true	Indica se o ciclo de vida das instâncias adicionadas manualmente ao grupo de dimensionamento é gerenciado pelo próprio grupo. Se o grupo gerenciar o ciclo de vida dessas instâncias, o Auto Scaling as liberará após removê-las do grupo. Essa regra de liberação não se aplica a instâncias removidas manualmente. Valores válidos: true false
WeightedCapacity	Integer	4	O peso do tipo de instância, que indica a capacidade de uma única instância desse tipo específico no grupo de dimensionamento. Um peso maior significa que menos instâncias desse tipo são necessárias para atender à capacidade esperada.
CreatedTime	String	2020-05-18T03:11:39Z	O momento em que as instâncias foram adicionadas ao grupo de dimensionamento. O valor tem precisão de segundos.
ScalingActivityId	String	asa-bp1c9djwrgxjyk31****	O ID da atividade de dimensionamento durante a qual as instâncias foram adicionadas ao grupo.
InstanceType	String	ecs.n1.small	O tipo da instância.
ScalingInstanceId	String	asi-j6cj1gcte640ekhb****	O identificador da instância no grupo de dimensionamento. O identificador de uma instância ECS ou de contêiner elástico corresponde ao ID dessa mesma instância.
PrivateIpAddress	String	1.2.1.2*	O endereço IP privado da instância no grupo de dimensionamento.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=DescribeScalingInstances
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&ScalingConfigurationId=asc-bp1i65jd06v04vdh****
&HealthStatus=Healthy
&LifecycleState=InService
&CreationType=AutoCreated
&PageNumber=1
&PageSize=10
&ScalingActivityId=asa-bp1c9djwrgxjyk31****
&InstanceId=["i-bp109k5j3dum1ce6****"]
&CreationTypes=["AutoCreated"]
&LifecycleStates=["InService"]
&<Common request parameters>

Exemplos de respostas de sucesso

XML formato

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

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

JSON formato

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

{
  "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****",
    "InstanceType" : "ecs.n1.small",
    "ScalingInstanceId" : "asi-j6cj1gcte640ekhb****",
    "PrivateIpAddress" : "1**.2*.1**.2**"
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.