Se você precisar aumentar ou diminuir automaticamente o número de instâncias de um tipo específico com base em mudanças de negócios e políticas, poderá configurar um grupo de escalonamento para ajustar automaticamente sua capacidade de computação (ou seja, o número de instâncias). Se os atributos atuais do grupo de escalonamento não atenderem mais aos seus requisitos de negócios, você poderá chamar a operação ModifyScalingGroup para modificar atributos do grupo de escalonamento, como o número máximo de instâncias, o número mínimo de instâncias ou o número esperado de instâncias. Dessa forma, você não precisa criar um grupo de escalonamento novamente nem reconfigurar atributos relacionados, o que economiza tempo e recursos.
Descrição da operação
-
Os seguintes parâmetros não podem ser modificados:
-
RegionId.
-
LoadBalancerId.
NotaPara modificar as instâncias de load balancer associadas, use as operações AttachLoadBalancers e DetachLoadBalancers.
DBInstanceId.
NotaPara modificar as instâncias do ApsaraDB RDS associadas, use as operações AttachDBInstances e DetachDBInstances.
-
-
Você pode chamar esta operação apenas quando o grupo de escalonamento estiver no estado
ActiveouInactive. -
A ativação de uma nova configuração de escalonamento não afeta as instâncias ECS ou instâncias de contêiner elástico que foram criadas com base na configuração de escalonamento anterior e ainda estão em execução.
-
Se você modificar MaxSize e o número de instâncias ECS ou instâncias de contêiner elástico no grupo de escalonamento exceder o novo valor de MaxSize, o grupo de escalonamento removerá automaticamente instâncias ECS ou instâncias de contêiner elástico para tornar a contagem de instâncias igual a MaxSize.
-
Se você modificar MinSize e o número de instâncias ECS ou instâncias de contêiner elástico no grupo de escalonamento for menor que o novo valor de MinSize, o grupo de escalonamento adicionará automaticamente instâncias ECS ou instâncias de contêiner elástico para tornar a contagem de instâncias igual a MinSize.
-
Se DesiredCapacity estiver definido para o grupo de escalonamento e você modificar DesiredCapacity, fazendo com que o número de instâncias ECS ou instâncias de contêiner elástico no grupo de escalonamento fique inconsistente com o novo valor de DesiredCapacity, o grupo de escalonamento adicionará ou removerá automaticamente instâncias ECS ou instâncias de contêiner elástico para tornar a contagem de instâncias igual a DesiredCapacity.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
ess:ModifyScalingGroup |
update |
*ScalingGroup.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| ScalingGroupId |
string |
Sim |
O ID do grupo de escalonamento que você deseja modificar. |
asg-bp1ffogfdauy0jw0**** |
| ScalingGroupName |
string |
Não |
O nome do grupo de escalonamento. O nome deve ser exclusivo dentro de uma região. O nome deve ter de 2 a 64 caracteres e deve começar com um dígito, uma letra maiúscula, uma letra minúscula ou um caractere chinês. O nome pode conter dígitos, sublinhados (_), hifens (-) e pontos (.). |
scalinggroup**** |
| MinSize |
integer |
Não |
O número mínimo de instâncias ECS ou instâncias de contêiner elástico no grupo de escalonamento. Quando o número de instâncias ECS ou de contêiner elástico no grupo de escalonamento for menor que o valor de MinSize, o Auto Scaling executará a criação automática de instâncias ECS ou instâncias de contêiner elástico. Nota
O valor de MinSize deve ser menor ou igual ao valor de MaxSize. |
1 |
| MaxSize |
integer |
Não |
O número máximo de instâncias ECS ou instâncias de contêiner elástico no grupo de escalonamento. Quando o número de instâncias ECS ou de contêiner elástico no grupo de escalonamento exceder o valor de MaxSize, o Auto Scaling removerá automaticamente as instâncias. Os valores válidos de MaxSize dependem do seu uso do Auto Scaling. Acesse o Quota Center para verificar o valor da cota para Número máximo de instâncias em um grupo de escalonamento. Por exemplo, 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. |
99 |
| DefaultCooldown |
integer |
Não |
O tempo de cooldown padrão do grupo de escalonamento. Este parâmetro se aplica apenas ao escalonamento simples. Valores válidos: 0 a 86400. Unidade: segundos. Durante o tempo de cooldown, o grupo de escalonamento não executa outras atividades de escalonamento. Esta restrição se aplica apenas às atividades de escalonamento acionadas por tarefas acionadas por eventos do CloudMonitor. |
600 |
| RemovalPolicies |
array |
Não |
A política de scale-in do grupo de escalonamento para remover instâncias ECS. Valores válidos:
|
|
|
string |
Não |
A política de scale-in do grupo de escalonamento para remover instâncias ECS. Valores válidos:
|
NewestInstance |
|
| ActiveScalingConfigurationId |
string |
Não |
O ID da configuração de escalonamento ativa no grupo de escalonamento. |
asc-bp17pelvl720x5ub**** |
| HealthCheckType |
string |
Não |
O modo de verificação de integridade do grupo de escalonamento. Valores válidos:
Nota
Para ativar tanto as verificações de integridade de instâncias quanto as de load balancer, use o parâmetro |
ECS |
| LaunchTemplateId |
string |
Não |
O ID do modelo de inicialização. Este parâmetro especifica que o grupo de escalonamento obterá as informações de configuração de inicialização a partir do modelo de inicialização. |
lt-m5e3ofjr1zn1aw7**** |
| LaunchTemplateVersion |
string |
Não |
A versão do modelo de inicialização. Valores válidos:
|
Default |
| 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 preferencialmente. Quando o parâmetro |
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 |
20 |
| SpotInstanceRemedy |
boolean |
Não |
Especifica se devem ser complementadas as instâncias spot. Se este parâmetro estiver definido como true, o grupo de escalonamento tentará criar novas instâncias para substituir as instâncias spot que estão prestes a ser recuperadas quando o sistema enviar notificações de recuperação. |
true |
| CompensateWithOnDemand |
boolean |
Não |
Especifica se devem ser criadas automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS quando as instâncias spot não puderem ser criadas devido a motivos como custo ou estoque insuficiente. Este parâmetro entra em vigor apenas quando o parâmetro
|
true |
| SpotInstancePools |
integer |
Não |
O número de tipos de instância disponíveis. O grupo de escalonamento cria instâncias spot de maneira econômica entre os tipos de instância especificados. Valores válidos: 0 a 10. Quando o parâmetro |
5 |
| DesiredCapacity |
integer |
Não |
O número esperado de instâncias ECS ou instâncias de contêiner elástico no grupo de escalonamento. O grupo de escalonamento mantém automaticamente a contagem de instâncias no número esperado de instâncias. Valores válidos: MaxSize ≥ número esperado de instâncias ≥ MinSize. Nota
Se o recurso de número esperado de instâncias for desativado e depois reativado, você deverá definir o valor de |
5 |
| GroupDeletionProtection |
boolean |
Não |
Especifica se a proteção contra exclusão deve ser ativada para o grupo de escalonamento. Valores válidos:
|
true |
| MultiAZPolicy |
string |
Não |
A política de escalonamento para instâncias ECS em um grupo de escalonamento multizona. Valores válidos:
Nota
|
PRIORITY |
| VSwitchIds |
array |
Não |
Os IDs de um ou mais vSwitches. Este parâmetro entra em vigor apenas quando o tipo de rede do grupo de escalonamento é VPC. Os vSwitches especificados devem pertencer à mesma VPC que o grupo de escalonamento. Os vSwitches podem abranger várias zonas. A prioridade dos vSwitches é classificada em ordem crescente de números, onde 1 indica a prioridade mais alta. Quando uma instância ECS não pode ser criada na zona de um vSwitch de prioridade mais alta, o sistema seleciona automaticamente o vSwitch de próxima prioridade para criar a instância. |
|
|
string |
Não |
Os IDs de um ou mais vSwitches. Este parâmetro entra em vigor apenas quando o tipo de rede do grupo de escalonamento é VPC. Os vSwitches especificados devem pertencer à mesma VPC que o grupo de escalonamento. Os vSwitches podem abranger várias zonas. A prioridade dos vSwitches é classificada em ordem crescente de números, onde 1 indica a prioridade mais alta. Quando uma instância ECS não pode ser criada na zona de um vSwitch de prioridade mais alta, o sistema seleciona automaticamente o vSwitch de próxima prioridade para criar a instância. |
vsw-bp1oo2a7isyrb8igf**** |
|
| LaunchTemplateOverrides |
array<object> |
Não |
As informações de tipo de instância para o modelo de inicialização estendido. |
|
|
object |
Não |
As informações de tipo de instância para o modelo de inicialização estendido. |
||
| InstanceType |
string |
Não |
Para permitir que o grupo de escalonamento escale com base na capacidade dos tipos de instância, especifique tanto este parâmetro quanto LaunchTemplateOverrides.WeightedCapacity. Este parâmetro especifica o tipo de instância e substitui o tipo de instância no modelo de inicialização. 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. |
ecs.c5.xlarge |
| WeightedCapacity |
integer |
Não |
Para permitir que o grupo de escalonamento escale com base na capacidade dos tipos de instância, especifique este parâmetro após especificar LaunchTemplateOverrides.InstanceType. Os dois parâmetros têm uma correspondência de um para um. 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:
Para atender à capacidade esperada, o grupo de escalonamento faz o scale-out de duas instâncias ecs.c5.xlarge. Nota
Durante um evento de scale-out, a capacidade do grupo de escalonamento não pode exceder a soma de 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 por hora para o tipo de instância especificado por Nota
Este parâmetro entra em vigor apenas quando o parâmetro |
0.025 |
| MaxInstanceLifetime |
integer |
Não |
A quantidade máxima de tempo que uma instância pode permanecer no grupo de escalonamento. Unidade: segundos. Valores válidos: 0 ou Valor padrão: null. Nota
Este parâmetro não é suportado para grupos de escalonamento do tipo ECI ou grupos de escalonamento com o modo econômico ativado. |
86400 |
| AzBalance |
boolean |
Não |
Especifica se a capacidade do grupo de escalonamento é distribuída uniformemente entre as zonas. Este parâmetro entra em vigor apenas quando o parâmetro
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 tanto à capacidade pay-as-you-go quanto à spot. Este parâmetro entra em vigor apenas quando o parâmetro MultiAZPolicy está definido como COMPOSABLE. Valores válidos:
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 entra em vigor apenas quando o parâmetro
Valor padrão: priority. |
lowestPrice |
| CustomPolicyARN |
string |
Não |
O Alibaba Cloud Resource Name (ARN) da política de scale-in personalizada (Function). Este parâmetro entra em vigor apenas 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 |
| DisableDesiredCapacity |
boolean |
Não |
Especifica se o recurso de número esperado de instâncias deve ser desativado para o grupo de escalonamento. Valores válidos:
Nota
Você pode definir este parâmetro como true (para desativar o recurso de número esperado de instâncias) apenas quando nenhuma atividade de escalonamento estiver em andamento no grupo de escalonamento. Quando o recurso de número esperado de instâncias é desativado, o atributo DesiredCapacity atual do grupo de escalonamento é limpo, mas o número atual de instâncias no grupo de escalonamento permanece inalterado. |
false |
| ScalingPolicy |
string |
Não |
O padrão de recuperação do grupo de escalonamento. Valores válidos:
ScalingPolicy especifica o padrão de recuperação do grupo de escalonamento. 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 |
| HealthCheckTypes |
array |
Não |
Os modos de verificação de integridade do grupo de escalonamento. Nota
Você pode definir vários valores para este parâmetro para ativar várias opções de verificação de integridade. Se o parâmetro HealthCheckType estiver definido, este parâmetro será ignorado. |
|
|
string |
Não |
A lista de modos de verificação de integridade para o grupo de escalonamento. Valores válidos:
Valor padrão: ECS. |
ECS |
|
| StopInstanceTimeout |
integer |
Não |
O período de tempo limite para aguardar que uma instância ECS seja parada durante um processo de scale-in. Unidade: segundos. Valores válidos: 30 a 240. Nota
|
60 |
| CapacityOptions |
object |
Não |
As opções de capacidade. |
|
| OnDemandBaseCapacity |
integer |
Não |
O número mínimo de instâncias pay-as-you-go necessárias no grupo de escalonamento. Quando o número de instâncias pay-as-you-go no grupo de escalonamento for menor que este valor, o sistema criará preferencialmente instâncias pay-as-you-go. Valores válidos: 0 a 1000. Quando o parâmetro |
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 ( Quando o parâmetro |
20 |
| CompensateWithOnDemand |
boolean |
Não |
Especifica se devem ser criadas automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS quando as instâncias spot não puderem ser criadas devido a motivos como custo ou estoque insuficiente. Este parâmetro entra em vigor apenas quando o parâmetro
|
true |
| SpotAutoReplaceOnDemand |
boolean |
Não |
Especifica se devem ser usadas instâncias spot para substituir instâncias pay-as-you-go quando a proporção de pay-as-you-go exceder a proporção
Valor padrão: false. |
true |
| 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:
Valor padrão: PricePerUnit. |
PricePerUnit |
| BalanceMode |
string |
Não |
O modo de balanceamento de zonas. Este parâmetro entra em vigor apenas quando o balanceamento de zonas está ativado. Valores válidos:
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 entra em vigor apenas quando BalancedOnly está ativado para um grupo de escalonamento com balanceamento de zonas. Valores válidos:
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**** |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
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.