Todos os produtos
Search
Central de documentação

Auto Scaling:DescribeScalingGroups

Última atualização: Nov 02, 2026

Consulta os detalhes dos grupos de escalonamento, incluindo informações básicas, instâncias nos grupos de escalonamento e configurações de escalonamento.

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:DescribeScalingGroups

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 à qual o grupo de escalonamento pertence.

cn-qingdao

PageNumber

integer

Não

O número da página da lista de grupos de escalonamento. As páginas começam em 1.

Valor padrão: 1.

1

PageSize

integer

Não

As configurações de paginação especificam o número de entradas a serem retornadas em cada página em uma consulta paginada. Valor máximo: 50.

Valor padrão: 10.

Valores válidos:

  • 10 :

    10

10

ScalingGroupName

string

Não

O nome do grupo de escalonamento.

scalinggroup****

ScalingGroupName.1

string

Não

ScalingGroupName.1 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.2

string

Não

ScalingGroupName.2 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.3

string

Não

ScalingGroupName.3 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.4

string

Não

ScalingGroupName.4 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.5

string

Não

ScalingGroupName.5 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.6

string

Não

ScalingGroupName.6 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.7

string

Não

ScalingGroupName.7 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.8

string

Não

ScalingGroupName.8 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.9

string

Não

ScalingGroupName.9 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.10

string

Não

ScalingGroupName.10 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.11

string

Não

ScalingGroupName.11 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.12

string

Não

ScalingGroupName.12 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.13

string

Não

ScalingGroupName.13 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.14

string

Não

ScalingGroupName.14 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.15

string

Não

ScalingGroupName.15 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.16

string

Não

ScalingGroupName.16 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.17

string

Não

ScalingGroupName.17 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.18

string

Não

ScalingGroupName.18 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.19

string

Não

ScalingGroupName.19 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

ScalingGroupName.20

string

Não

ScalingGroupName.20 especifica o nome do grupo de escalonamento a ser consultado. Nomes de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

scalinggroup****

GroupType

string

Não

O tipo de instâncias gerenciadas pelo grupo de escalonamento. Valores válidos:

  • ECS: O grupo de escalonamento gerencia instâncias ECS.

  • ECI: O grupo de escalonamento gerencia instâncias ECI.

ECS

ScalingGroupId

array

Não

ScalingGroupId.N especifica o ID do grupo de escalonamento a ser consultado. Valores válidos de N: 1 a 20. IDs de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

asg-bp14wlu85wrpchm0****

string

Não

ScalingGroupId.N especifica o ID do grupo de escalonamento a ser consultado. Valores válidos de N: 1 a 20. IDs de grupos de escalonamento inválidos são ignorados e nenhum erro é retornado.

asg-bp14wlu85wrpchm0****

ResourceGroupId

string

Não

O ID do grupo de recursos ao qual o grupo de escalonamento a ser consultado pertence.

Nota

Se nenhum grupo de escalonamento pertencer ao grupo de recursos especificado, o resultado da consulta estará vazio e nenhum erro será retornado.

rg-123****

Tag

array<object>

Não

As tags do grupo de escalonamento.

object

Não

As tags do grupo de escalonamento.

Key

string

Não

A chave da tag do grupo de escalonamento.

Department

Value

string

Não

O valor da tag do grupo de escalonamento.

Finance

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

PageNumber

integer

O número da página atual.

1

PageSize

integer

O número de entradas por página.

10

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ScalingGroups

object

ScalingGroup

array<object>

As informações do grupo de escalonamento.

array<object>

As informações do grupo de escalonamento.

ActiveCapacity

integer

O número de instâncias ECS que foram adicionadas ao grupo de escalonamento e estão em execução normal.

1

ActiveScalingConfigurationId

string

O ID da configuração de escalonamento ativa no grupo de escalonamento.

asc-bp1et2qekq3ojr33****

AlbServerGroups

object

AlbServerGroup

array<object>

A coleção de informações sobre os grupos de servidores ALB.

object

A coleção de informações sobre os grupos de servidores ALB.

AlbServerGroupId

string

O ID do grupo de servidores ALB.

sgp-ddwb0y0g6y9bjm****

Port

integer

O número da porta usada pela instância ECS após o Auto Scaling adicionar a instância ECS ao grupo de servidores ALB.

80

Weight

integer

O peso da instância ECS como servidor de backend após o Auto Scaling adicionar a instância ECS ao grupo de servidores ALB.

100

AllocationStrategy

string

A estratégia de alocação de capacidade que determina como o grupo de escalonamento seleciona os tipos de instância disponíveis para atender à capacidade. A estratégia de distribuição de capacidade se aplica tanto às capacidades pagas conforme o uso quanto às spot. Valores válidos:

  • priority: Cria instâncias na ordem dos tipos de instância configurados.

  • lowestPrice: Cria instâncias em ordem crescente de preço por vCPU para os tipos de instância.

Nota

Este parâmetro só entra em vigor quando o parâmetro MultiAZPolicy está definido como COMPOSABLE.

priority

AutoRebalance

boolean

Especifica se o rebalanceamento automático deve ser ativado para o grupo de escalonamento. Este parâmetro só entra em vigor quando BalancedOnly está ativado para o grupo de escalonamento com balanceamento de zonas. Valores válidos:

  • false: Não ativa o rebalanceamento automático para o grupo de escalonamento.

  • true: Ativa o rebalanceamento automático para o grupo de escalonamento. Quando ativado, o grupo de escalonamento monitora automaticamente a capacidade entre as zonas e aumenta ou reduz a escala de forma proativa para rebalancear a capacidade caso ela fique desequilibrada.

false

AzBalance

boolean

Especifica se a capacidade do grupo de escalonamento está distribuída uniformemente entre várias zonas. Valores válidos:

  • true: A capacidade do grupo de escalonamento está distribuída uniformemente entre várias zonas.

  • false: A capacidade do grupo de escalonamento não está distribuída uniformemente entre várias zonas.

Nota

Este parâmetro só entra em vigor quando o parâmetro MultiAZPolicy está definido como COMPOSABLE.

false

BalanceMode

string

O modo de balanceamento de zonas. Este parâmetro só entra em vigor quando o modo de balanceamento de zonas está ativado. Valores válidos:

  • BalancedBestEffort: Se a criação de recursos falhar em uma zona, o sistema recorre a outras zonas para garantir a entrega de recursos com melhor esforço.

  • BalancedOnly: Se a criação de recursos falhar em uma zona, o sistema não recorre a outras zonas. A atividade de scale-out é parcialmente bem-sucedida para evitar um desequilíbrio excessivo de recursos entre diferentes zonas.

BalancedBestEffort

CapacityOptions

object

As opções de capacidade.

CompensateWithOnDemand

boolean

Especifica se o sistema pode tentar automaticamente criar instâncias pagas conforme o uso para atender ao número necessário de instâncias ECS quando o parâmetro MultiAZPolicy está definido como COST_OPTIMIZED e não é possível criar instâncias spot suficientes devido a restrições de preço ou estoque. Valores válidos:

  • true: Permitido.

  • false: Não permitido.

true

OnDemandBaseCapacity

integer

O número mínimo de instâncias pagas conforme o uso necessárias no grupo de escalonamento. Quando o número de instâncias pagas conforme o uso no grupo de escalonamento for menor que este valor, o sistema cria preferencialmente instâncias pagas conforme o uso. Valores válidos: 0 a 1000.

0

OnDemandPercentageAboveBaseCapacity

integer

A porcentagem de instâncias pagas conforme o uso entre as instâncias adicionais após o grupo de escalonamento atender ao número mínimo de instâncias pagas conforme o uso especificado por OnDemandBaseCapacity. Valores válidos: 0 a 100.

0

PriceComparisonMode

string

O modo de comparação de preços para a estratégia de otimização de custos do grupo de escalonamento. Valores válidos:

  • PricePerUnit: Compara preços com base no preço por unidade de capacidade. A capacidade de uma instância no grupo de escalonamento é igual ao peso definido para o tipo de instância. O peso padrão é 1, o que significa que uma instância ECS corresponde a 1 unidade de capacidade.

  • PricePerVCpu: Compara preços com base no preço por vCPU. Valor padrão: PricePerUnit.

PricePerUnit

SpotAutoReplaceOnDemand

boolean

Especifica se deve ser tentada a substituição da capacidade paga conforme o uso por instâncias spot quando CompensateWithOnDemand está ativado e a proporção de instâncias pagas conforme o uso excede o valor de OnDemandPercentageAboveBaseCapacity. Em cenários comuns em que CompensateWithOnDemand rebaixa instâncias spot para instâncias pagas conforme o uso devido a restrições de estoque ou preço de instâncias spot, este recurso tenta substituir o excesso de capacidade paga conforme o uso por instâncias spot para evitar a retenção de longo prazo de instâncias pagas conforme o uso. Valores válidos:

  • true: Permitido.

  • false: Não permitido.

false

CompensateWithOnDemand

boolean

Especifica se o sistema pode tentar automaticamente criar instâncias pagas conforme o uso para atender ao número necessário de instâncias ECS quando o parâmetro MultiAZPolicy está definido como COST_OPTIMIZED e não é possível criar instâncias spot suficientes devido a restrições de preço ou estoque. Valores válidos:

  • true: Permitido.

  • false: Não permitido.

true

CreationTime

string

A hora em que o grupo de escalonamento foi criado.

2014-08-14T10:58Z

CustomPolicyARN

string

O ARN da função do Function Compute para a política de scale-in personalizada. Este parâmetro só entra em vigor quando a primeira política de remoção configurada em RemovalPolicies é CustomPolicy.

acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name

DBInstanceIds

object

DBInstanceId

array

O ID da instância do ApsaraDB RDS associada ao grupo de escalonamento.

string

O ID da instância do ApsaraDB RDS associada ao grupo de escalonamento.

rm-bp15556qzebg1****

DBInstances

object

DBInstance

array<object>

A lista de bancos de dados associados ao grupo de escalonamento.

array<object>

As informações de configuração do banco de dados associado ao grupo de escalonamento.

DBInstanceId

string

O ID da instância do banco de dados.

rm-m5eqju85s45mu0***

SecurityGroupIds

object

SecurityGroupId

array

A lista de listas de permissões de grupos de segurança adicionadas ao banco de dados pelo grupo de escalonamento.

string

Especifica se o grupo de escalonamento remove os grupos de segurança na lista de bancos de dados associados da lista de permissões do grupo de segurança do banco de dados. Este parâmetro é válido para a lista de bancos de dados associados somente quando o parâmetro AttachMode na operação CreateScalingGroup está definido como SecurityGroup. Valores válidos:

  • true: Remove os grupos de segurança nesta lista da lista de permissões do grupo de segurança do banco de dados.

  • false: Não remove os grupos de segurança nesta lista da lista de permissões do grupo de segurança do banco de dados.

sg-uf65zt66cf2a0q47***

Type

string

O tipo de banco de dados. Valores válidos:

  • RDS

  • Redis

  • MongoDB

RDS

DefaultCooldown

integer

O tempo de resfriamento padrão do grupo de escalonamento. Durante o tempo de resfriamento, o grupo de escalonamento não executa nenhuma outra atividade de escalonamento. Este parâmetro se aplica apenas à atividade de escalonamento acionada por nós de tarefas acionadas por eventos do Cloud Monitoring.

60

DesiredCapacity

integer

O número esperado de instâncias no grupo de escalonamento. O grupo de escalonamento mantém automaticamente o número de instâncias ECS no número esperado de instâncias.

5

EnableDesiredCapacity

boolean

Especifica se o recurso de número esperado de instâncias deve ser ativado. Valores válidos:

  • true: Ativado. O número esperado de instâncias é retornado após a consulta do grupo de escalonamento.

  • false: Desativado. O número esperado de instâncias não é retornado após a consulta do grupo de escalonamento.

false

GroupDeletionProtection

boolean

Especifica se a proteção contra exclusão está ativada para o grupo de escalonamento. Valores válidos:

  • true: A proteção contra exclusão está ativada para o grupo de escalonamento. Nesse caso, o grupo de escalonamento não pode ser excluído.

  • false: A proteção contra exclusão está desativada para o grupo de escalonamento.

true

GroupType

string

O tipo de instâncias gerenciadas pelo grupo de escalonamento.

ECS

HealthCheckType

string

O modo de verificação de integridade do grupo de escalonamento. Valores válidos:

  • NONE: Não realiza verificações de integridade.

  • ECS: Realiza verificações de integridade nas instâncias no grupo de escalonamento. Este valor é usado para ativar verificações de integridade de instâncias para grupos de escalonamento ECS e ECI.

  • LOAD_BALANCER: Determina o status de integridade das instâncias com base nos resultados da verificação de integridade do load balancer (o tipo de load balancer CLB não é suportado atualmente).

ECS

HealthCheckTypes

object

HealthCheckType

array

O modo de verificação de integridade do grupo de escalonamento. Valores válidos:

  • NONE: Não realiza verificações de integridade.

  • ECS: Realiza verificações de integridade nas instâncias no grupo de escalonamento. Este valor é usado para ativar verificações de integridade de instâncias para grupos de escalonamento ECS e ECI.

  • LOAD_BALANCER: Determina o status de integridade das instâncias com base nos resultados da verificação de integridade do load balancer (o tipo de load balancer CLB não é suportado atualmente).

string

O modo de verificação de integridade do grupo de escalonamento. Valores válidos:

  • NONE: Não realiza verificações de integridade.

  • ECS: Realiza verificações de integridade nas instâncias no grupo de escalonamento. Este valor é usado para ativar verificações de integridade de instâncias para grupos de escalonamento ECS e ECI.

  • LOAD_BALANCER: Determina o status de integridade das instâncias com base nos resultados da verificação de integridade do load balancer (o tipo de load balancer CLB não é suportado atualmente).

ECS

InitCapacity

integer

O número de instâncias no estado de inicialização antes do scale-out no grupo de escalonamento.

0

LaunchTemplateId

string

O ID do modelo de inicialização usado pelo grupo de escalonamento.

lt-m5e3ofjr1zn1aw7****

LaunchTemplateOverrides

object

LaunchTemplateOverride

array<object>

As informações do tipo de instância que estendem o modelo de inicialização.

object

As informações do tipo de instância que estendem o modelo de inicialização.

InstanceType

string

O tipo de instância especificado, que substitui o tipo de instância no modelo de inicialização.

ecs.c5.xlarge

SpotPriceLimit

number

O preço máximo por hora para o tipo de instância que substitui o modelo de inicialização (ou seja, LaunchTemplateOverride.N.InstanceType). Você pode especificar N valores para este parâmetro para estender o modelo de inicialização com N tipos de instância. Valores válidos de N: 1 a 10.

Nota

Este parâmetro só entra em vigor quando o parâmetro LaunchTemplateId é especificado.

0.025

WeightedCapacity

integer

O peso do tipo de instância especificado, que indica a capacidade que uma única instância deste tipo de instância fornece no grupo de escalonamento. Um peso maior indica que menos instâncias deste tipo de instância são necessárias para atender à capacidade esperada.

4

LaunchTemplateVersion

string

A versão do modelo de inicialização usado pelo grupo de escalonamento.

Default

LifecycleState

string

O estado do ciclo de vida do grupo de escalonamento. Valores válidos:

  • Active: O grupo de escalonamento está ativo. Apenas grupos de escalonamento ativos podem aceitar solicitações para executar regras de escalonamento e acionar uma atividade de escalonamento.

  • Inactive: O grupo de escalonamento está inativo. Grupos de escalonamento inativos não recebem nenhuma solicitação para executar regras de escalonamento.

  • Deleting: O grupo de escalonamento está sendo excluído. Grupos de escalonamento no estado de exclusão não recebem nenhuma solicitação para executar regras de escalonamento e seus parâmetros não podem ser modificados.

Active

LoadBalancerConfigs

object

LoadBalancerConfig

array<object>

A lista de configurações do load balancer CLB (anteriormente SLB).

object

A lista de configurações do load balancer CLB (anteriormente SLB).

LoadBalancerId

string

O ID da instância do load balancer CLB (anteriormente SLB).

147b46d767c-cn-qingdao-cm5****

Weight

integer

O peso da instância ECS como servidor de backend após o Auto Scaling adicionar a instância ECS ao grupo de servidores do load balancer CLB. Um peso maior indica que mais solicitações de acesso são alocadas para a instância ECS. Se o peso for 0, a instância ECS não recebe solicitações de acesso. Valores válidos: 0 a 100.

10

LoadBalancerIds

object

LoadBalancerId

array

A lista de IDs de instância das instâncias de load balancer associadas ao grupo de escalonamento.

string

A lista de IDs de instância das instâncias de load balancer associadas ao grupo de escalonamento.

lb-bp19byhscefk3x0li****

MaxInstanceLifetime

integer

O tempo de vida máximo de uma instância no grupo de escalonamento. Unidade: segundos. Valores válidos: 0 ou [86400, Integer.maxValue]. Um valor de 0 indica que o valor configurado de MaxInstanceLifetime foi limpo (ou seja, MaxInstanceLifetime não está definido). Valor padrão: null.

Nota

Este parâmetro não é suportado para grupos de escalonamento ECI ou grupos de escalonamento que ativam o recurso Sem Taxas para Instâncias Paradas.

null

MaxSize

integer

O número máximo de instâncias ECS no grupo de escalonamento.

2

MinSize

integer

O número mínimo de instâncias ECS no grupo de escalonamento.

1

ModificationTime

string

A hora em que o grupo de escalonamento foi modificado pela última vez.

2014-08-14T10:58Z

MonitorGroupId

string

O ID do grupo de aplicativos do CloudMonitor associado ao grupo de escalonamento.

1497****

MultiAZPolicy

string

A política de scale-out e scale-in para instâncias ECS em um grupo de escalonamento multizona. Valores válidos:

  • PRIORITY: Escalona instâncias com base nos vSwitches (VSwitchIds.N) que você define. Se não for possível criar instâncias ECS na zona do vSwitch com a prioridade mais alta, o sistema usa automaticamente o vSwitch com a próxima prioridade mais alta para criar instâncias ECS.

  • COST_OPTIMIZED: Tenta criar instâncias em ordem crescente de preço por vCPU. Se as configurações de escalonamento especificarem vários tipos de instância que usam o método de faturamento spot, o sistema cria preferencialmente as instâncias spot correspondentes. Você pode usar o parâmetro CompensateWithOnDemand para especificar se o sistema deve tentar automaticamente criar instâncias pagas conforme o uso quando não for possível criar instâncias spot devido a restrições de estoque ou outros motivos.

    Nota

    COST_OPTIMIZED só entra em vigor quando as configurações de escalonamento especificam vários tipos de instância ou usam instâncias spot.

  • BALANCE: Aloca instâncias ECS uniformemente entre as várias zonas especificadas para o grupo de escalonamento. Se as instâncias ficarem desequilibradas entre as zonas devido a estoque insuficiente ou outros motivos, você pode chamar a operação RebalanceInstance para rebalancear os recursos.

  • COMPOSABLE: Uma política componível que permite combinar as políticas de scale-out e scale-in anteriores para instâncias ECS em um grupo de escalonamento multizona com base em seus requisitos.

PRIORITY

OnDemandBaseCapacity

integer

O número mínimo de instâncias pagas conforme o uso necessárias no grupo de escalonamento. Valores válidos: 0 a 1000. Quando o número de instâncias pagas conforme o uso no grupo de escalonamento for menor que este valor mínimo, o sistema cria preferencialmente instâncias pagas conforme o uso. Valor padrão: 0 quando o parâmetro MultiAZPolicy está definido como COMPOSABLE.

30

OnDemandPercentageAboveBaseCapacity

integer

A porcentagem de instâncias pagas conforme o uso entre as instâncias adicionais após o grupo de escalonamento atender ao número mínimo de instâncias pagas conforme o uso especificado por OnDemandBaseCapacity. Valores válidos: 0 a 100. Valor padrão: 100 quando o parâmetro MultiAZPolicy está definido como COMPOSABLE.

20

PendingCapacity

integer

O número de instâncias ECS que estão sendo adicionadas ao grupo de escalonamento, mas que ainda não concluíram as configurações relevantes.

0

PendingWaitCapacity

integer

O número de instâncias ECS no estado de espera pendente no grupo de escalonamento.

1

ProtectedCapacity

integer

O número de instâncias ECS no estado protegido no grupo de escalonamento.

1

RegionId

string

O ID da região à qual o grupo de escalonamento pertence.

cn-qingdao

RemovalPolicies

object

RemovalPolicy

array

A coleção de políticas para remover instâncias ECS do grupo de escalonamento. Valores válidos:

  • OldestInstance: Remove as instâncias ECS que foram criadas primeiro.

  • NewestInstance: Remove as instâncias ECS que foram criadas mais recentemente.

  • OldestScalingConfiguration: Remove as instâncias ECS que foram criadas primeiro pela configuração de escalonamento.

  • CustomPolicy: Remove instâncias ECS com base na função do Function Compute para a política de scale-in personalizada.

string

A coleção de políticas para remover instâncias ECS do grupo de escalonamento. Valores válidos:

  • OldestInstance: Remove as instâncias ECS que foram criadas primeiro.

  • NewestInstance: Remove as instâncias ECS que foram criadas mais recentemente.

  • OldestScalingConfiguration: Remove as instâncias ECS que foram criadas primeiro pela configuração de escalonamento.

  • CustomPolicy: Remove instâncias ECS com base na função do Function Compute para a política de scale-in personalizada.

OldestScalingConfiguration

RemovingCapacity

integer

O número de instâncias ECS que estão sendo removidas do grupo de escalonamento.

0

RemovingWaitCapacity

integer

O número de instâncias ECS no estado de espera de remoção no grupo de escalonamento.

1

ResourceGroupId

string

O ID do grupo de recursos ao qual o grupo de escalonamento pertence.

rg-123****

ScalingGroupId

string

O ID do grupo de escalonamento.

asg-bp14wlu85wrpchm0****

ScalingGroupName

string

O nome do grupo de escalonamento.

dyrSuvBOtO1dEdIlIbp****

ScalingPolicy

string

O modo de recuperação do grupo de escalonamento. Valores válidos:

  • recycle: O modo de recuperação do grupo de escalonamento é desligar e recuperar.

  • release: O modo de recuperação do grupo de escalonamento é liberar.

  • forcerelease: O modo de recuperação do grupo de escalonamento é liberação forçada. Para obter mais informações sobre as ações em instâncias removidas, consulte RemoveInstances.

recycle

ServerGroups

object

ServerGroup

array<object>

A coleção de informações sobre os grupos de servidores de load balancer.

Nota

Você pode usar este parâmetro para obter a coleção de informações sobre os grupos de serviços ALB, grupos de servidores NLB e grupos de serviços GWLB associados ao grupo de escalonamento.

object

A coleção de informações sobre os grupos de servidores de load balancer.

Port

integer

O número da porta usado pela instância ECS após o Auto Scaling adicionar a instância ao grupo de servidores.

80

ServerGroupId

string

O ID do grupo de servidores.

sgp-i9ouakeaerr*****

Type

string

O tipo do grupo de servidores. Valores válidos:

  • ALB: balanceamento de carga de aplicação (Application Load Balancer).

  • NLB: Network Load Balancer (NLB).

  • GWLB: Gateway Load Balancer (GWLB).

ALB

Weight

integer

O peso da instância ECS como servidor de backend após o Auto Scaling adicionar a instância ao grupo de servidores.

100

SpotAllocationStrategy

string

A política de distribuição para capacidade spot. Você pode usar este parâmetro para especificar a política de distribuição para capacidade spot. Este parâmetro entra em vigor apenas quando o parâmetro MultiAZPolicy é definido como COMPOSABLE. Valores válidos:

  • priority: Cria instâncias na ordem dos tipos de instância configurados.

  • lowestPrice: Cria instâncias com base no preço unitário por vCPU dos tipos de instância em ordem crescente.

lowestPrice

SpotCapacity

integer

O número de instâncias spot no grupo de escalonamento.

0

SpotInstancePools

integer

O número de tipos de instância disponíveis. O grupo de escalonamento cria instâncias spot uniformemente entre o número especificado de tipos de instância com os menores custos. Valores válidos: 0 a 10.

Valor padrão: 2 quando o parâmetro MultiAZPolicy é definido como COMPOSABLE.

5

SpotInstanceRemedy

boolean

Indica se deve ativar o recurso de reposição de instâncias spot. Após a ativação desse recurso, o grupo de escalonamento tenta criar novas instâncias para substituir as instâncias spot que estão prestes a ser recuperadas quando uma mensagem do sistema sobre a recuperação é recebida.

true

StandbyCapacity

integer

O número de instâncias no estado de espera no grupo de escalonamento.

1

StopInstanceTimeout

integer

O tempo limite de espera para que uma instância ECS seja parada durante um processo de scale-in. Unidade: segundos.

60

StoppedCapacity

integer

O número de instâncias no modo econômico no grupo de escalonamento.

1

SuspendedProcesses

object

SuspendedProcess

array

Os processos suspensos. Se nenhum processo estiver suspenso, um valor vazio será retornado. Valores válidos:

  • ScaleIn: processo de scale-in.

  • ScaleOut: processo de scale-out.

  • HealthCheck: verificação de integridade.

  • AlarmNotification: tarefa acionada por evento.

  • ScheduledAction: tarefa agendada.

string

Os processos suspensos. Se nenhum processo estiver suspenso, um valor vazio será retornado. Valores válidos:

  • ScaleIn: processo de scale-in.

  • ScaleOut: processo de scale-out.

  • HealthCheck: verificação de integridade.

  • AlarmNotification: tarefa acionada por evento.

  • ScheduledAction: tarefa agendada.

ScaleIn

SystemSuspended

boolean

Indica se o Auto Scaling para de executar a atividade de escalonamento no grupo de escalonamento. Valores válidos:

  • true: O Auto Scaling para de executar a atividade de escalonamento no grupo de escalonamento. Isso indica que o grupo de escalonamento falhou ao executar atividades de scale-out ou scale-in por mais de 7 dias consecutivos. Você deve modificar o grupo de escalonamento ou a configuração de escalonamento para recuperar a execução da atividade de escalonamento.

  • false: O Auto Scaling executa a atividade de escalonamento no grupo de escalonamento.

true

Tags

object

Tag

array<object>

As tags do grupo de escalonamento.

object

As tags do grupo de escalonamento.

Propagate

boolean

Indica se a tag é propagada. Valores válidos:

  • true: A tag no grupo de escalonamento é propagada apenas para instâncias recém-criadas, mas não para instâncias existentes no grupo de escalonamento.

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

Valor padrão: false.

false

TagKey

string

A chave da tag do grupo de escalonamento.

Department

TagValue

string

O valor da tag do grupo de escalonamento.

Finance

TotalCapacity

integer

A capacidade total ponderada de todas as instâncias ECS no grupo de escalonamento se os pesos dos tipos de instância estiverem configurados. Caso contrário, este parâmetro indica o número total de instâncias ECS no grupo de escalonamento.

1

TotalInstanceCount

integer

O número total de instâncias ECS no grupo de escalonamento.

1

VServerGroups

object

VServerGroup

array<object>

A lista de grupos de servidores de backend.

array<object>

A lista de grupos de servidores de backend.

LoadBalancerId

string

O ID da instância de load balancer à qual o grupo de servidores de backend pertence.

147b46d767c-cn-qingdao-cm5****

VServerGroupAttributes

object

VServerGroupAttribute

array<object>

Os atributos do grupo de servidores de backend.

object

Os atributos do grupo de servidores de backend.

Port

integer

O número da porta usado pela instância de load balancer para fornecer serviços externos.

22

VServerGroupId

string

O ID do grupo de servidores de backend.

rsp-bp12bjrny****

Weight

integer

O peso do grupo de servidores de backend.

1

VSwitchId

string

O ID do vSwitch associado ao grupo de escalonamento.

vsw-bp1whw2u46cn8zubm****

VSwitchIds

object

VSwitchId

array

Os IDs dos vSwitches associados ao grupo de escalonamento. Se você especificar o parâmetro VSwitchIds, o parâmetro VSwitchId será ignorado.

string

Os IDs dos vSwitches associados ao grupo de escalonamento. Se você especificar o parâmetro VSwitchIds, o parâmetro VSwitchId será ignorado.

vsw-bp1whw2u46cn8zubm****

VpcId

string

O ID da virtual private cloud (VPC) à qual o grupo de escalonamento pertence.

vpc-bp1vwnn14rqpyiczj****

WarmPoolCapacity

integer

O número de instâncias no warm pool.

5

WarmPoolConfiguration

object

A configuração do warm pool do grupo de escalonamento.

CapacityOptions

object

A configuração de capacidade do warm pool.

DesiredGroupPreparedCapacity

integer

O número esperado de instâncias aquecidas. A soma do número de instâncias no grupo de escalonamento e o número de instâncias no warm pool é sempre igual à capacidade esperada do warm pool.

5

MinCapacity

integer

O número mínimo de instâncias a serem mantidas no warm pool.

0

InstanceReusePolicy

object

A política de recuperação de instâncias.

ReuseOnScaleIn

boolean

Indica se as instâncias são adicionadas de volta ao warm pool durante um processo de scale-in.

PoolState

string

O status da instância no warm pool. Valores válidos:

  • Stopped: modo econômico.

  • Running: em execução.

Running

Status

string

O status do warm pool. Valores válidos:

  • Active: ativo.

  • Deleting: excluindo.

Active

TotalCount

integer

O número total de grupos de escalonamento.

1

Exemplos

Resposta de sucesso

JSON formato

{
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroups": {
    "ScalingGroup": [
      {
        "ActiveCapacity": 1,
        "ActiveScalingConfigurationId": "asc-bp1et2qekq3ojr33****",
        "AlbServerGroups": {
          "AlbServerGroup": [
            {
              "AlbServerGroupId": "sgp-ddwb0y0g6y9bjm****",
              "Port": 80,
              "Weight": 100
            }
          ]
        },
        "AllocationStrategy": "priority",
        "AutoRebalance": false,
        "AzBalance": false,
        "BalanceMode": "BalancedBestEffort",
        "CapacityOptions": {
          "CompensateWithOnDemand": true,
          "OnDemandBaseCapacity": 0,
          "OnDemandPercentageAboveBaseCapacity": 0,
          "PriceComparisonMode": "PricePerUnit",
          "SpotAutoReplaceOnDemand": false
        },
        "CompensateWithOnDemand": true,
        "CreationTime": "2014-08-14T10:58Z",
        "CustomPolicyARN": "acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name",
        "DBInstanceIds": {
          "DBInstanceId": [
            "rm-bp15556qzebg1****"
          ]
        },
        "DBInstances": {
          "DBInstance": [
            {
              "DBInstanceId": "rm-m5eqju85s45mu0***",
              "SecurityGroupIds": {
                "SecurityGroupId": [
                  "sg-uf65zt66cf2a0q47***"
                ]
              },
              "Type": "RDS"
            }
          ]
        },
        "DefaultCooldown": 60,
        "DesiredCapacity": 5,
        "EnableDesiredCapacity": false,
        "GroupDeletionProtection": true,
        "GroupType": "ECS",
        "HealthCheckType": "ECS",
        "HealthCheckTypes": {
          "HealthCheckType": [
            "ECS"
          ]
        },
        "InitCapacity": 0,
        "LaunchTemplateId": "lt-m5e3ofjr1zn1aw7****",
        "LaunchTemplateOverrides": {
          "LaunchTemplateOverride": [
            {
              "InstanceType": "ecs.c5.xlarge",
              "SpotPriceLimit": 0.025,
              "WeightedCapacity": 4
            }
          ]
        },
        "LaunchTemplateVersion": "Default",
        "LifecycleState": "Active",
        "LoadBalancerConfigs": {
          "LoadBalancerConfig": [
            {
              "LoadBalancerId": "147b46d767c-cn-qingdao-cm5****",
              "Weight": 10
            }
          ]
        },
        "LoadBalancerIds": {
          "LoadBalancerId": [
            "lb-bp19byhscefk3x0li****"
          ]
        },
        "MaxInstanceLifetime": 0,
        "MaxSize": 2,
        "MinSize": 1,
        "ModificationTime": "2014-08-14T10:58Z",
        "MonitorGroupId": "1497****",
        "MultiAZPolicy": "PRIORITY",
        "OnDemandBaseCapacity": 30,
        "OnDemandPercentageAboveBaseCapacity": 20,
        "PendingCapacity": 0,
        "PendingWaitCapacity": 1,
        "ProtectedCapacity": 1,
        "RegionId": "cn-qingdao",
        "RemovalPolicies": {
          "RemovalPolicy": [
            "OldestScalingConfiguration"
          ]
        },
        "RemovingCapacity": 0,
        "RemovingWaitCapacity": 1,
        "ResourceGroupId": "rg-123****",
        "ScalingGroupId": "asg-bp14wlu85wrpchm0****",
        "ScalingGroupName": "dyrSuvBOtO1dEdIlIbp****",
        "ScalingPolicy": "recycle",
        "ServerGroups": {
          "ServerGroup": [
            {
              "Port": 80,
              "ServerGroupId": "sgp-i9ouakeaerr*****",
              "Type": "ALB",
              "Weight": 100
            }
          ]
        },
        "SpotAllocationStrategy": "lowestPrice",
        "SpotCapacity": 0,
        "SpotInstancePools": 5,
        "SpotInstanceRemedy": true,
        "StandbyCapacity": 1,
        "StopInstanceTimeout": 60,
        "StoppedCapacity": 1,
        "SuspendedProcesses": {
          "SuspendedProcess": [
            "ScaleIn"
          ]
        },
        "SystemSuspended": true,
        "Tags": {
          "Tag": [
            {
              "Propagate": false,
              "TagKey": "Departamento",
              "TagValue": "Finanças"
            }
          ]
        },
        "TotalCapacity": 1,
        "TotalInstanceCount": 1,
        "VServerGroups": {
          "VServerGroup": [
            {
              "LoadBalancerId": "147b46d767c-cn-qingdao-cm5****",
              "VServerGroupAttributes": {
                "VServerGroupAttribute": [
                  {
                    "Port": 22,
                    "VServerGroupId": "rsp-bp12bjrny****",
                    "Weight": 1
                  }
                ]
              }
            }
          ]
        },
        "VSwitchId": "vsw-bp1whw2u46cn8zubm****",
        "VSwitchIds": {
          "VSwitchId": [
            "vsw-bp1whw2u46cn8zubm****"
          ]
        },
        "VpcId": "vpc-bp1vwnn14rqpyiczj****",
        "WarmPoolCapacity": 5,
        "WarmPoolConfiguration": {
          "CapacityOptions": {
            "DesiredGroupPreparedCapacity": 5,
            "MinCapacity": 0
          },
          "InstanceReusePolicy": {
            "ReuseOnScaleIn": false
          },
          "PoolState": "Running",
          "Status": "Active"
        }
      }
    ]
  },
  "TotalCount": 1
}

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.