Todos os produtos
Search
Central de documentação

Auto Scaling:CreateScalingGroup

Última atualização: Sep 17, 2026

Cria um grupo de escalonamento para ajustar automaticamente a capacidade de computação (o número de instâncias) com base nas mudanças de negócios e políticas, caso você precise aumentar ou diminuir automaticamente o número de instâncias de um tipo especificado.

Descrição da operação

Um grupo de escalonamento é uma coleção de instâncias ECS que atendem aos mesmos cenários comuns.

O número de grupos de escalonamento que podem ser criados em uma região está relacionado ao seu uso do Auto Scaling. Acesse o Centro de Cotas para visualizar o valor da cota para o número total de grupos de escalonamento.

Um grupo de escalonamento não entra em vigor imediatamente após ser criado. Você deve chamar a operação EnableScalingGroup para ativar o grupo de escalonamento antes que ele possa acionar atividades de escalonamento e executar regras de escalonamento.

O grupo de escalonamento, as instâncias associadas do Classic Load Balancer (CLB, anteriormente SLB) e as instâncias associadas do ApsaraDB RDS devem estar na mesma região. Para mais informações, consulte Regiões e zonas.

Se você associar uma instância CLB ao grupo de escalonamento, o grupo de escalonamento adiciona automaticamente as instâncias ECS que ingressam no grupo de escalonamento ao grupo de servidores de backend da instância CLB. Você pode especificar os grupos de servidores aos quais as instâncias ECS são adicionadas. Os dois tipos de grupos de servidores a seguir são suportados:

  • Grupo de servidores padrão: usado para aceitar solicitações de frontend. Se nenhum grupo de servidores virtuais ou grupo de servidores primário/secundário estiver configurado para um listener, as solicitações serão encaminhadas para as instâncias ECS no grupo de servidores padrão por padrão.

  • Grupo de servidores virtuais: use um grupo de servidores virtuais quando desejar encaminhar solicitações diferentes para servidores de backend diferentes, ou quando desejar encaminhar solicitações com base em nomes de domínio ou URLs.

Nota

Se você especificar tanto o grupo de servidores padrão quanto vários grupos de servidores virtuais, as instâncias ECS serão adicionadas a todos esses grupos de servidores.

Depois que uma instância é adicionada ao grupo de servidores de backend de uma instância CLB, o peso da instância é definido como 50 por padrão. A instância CLB deve atender às seguintes condições:

  • A instância CLB deve estar no estado ativo. Você pode chamar a operação DescribeLoadBalancers para consultar o status da instância CLB especificada.

  • As verificações de integridade devem estar ativadas para todas as portas de listener configuradas na instância CLB. Caso contrário, a criação do grupo de escalonamento falhará.

Se você associar um grupo de servidores do Application Load Balancer (ALB), um grupo de servidores do Network Load Balancer (NLB) ou um grupo de servidores do Gateway Load Balancer (GWLB) ao grupo de escalonamento, o grupo de escalonamento adiciona automaticamente as instâncias ECS que ingressam no grupo de escalonamento como servidores de backend do grupo de servidores ALB, NLB ou GWLB para processar solicitações de acesso distribuídas pela instância ALB, NLB ou GWLB. Você pode especificar vários grupos de servidores ALB, NLB ou GWLB, mas os grupos de servidores devem pertencer à mesma VPC que o grupo de escalonamento. Para mais informações, consulte AttachAlbServerGroups ou AttachServerGroups.

Se você associar uma instância do ApsaraDB RDS ao grupo de escalonamento, o grupo de escalonamento adiciona automaticamente os endereços IP internos das instâncias ECS que ingressam no grupo de escalonamento à lista de permissões da instância do ApsaraDB RDS. A instância do ApsaraDB RDS deve atender às seguintes condições:

  • A instância do ApsaraDB RDS deve estar no estado Running. Você pode chamar a operação DescribeDBInstances para consultar o status da instância do ApsaraDB RDS especificada.

  • O número de endereços IP na lista de permissões da instância do ApsaraDB RDS não deve exceder o limite superior. Para mais informações, consulte Configurar uma lista de permissões na documentação do ApsaraDB RDS.

Se o MultiAZPolicy do grupo de escalonamento estiver definido como COST_OPTIMIZED:

  • Quando você especifica os parâmetros OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity e SpotInstancePools, o método de alocação de instâncias sob a política de otimização de custos é especificado, e esse método de alocação é priorizado durante eventos de scale-out e scale-in.

  • Quando você não especifica os parâmetros OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity ou SpotInstancePools, a política de otimização de custos cria instâncias apenas da maneira mais econômica. (Neste modo, as instâncias não podem ser criadas usando garantia de elasticidade ou reserva de capacidade. O parâmetro vSwitch de controladores de interface de rede (NICs) secundários não é suportado.)

Se você definir tags propagáveis para o grupo de escalonamento, ou seja, Tags.Propagate definido como true:

  • As tags no grupo de escalonamento são propagadas apenas para instâncias recém-criadas, não para instâncias que já estão em execução no grupo de escalonamento.

  • Se você especificar tags de instância na configuração de escalonamento e optar por propagar as tags do grupo de escalonamento para a instância, todas as tags coexistirão.

  • Se uma tag propagável no grupo de escalonamento e uma tag na configuração de escalonamento tiverem a mesma chave de tag, o valor da tag na configuração de escalonamento terá precedência.

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

create

*ScalingGroup.

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ScalingGroupName

string

Não

O nome do grupo de escalonamento. O nome deve ser exclusivo em uma região.

O nome deve ter de 2 a 64 caracteres e pode conter letras, dígitos, sublinhados (_), hifens (-) e pontos (.). Deve começar com um dígito, letra ou caractere chinês.

Valor padrão: o valor de ScalingGroupId.

scalinggroup****

LaunchTemplateId

string

Não

O ID do modelo de inicialização do qual o grupo de escalonamento obtém as informações de configuração de inicialização.

lt-m5e3ofjr1zn1aw7****

LaunchTemplateVersion

string

Não

A versão do modelo de inicialização. Valores válidos:

  • Um número de versão fixo do modelo.

  • Default: usa sempre a versão padrão do modelo.

  • Latest: usa sempre a versão mais recente do modelo.

Default

InstanceId

string

Não

O ID da instância. Ao criar um grupo de escalonamento, as informações de configuração necessárias são obtidas da instância especificada, e uma configuração de escalonamento é criada automaticamente.

i-28wt4****

RegionId

string

Sim

O ID da região do grupo de escalonamento. Para mais informações, consulte Regiões e zonas.

cn-qingdao

MinSize

integer

Sim

O número mínimo de instâncias no grupo de escalonamento. Quando o número de instâncias no grupo de escalonamento for menor que o valor de MinSize, o Auto Scaling cria instâncias automaticamente.

Nota

O valor de MinSize deve ser menor ou igual ao valor de MaxSize.

2

MaxSize

integer

Sim

O número máximo de instâncias no grupo de escalonamento. Quando o número de instâncias no grupo de escalonamento for maior que o valor de MaxSize, o Auto Scaling remove instâncias automaticamente.

Os valores válidos de MaxSize estão relacionados ao seu uso do Auto Scaling. Acesse o Quota Center para visualizar o valor da cota para Número máximo de instâncias em um grupo de escalonamento.

Se o valor da cota para Número máximo de instâncias em um grupo de escalonamento for 2000, os valores válidos de MaxSize serão de 0 a 2000.

20

DefaultCooldown

integer

Não

O tempo de cooldown após a conclusão de uma atividade de escalonamento (adição ou remoção de instâncias). Valores válidos: 0 a 86400. Unidade: segundos.

Durante o tempo de cooldown, o grupo de escalonamento não executa outras atividades de escalonamento. Essa restrição se aplica apenas a atividades de escalonamento acionadas por tarefas acionadas por eventos do CloudMonitor.

Valor padrão: 300.

300

LoadBalancerIds

string

Não

Os IDs das instâncias CLB (anteriormente SLB). O valor pode ser uma matriz JSON que consiste em vários IDs de instâncias CLB. Separe os IDs com vírgulas (,).

O número total de instâncias CLB que podem ser associadas a um único grupo de escalonamento está relacionado ao seu uso do Auto Scaling. Acesse o Quota Center para visualizar o valor da cota para Número total de instâncias de load balancer que podem ser associadas a um grupo de escalonamento.

["lb-bp1u7etiogg38yvwz****", "lb-bp168cqrux9ai9l7f****", "lb-bp1jv3m9zvj22ufxp****"]

DBInstanceIds

string

Não

Os IDs das instâncias do ApsaraDB RDS. O valor pode ser uma matriz JSON que consiste em vários IDs de instâncias do ApsaraDB RDS. Separe os IDs com vírgulas (,).

O número total de instâncias do ApsaraDB RDS que podem ser associadas a um único grupo de escalonamento está relacionado ao seu uso do Auto Scaling. Acesse o Quota Center para visualizar o valor da cota para Número total de instâncias RDS que podem ser associadas a um grupo de escalonamento.

["rm-bp142f86de0t7****", "rm-bp18l1z42ar4o****", "rm-bp1lqr97h4aqk****"]

RemovalPolicy.1

string

Não

A estratégia de filtro de primeira rodada para a política de scale-in. Este parâmetro não pode ter o mesmo valor que RemovalPolicy.2 ou RemovalPolicy.3. Valores válidos:

  • OldestInstance: remove a instância ECS que foi adicionada ao grupo de escalonamento há mais tempo.

  • NewestInstance: remove a instância ECS que foi adicionada ao grupo de escalonamento mais recentemente.

  • OldestScalingConfiguration: remove a instância ECS que foi criada a partir da configuração de escalonamento mais antiga.

  • CustomPolicy: remove instâncias ECS com base em uma política de scale-in personalizada (Function).

A configuração de escalonamento mencionada em OldestScalingConfiguration refere-se à fonte de configuração da instância no grupo de escalonamento, incluindo configurações de escalonamento e modelos de inicialização. CustomPolicy pode ser definido apenas como a política de scale-in de primeira rodada. Ao especificar CustomPolicy, você também deve especificar o parâmetro CustomPolicyARN.

Nota

A remoção de instâncias ECS de um grupo de escalonamento também é afetada pela política de escalonamento (MultiAZPolicy) do grupo de escalonamento. Para mais informações, consulte Configurar uma política de combinação para remoção de instâncias.

OldestScalingConfiguration

RemovalPolicy.2

string

Não

A estratégia de filtro de segunda rodada para a política de scale-in. Este parâmetro não pode ter o mesmo valor que RemovalPolicy.1 ou RemovalPolicy.3. Valores válidos:

  • OldestInstance: remove a instância ECS que foi adicionada ao grupo de escalonamento há mais tempo.

  • NewestInstance: remove a instância ECS que foi adicionada ao grupo de escalonamento mais recentemente.

  • OldestScalingConfiguration: remove a instância ECS que foi criada a partir da configuração de escalonamento mais antiga.

Nota

A remoção de instâncias ECS de um grupo de escalonamento também é afetada pela política de escalonamento (MultiAZPolicy) do grupo de escalonamento. Para mais informações, consulte Configurar uma política de combinação para remoção de instâncias.

OldestInstance

RemovalPolicy.3

string

Não

A estratégia de filtro de terceira rodada para a política de scale-in. Este parâmetro não pode ter o mesmo valor que RemovalPolicy.1 ou RemovalPolicy.2. Valores válidos:

  • OldestInstance: remove a instância ECS que foi adicionada ao grupo de escalonamento há mais tempo.

  • NewestInstance: remove a instância ECS que foi adicionada ao grupo de escalonamento mais recentemente.

  • OldestScalingConfiguration: remove a instância ECS que foi criada a partir da configuração de escalonamento mais antiga.

Nota

A remoção de instâncias ECS de um grupo de escalonamento também é afetada pela política de escalonamento (MultiAZPolicy) do grupo de escalonamento. Para mais informações, consulte Configurar uma política de combinação para remoção de instâncias.

NewestInstance

VSwitchId

string

Não

O ID do vSwitch. Se você especificar este parâmetro, o tipo de rede do grupo de escalonamento será VPC.

Nota

Se nem VSwitchId nem VSwitchIds.N forem especificados para o grupo de escalonamento, o tipo de rede do grupo de escalonamento será, por padrão, a rede clássica.

vsw-bp14zolna43z266bq****

MultiAZPolicy

string

Não

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

  • PRIORITY: o vSwitch especificado primeiro (VSwitchIds.N) tem a maior prioridade. O Auto Scaling tenta prioritariamente escalonar instâncias na zona do vSwitch de maior prioridade. Se o escalonamento não puder ser concluído, o Auto Scaling tenta automaticamente escalonar instâncias na zona do vSwitch de próxima prioridade.

  • COST_OPTIMIZED: durante eventos de scale-out, o Auto Scaling tenta criar instâncias ECS em ordem crescente de preço unitário de vCPU. Durante eventos de scale-in, o Auto Scaling tenta remover instâncias ECS em ordem decrescente de preço unitário de vCPU. Se a configuração de escalonamento especificar métodos de cobrança preemptíveis com vários tipos de instância, as instâncias spot serão criadas prioritariamente. Você pode usar o parâmetro CompensateWithOnDemand para especificar se deseja criar automaticamente instâncias pay-as-you-go quando instâncias spot não puderem ser criadas devido a estoque insuficiente ou outros motivos.

    Nota

    COST_OPTIMIZED entra em vigor apenas quando a configuração de escalonamento especifica vários tipos de instância ou usa instâncias spot.

  • BALANCE: as instâncias ECS são alocadas uniformemente nas várias zonas especificadas para o grupo de escalonamento. Se as instâncias ficarem desbalanceadas 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 escalonamento multizona anteriores para instâncias ECS. Você também pode especificar parâmetros adicionais para um controle mais refinado sobre a capacidade do grupo de escalonamento.

Valor padrão: PRIORITY.

PRIORITY

HealthCheckType

string

Não

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

  • NONE: nenhuma verificação de integridade é realizada.

  • ECS: as verificações de integridade são realizadas nas instâncias do grupo de escalonamento. (Grupos de escalonamento do tipo ECS e do tipo ECI usam este valor para ativar as verificações de integridade da instância.)

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

Valor padrão: ECS.

Nota

Para ativar tanto as verificações de integridade da instância quanto as verificações de integridade do load balancer, use o parâmetro HealthCheckTypes.

ECS

ScalingPolicy

string

Não

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

  • recycle: o grupo de escalonamento usa o modo de desligamento e recuperação.

  • release: o grupo de escalonamento usa o modo de liberação.

  • forcerelease: o grupo de escalonamento usa o modo de liberação forçada.

    Nota

    Se você selecionar forcerelease, as instâncias em execução serão liberadas à força durante as atividades de scale-in. Uma liberação forçada é equivalente a uma operação de desligamento, que apaga dados temporários na memória e no armazenamento da instância. Os dados não podem ser recuperados. Prossiga com cautela.

  • forcerecycle: o grupo de escalonamento usa o modo de desligamento e recuperação forçados.

    Nota

    Se você selecionar forcerecycle, as instâncias em execução serão desligadas à força durante as atividades de scale-in. Um desligamento forçado é equivalente a uma operação de desligamento, que apaga dados temporários na memória e no armazenamento da instância. Os dados não podem ser recuperados. Prossiga com cautela.

ScalingPolicy especifica o modo de recuperação do grupo de escalonamento. No entanto, a ação específica executada quando uma instância é removida do grupo de escalonamento é determinada pelo parâmetro RemovePolicy de RemoveInstances. Para mais informações, consulte RemoveInstances.

recycle

ClientToken

string

Não

O token de cliente usado para garantir a idempotência da solicitação.

Gere um valor a partir do seu cliente que seja exclusivo entre diferentes solicitações. O valor pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.

123e4567-e89b-12d3-a456-42665544****

OnDemandBaseCapacity

integer

Não

O número mínimo de instâncias pay-as-you-go necessárias no grupo de escalonamento. Valores válidos: 0 a 1000. Quando o número de instâncias pay-as-you-go for menor que este valor, as instâncias pay-as-you-go serão criadas prioritariamente.

Quando o parâmetro MultiAZPolicy está definido como COMPOSABLE, o valor padrão é 0.

30

OnDemandPercentageAboveBaseCapacity

integer

Não

A porcentagem de instâncias pay-as-you-go entre as instâncias excedentes após o número mínimo de instâncias pay-as-you-go (OnDemandBaseCapacity) ser atendido. Valores válidos: 0 a 100.

Quando o parâmetro MultiAZPolicy está definido como COMPOSABLE, o valor padrão é 100.

20

SpotInstanceRemedy

boolean

Não

Especifica se deve complementar instâncias spot. Se este recurso estiver ativado, o Auto Scaling tentará criar uma nova instância para substituir uma instância spot quando o sistema enviar uma notificação de que a instância spot está prestes a ser recuperada.

true

CompensateWithOnDemand

boolean

Não

Especifica se deve criar automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS quando instâncias spot não puderem ser criadas devido a motivos de preço ou estoque. Este parâmetro entra em vigor apenas quando MultiAZPolicy está definido como COST_OPTIMIZED. Valores válidos:

  • true: permite a criação automática.

  • false: não permite a criação automática.

Valor padrão: true.

true

SpotInstancePools

integer

Não

O número de tipos de instância disponíveis. O Auto Scaling cria uniformemente instâncias spot de vários tipos que oferecem o menor custo. Valores válidos: 1 a 10.

Quando o parâmetro MultiAZPolicy está definido como COMPOSABLE, o valor padrão é 2.

5

DesiredCapacity

integer

Não

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. O valor não pode ser maior que MaxSize ou menor que MinSize.

5

GroupDeletionProtection

boolean

Não

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

  • true: ativa a proteção contra exclusão. O grupo de escalonamento não pode ser excluído.

  • false: desativa a proteção contra exclusão.

Valor padrão: false.

true

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 do Elastic Container Instance (ECI).

Valor padrão: ECS.

ECS

ContainerGroupId

string

Não

O ID da instância ECI, que é o ID do grupo de contêineres.

eci-uf6fonnghi50u374****

VSwitchIds

array

Não

Os IDs de um ou mais vSwitches. Se você especificar o parâmetro VSwitchIds, o parâmetro VSwitchId será ignorado. Se você especificar este parâmetro, o tipo de rede do grupo de escalonamento será VPC.

Ao especificar vários vSwitches:

  • Os vSwitches devem pertencer à mesma VPC.

  • Os vSwitches podem pertencer a zonas diferentes.

  • A prioridade dos vSwitches é determinada em ordem numérica crescente, onde 1 indica a maior prioridade. Quando uma instância ECS não puder ser criada na zona de um vSwitch de maior prioridade, o vSwitch de próxima prioridade será selecionado automaticamente.

Nota

Se nem VSwitchId nem VSwitchIds forem especificados para o grupo de escalonamento, o tipo de rede do grupo de escalonamento será, por padrão, a rede clássica.

vsw-bp14zolna43z266bq****

string

Não

Os IDs de um ou mais vSwitches. Se você especificar o parâmetro VSwitchIds.N, o parâmetro VSwitchId será ignorado. Se você especificar este parâmetro, o tipo de rede do grupo de escalonamento será VPC.

Ao especificar vários vSwitches:

  • Os vSwitches devem pertencer à mesma VPC.

  • Os vSwitches podem pertencer a zonas diferentes.

  • A prioridade dos vSwitches é determinada em ordem numérica crescente, onde 1 indica a maior prioridade. Quando uma instância ECS não puder ser criada na zona de um vSwitch de maior prioridade, o vSwitch de próxima prioridade será selecionado automaticamente.

Nota

Se nem VSwitchId nem VSwitchIds.N forem especificados para o grupo de escalonamento, o tipo de rede do grupo de escalonamento será, por padrão, a rede clássica.

vsw-bp14zolna43z266bq****

LifecycleHook

array<object>

Não

As informações do hook de ciclo de vida.

object

Não

As informações do hook de ciclo de vida.

DefaultResult

string

Não

A ação a ser executada após o término do estado de espera. Valores válidos:

  • CONTINUE: continua a responder ao evento de scale-out ou scale-in.

  • ABANDON: libera a instância ECS criada durante o evento de scale-out, ou remove diretamente a instância ECS do grupo de escalonamento durante o evento de scale-in.

Quando um evento de scale-in (SCALE_IN) ocorre no grupo de escalonamento e aciona vários hooks de ciclo de vida, se o estado de espera de um hook de ciclo de vida com DefaultResult definido como ABANDON terminar, os estados de espera de outros hooks de ciclo de vida correspondentes terminarão antecipadamente. Em outros casos, a ação é determinada pelo último hook de ciclo de vida cujo estado de espera termina.

Valor padrão: CONTINUE.

CONTINUE

LifecycleHookName

string

Não

O nome do hook de ciclo de vida. Depois que o nome é especificado, ele não pode ser modificado. Se não for especificado, o nome será, por padrão, o ID do hook de ciclo de vida.

lifecyclehook****

LifecycleTransition

string

Não

O tipo de atividade de escalonamento à qual o hook de ciclo de vida se aplica. Valores válidos:

  • SCALE_OUT: eventos de scale-out do grupo de escalonamento.

  • SCALE_IN: eventos de scale-in do grupo de escalonamento.

Nota

Se hooks de ciclo de vida forem especificados para o grupo de escalonamento, este parâmetro é obrigatório. Outros parâmetros relacionados são opcionais.

SCALE_OUT

NotificationMetadata

string

Não

As informações de string fixa para o estado de espera da atividade de escalonamento. O valor do parâmetro não pode exceder 128 caracteres. Cada vez que o Auto Scaling envia uma mensagem para o Destinatário da Notificação, ele também envia o valor do parâmetro NotificationMetadata que você especificou, o que ajuda a gerenciar e marcar diferentes categorias de informações de notificação. Este parâmetro entra em vigor apenas quando o parâmetro NotificationArn também é especificado.

Test

NotificationArn

string

Não

O identificador do Destinatário da Notificação para o hook de ciclo de vida. Os seguintes tipos de objetos de notificação são suportados: filas e tópicos do Simple Message Queue (anteriormente MNS). Especifique o valor do parâmetro no seguinte formato: acs:ess:{region}:{account-id}:{resource-relative-id}.

  • region: a região onde o grupo de escalonamento reside.

  • account-id: o ID da conta Alibaba Cloud.

Exemplos:

  • Fila MNS: acs:ess:{region}:{account-id}:queue/{queuename}.

  • Tópico MNS: acs:ess:{region}:{account-id}:topic/{topicname}.

acs:ess:cn-hangzhou:1111111111:queue/queue2

HeartbeatTimeout

integer

Não

O tempo de espera definido pelo hook de ciclo de vida para a atividade do grupo de escalonamento. A próxima ação é executada após o tempo limite do estado de espera. Valores válidos: 30 a 21600. Unidade: segundos.

Após a criação de um hook de ciclo de vida, você pode chamar RecordLifecycleActionHeartbeat para estender o tempo de espera da instância ECS, ou chamar CompleteLifecycleAction para encerrar antecipadamente o estado de espera da atividade de escalonamento.

Valor padrão: 600.

600

VServerGroup

array<object>

Não

As informações sobre os grupos de serviços virtuais associados ao grupo de escalonamento.

array<object>

Não

As informações sobre os grupos de serviços virtuais associados ao grupo de escalonamento.

VServerGroupAttribute

array<object>

Não

Os atributos do grupo de servidores de backend.

object

Não

Os atributos do grupo de servidores de backend.

VServerGroupId

string

Não

O ID do grupo de serviços virtuais.

Para mais informações, consulte AttachVServerGroups.

rsp-bp1443g77****

Weight

integer

Não

O peso da instância como um servidor de backend após o Auto Scaling adicionar a instância ao grupo de serviços virtuais. Um peso maior indica que a instância recebe mais solicitações de acesso. Se o peso for 0, a instância não receberá solicitações de acesso. Valores válidos: 0 a 100. Valor padrão: 50.

Para mais informações, consulte AttachVServerGroups.

100

Port

integer

Não

O número da porta usada pela instância após o Auto Scaling adicionar a instância ao grupo de serviços virtuais. Valores válidos: 1 a 65535.

Para mais informações, consulte AttachVServerGroups.

22

LoadBalancerId

string

Não

O ID da instância CLB (anteriormente SLB) à qual o grupo de serviços virtuais pertence.

Para mais informações, consulte AttachVServerGroups.

lb-bp1u7etiogg38yvwz****

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.

Departamento

Value

string

Não

O valor da tag do grupo de escalonamento.

Finanças

Propagate

boolean

Não

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

  • true: as tags no grupo de escalonamento são propagadas apenas para instâncias recém-criadas, não para instâncias que já estão em execução no grupo de escalonamento.

  • false: as tags no grupo de escalonamento não são propagadas para as instâncias.

Valor padrão: false.

false

LaunchTemplateOverride

array<object>

Não

As informações de substituição do modelo de inicialização.

object

Não

As informações de substituição do modelo de inicialização.

InstanceType

string

Não

Para escalonar o grupo de escalonamento com base na capacidade dos tipos de instância, especifique tanto este parâmetro quanto LaunchTemplateOverride.N.WeightedCapacity.

Este parâmetro especifica o tipo de instância e substitui o tipo de instância no modelo de inicialização. Você pode especificar N valores para este parâmetro para estender o modelo de inicialização para suportar N tipos de instância. Valores válidos de N: 1 a 20.

Nota

Este parâmetro entra em vigor apenas quando o parâmetro LaunchTemplateId especifica um modelo de inicialização.

Valores válidos de InstanceType: tipos de instância ECS disponíveis para compra. Para mais informações, consulte Famílias de instâncias.

ecs.c5.xlarge

WeightedCapacity

integer

Não

Para escalonar o grupo de escalonamento com base na capacidade dos tipos de instância, especifique este parâmetro após especificar LaunchTemplateOverride.N.InstanceType. Os dois parâmetros correspondem um ao outro, e N deve ser consistente.

Este parâmetro especifica o peso do tipo de instância, que representa a capacidade de uma única instância deste tipo no grupo de escalonamento. Um peso maior significa que menos instâncias deste tipo são necessárias para atender à capacidade esperada.

Como os tipos de instância diferem em métricas de desempenho, como o número de vCPUs e o tamanho da memória, você pode atribuir pesos diferentes a diferentes tipos de instância com base em seus requisitos.

Exemplo:

  • Capacidade atual: 0.

  • Capacidade esperada: 6.

  • Capacidade de ecs.c5.xlarge: 4.

Para atender à capacidade esperada, o grupo de escalonamento faz scale-out de 2 instâncias ecs.c5.xlarge.

Nota

Durante eventos de scale-out, a capacidade do grupo de escalonamento não pode exceder a soma da capacidade máxima (MaxSize) e o peso máximo dos tipos de instância.

Valores válidos de WeightedCapacity: 1 a 500.

4

SpotPriceLimit

number

Não

O preço máximo de lance para o tipo de instância especificado por LaunchTemplateOverride.N.InstanceType. Você pode especificar N valores para este parâmetro para estender o modelo de inicialização para suportar N tipos de instância. Valores válidos de N: 1 a 20.

Nota

Este parâmetro entra em vigor apenas quando o parâmetro LaunchTemplateId especifica um modelo de inicialização.

0.025

AlbServerGroup

array<object>

Não

As informações sobre os grupos de servidores ALB.

object

Não

As informações sobre os grupos de servidores ALB.

AlbServerGroupId

string

Não

O ID do grupo de servidores ALB.

N especifica o número do grupo de servidores ALB. O número de grupos de servidores ALB que podem ser associados a um grupo de escalonamento é limitado. Para visualizar ou solicitar um aumento de cota, acesse o Centro de Cotas.

sgp-ddwb0y0g6y9bjm****

Weight

integer

Não

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

N especifica o número do grupo de servidores ALB.

100

Port

integer

Não

O número da porta usada pela instância após o Auto Scaling adicionar a instância ao grupo de servidores ALB. Valores válidos: 1 a 65535.

N especifica o número do grupo de servidores ALB.

Nota

Se os valores de N forem iguais, mas os valores de Port forem diferentes, o sistema associa o grupo de servidores ALB ao grupo de escalonamento várias vezes com portas diferentes.

22

ServerGroup

array<object>

Não

As informações sobre os grupos de servidores de balanceamento de carga.

Nota

Você não pode definir as mesmas informações de grupo de servidores em AlbServerGroups e ServerGroups.

object

Não

As informações sobre os grupos de servidores de balanceamento de carga.

ServerGroupId

string

Não

O ID do grupo de servidores.

sgp-5yc3bd9lfyh*****

Type

string

Não

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

  • ALB: Application Load Balancer (ALB).

  • NLB: Network Load Balancer (NLB).

  • GWLB: Gateway Load Balancer (GWLB).

ALB

Weight

integer

Não

O peso da instância como servidor de backend após o Auto Scaling adicionar a instância ao grupo de servidores. Valores válidos: 0 a 100.

Um peso maior indica que a instância recebe mais solicitações de acesso. Se o peso for 0, a instância não receberá solicitações de acesso.

Nota

Este parâmetro é obrigatório para grupos de servidores de balanceamento de carga ALB e NLB. Você não pode definir este parâmetro para grupos de servidores de balanceamento de carga GWLB.

100

Port

integer

Não

O número da porta usada pela instância após o Auto Scaling adicionar a instância ao grupo de servidores. Valores válidos: 1 a 65535.

Nota

Este parâmetro é obrigatório para grupos de servidores de balanceamento de carga ALB e NLB. Você não pode definir este parâmetro para grupos de servidores de balanceamento de carga GWLB. O valor padrão para GWLB é 6081.

22

AzBalance

boolean

Não

Especifica se a capacidade do grupo de escalonamento deve ser distribuída uniformemente entre várias zonas. Este parâmetro só entra em vigor quando MultiAZPolicy está definido como COMPOSABLE. Valores válidos:

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

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

Valor padrão: false.

false

AllocationStrategy

string

Não

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 aos requisitos de capacidade. A estratégia de alocação de capacidade se aplica às capacidades pagas conforme o uso e spot. Este parâmetro só entra em vigor quando MultiAZPolicy está definido como COMPOSABLE. Valores válidos:

  • priority: As instâncias são criadas com base na ordem dos tipos de instância configurados.

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

Valor padrão: priority.

priority

SpotAllocationStrategy

string

Não

A estratégia de alocação para capacidade spot. Você pode usar este parâmetro para especificar separadamente a estratégia de alocação para capacidade spot. Este parâmetro só entra em vigor quando MultiAZPolicy está definido como COMPOSABLE. Valores válidos:

  • priority: As instâncias são criadas com base na ordem dos tipos de instância configurados.

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

Valor padrão: priority.

lowestPrice

MaxInstanceLifetime

integer

Não

A quantidade máxima de tempo que uma instância pode existir no grupo de escalonamento. Unidade: segundos.

Valores válidos: [86400, Integer.maxValue].

Valor padrão: null.

Nota

Este parâmetro não é compatível com grupos de escalonamento do tipo Elastic Container Instance (ECI) ou grupos de escalonamento com o modo econômico ativado.

86400

CustomPolicyARN

string

Não

O Alibaba Cloud Resource Name (ARN) da função de política de redução de escala personalizada da China. Este parâmetro só entra em vigor quando a primeira política de remoção em RemovalPolicies está definida como CustomPolicy.

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

ResourceGroupId

string

Não

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

Nota

O grupo de escalonamento recém-criado é adicionado ao grupo de recursos especificado. Se você não especificar este parâmetro, o grupo de escalonamento será adicionado ao grupo de recursos padrão.

rg-123****

LoadBalancerConfig

array<object>

Não

As configurações das instâncias do Classic Load Balancer (CLB, anteriormente SLB).

object

Não

As configurações das instâncias do Classic Load Balancer (CLB, anteriormente SLB).

LoadBalancerId

string

Não

O ID da instância do Classic Load Balancer (CLB, anteriormente SLB).

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

Weight

integer

Não

O peso da instância como servidor de backend após o Auto Scaling adicionar a instância ao grupo de servidores CLB (anteriormente SLB). Um peso maior indica que a instância recebe mais solicitações de acesso. Se o peso for 0, a instância não receberá solicitações de acesso.

Valores válidos: 0 a 100.

10

HealthCheckTypes

array

Não

Os modos de verificação de integridade do grupo de escalonamento.

Nota

Você pode usar este parâmetro para especificar vários modos de verificação de integridade. Se o parâmetro HealthCheckType for especificado, este parâmetro será ignorado.

string

Não

Os modos de verificação de integridade do grupo de escalonamento. Valores válidos:

  • NONE: As verificações de integridade estão desativadas.

  • ECS: As verificações de integridade são realizadas nas instâncias do grupo de escalonamento. Este valor se aplica a grupos de escalonamento dos tipos ECS e ECI.

  • LOAD_BALANCER: O status de integridade das instâncias é determinado com base nos resultados da verificação de integridade do balanceamento de carga. O balanceamento de carga do tipo CLB não é compatível.

Valor padrão: ECS.

ECS

DBInstance

array<object>

Não

Os bancos de dados associados ao grupo de escalonamento.

object

Não

A configuração dos bancos de dados associados ao grupo de escalonamento.

DBInstanceId

string

Não

O ID da instância do banco de dados.

rm-m5eqju85s45mu0***

Type

string

Não

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

  • RDS.

  • Redis.

  • MongoDB.

Valor padrão: RDS.

RDS

AttachMode

string

Não

O modo pelo qual o grupo de escalonamento é associado ao banco de dados. Valores válidos:

  • SecurityIp: Modo de lista de permissões de IP. As instâncias adicionadas durante eventos de scale-out são automaticamente adicionadas à lista de permissões de IP do banco de dados. Apenas bancos de dados RDS são compatíveis.

  • SecurityGroup: Modo de grupo de segurança. O grupo de segurança especificado na configuração de escalonamento é adicionado à lista de permissões de grupo de segurança do banco de dados, o que permite que as instâncias no grupo de segurança acessem o banco de dados.

SecurityIp

StopInstanceTimeout

integer

Não

O período de tempo limite para aguardar a parada de uma instância ECS durante um processo de scale-in. Unidade: segundos. Valores válidos: 30 a 240.

Nota
  • Este parâmetro só entra em vigor durante processos de scale-in quando ScalingPolicy está definido como release.

  • Se este parâmetro for especificado, o sistema aguarda até o período StopInstanceTimeout para que a instância pare. Após o tempo limite, o processo de scale-in continua independentemente de a instância ter parado ou não.

  • Se este parâmetro não for especificado, o sistema aguarda indefinidamente para que a instância pare. O processo de scale-in continua somente após a instância parar. Se a instância não conseguir parar, o processo de scale-in é revertido e falha.

60

CapacityOptions

object

Não

As opções de capacidade.

OnDemandBaseCapacity

integer

Não

O número mínimo de instâncias pagas conforme o uso necessárias no grupo de escalonamento. Se 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.

Quando MultiAZPolicy está definido como COMPOSABLE, o valor padrão é 0.

30

OnDemandPercentageAboveBaseCapacity

integer

Não

A porcentagem de instâncias pagas conforme o uso entre as instâncias adicionais que excedem o valor OnDemandBaseCapacity. Valores válidos: 0 a 100.

Quando MultiAZPolicy está definido como COMPOSABLE, o valor padrão é 100.

20

CompensateWithOnDemand

boolean

Não

Especifica se deve criar automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS quando instâncias spot não puderem ser criadas devido a motivos de preço ou estoque. Este parâmetro entra em vigor apenas quando MultiAZPolicy está definido como COST_OPTIMIZED. Valores válidos:

  • true: permite a criação automática.

  • false: não permite a criação automática.

Valor padrão: true.

true

SpotAutoReplaceOnDemand

boolean

Não

Especifica se devem ser usadas instâncias spot para substituir instâncias pagas conforme o uso quando a proporção de instâncias pagas conforme o uso exceder o valor OnDemandPercentageAboveBaseCapacity após a ativação de CompensateWithOnDemand. Um cenário comum é quando instâncias spot são rebaixadas para instâncias pagas conforme o uso devido a problemas de estoque ou preços de instâncias spot causados por CompensateWithOnDemand. Para evitar que instâncias pagas conforme o uso persistam por um período prolongado, o sistema tenta substituir a capacidade excedente paga conforme o uso por instâncias spot. Valores válidos:

  • true: Permitido.

  • false: Não permitido.

Valor padrão: false.

false

PriceComparisonMode

string

Não

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 configurado para o tipo de instância. O peso padrão é 1, o que significa que uma instância ECS ocupa uma capacidade de 1.

  • PricePerVCpu: Compara preços com base no preço por vCPU.

Valor padrão: PricePerUnit.

PricePerUnit

BalanceMode

string

Não

O modo de balanceamento de zonas. Este parâmetro só entra em vigor quando o 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 escalonamento é parcialmente bem-sucedida para evitar um desequilíbrio excessivo de recursos entre as zonas.

Valor padrão: BalancedBestEffort.

BalancedBestEffort

AutoRebalance

boolean

Não

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 um grupo de escalonamento com balanceamento de zonas. Valores válidos:

  • false: O rebalanceamento automático está desativado.

  • true: Quando o rebalanceamento automático está ativado, o grupo de escalonamento monitora automaticamente a capacidade entre as zonas. Se a capacidade estiver desequilibrada entre as zonas, o grupo de escalonamento executa proativamente operações de scale-out e scale-in para rebalancear a capacidade.

Valor padrão: false.

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

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

ScalingGroupId

string

O ID do grupo de escalonamento.

asg-bp14wlu85wrpchm0****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroupId": "asg-bp14wlu85wrpchm0****"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

404 ResourceNotAvailable.VPCNetwork The specified zone does not support vpc network or sold out.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.