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ê pode 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 ou reconfigurar atributos relacionados, o que economiza tempo e recursos.
Descrição da operação
Descrição da operação
-
Os seguintes parâmetros não podem ser modificados:
-
RegionId
-
LoadBalancerId
NotaPara modificar instâncias de load balancer, use as operações AttachLoadBalancers e DetachLoadBalancers.
-
DBInstanceId
NotaPara modificar instâncias do ApsaraDB RDS, use as operações AttachDBInstances e DetachDBInstances.
-
-
Você pode invocar esta operação apenas quando o grupo de escalonamento estiver no estado Active ou Inactive.
-
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 de contêiner elástico no grupo de escalonamento exceder o novo valor de MaxSize, o Auto Scaling remove automaticamente instâncias do grupo de escalonamento até que o número de instâncias seja igual ao valor de MaxSize.
-
Se você modificar MinSize e o número de instâncias ECS ou de contêiner elástico no grupo de escalonamento for menor que o novo valor de MinSize, o Auto Scaling adiciona automaticamente instâncias ao grupo de escalonamento até que o número de instâncias seja igual ao valor de MinSize.
-
Se DesiredCapacity estiver definido para o grupo de escalonamento e você modificar DesiredCapacity, o Auto Scaling adiciona ou remove automaticamente instâncias ECS ou de contêiner elástico para garantir que o número de instâncias no grupo de escalonamento seja igual ao valor de 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 único dentro de uma região. O nome deve ter de 2 a 64 caracteres e pode conter dígitos, letras maiúsculas, letras minúsculas, caracteres chineses, sublinhados (_), hifens (-) e pontos (.). Deve começar com um dígito, letra ou caractere chinês. |
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 Nota
O valor de |
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 Os valores válidos de MaxSize dependem do seu uso do Auto Scaling. Acesse o Quota Center para verificar a cota de Número máximo de instâncias em um grupo de escalonamento. Por exemplo, se a cota de Número máximo de instâncias em um grupo de escalonamento for 2000, os valores válidos de |
99 |
| DefaultCooldown |
integer |
Não |
O tempo de espera após a conclusão de uma atividade de escalonamento (adição ou remoção de instâncias ECS ou instâncias de contêiner elástico). Valores válidos: 0 a 86400. Unidade: segundos. Durante o tempo de espera, o grupo de escalonamento não executa outras atividades de escalonamento. Este parâmetro se aplica apenas a atividades de escalonamento acionadas por tarefas acionadas por eventos do CloudMonitor. |
600 |
| RemovalPolicy.1 |
string |
Não |
A política de scale-in de primeira prioridade para remover instâncias ECS do grupo de escalonamento. Valores válidos:
Nota
A configuração de escalonamento mencionada em OldestScalingConfiguration refere-se à fonte de configuração da instância, incluindo configurações de escalonamento e modelos de inicialização. CustomPolicy pode ser definido apenas como a política de scale-in de primeira prioridade. Ao especificar CustomPolicy, você também deve especificar o parâmetro CustomPolicyARN. |
OldestScalingConfiguration |
| RemovalPolicy.2 |
string |
Não |
A política de scale-in de segunda prioridade para remover instâncias ECS do grupo de escalonamento. Valores válidos:
Nota
A configuração de escalonamento mencionada em OldestScalingConfiguration refere-se à fonte de configuração da instância, incluindo configurações de escalonamento e modelos de inicialização. |
NewestInstance |
| RemovalPolicy.3 |
string |
Não |
A política de scale-in de terceira prioridade para remover instâncias ECS do grupo de escalonamento. Valores válidos:
Nota
A configuração de escalonamento mencionada em OldestScalingConfiguration refere-se à fonte de configuração da instância, incluindo configurações de escalonamento e modelos de inicialização. |
OldestInstance |
| 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:
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 |
ECS |
| 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:
|
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 deve complementar instâncias spot. Quando este recurso está ativado e o grupo de escalonamento recebe uma mensagem do sistema de que uma instância spot está prestes a ser recuperada, o grupo de escalonamento tenta criar uma nova instância para substituir a instância spot que 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 como custo ou estoque insuficiente. Este parâmetro só entra em vigor 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 vários tipos com o menor custo. 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. Definir este parâmetro ativa o recurso de número esperado de instâncias. O grupo de escalonamento mantém automaticamente o número de instâncias ECS ou de contêiner elástico no número esperado. Valores válidos: MinSize ≤ DesiredCapacity ≤ MaxSize. Nota
Se você desativar e, em seguida, reativar o recurso de número esperado de instâncias, deverá definir o valor de |
5 |
| GroupDeletionProtection |
boolean |
Não |
Especifica se deve ativar a proteção contra exclusão 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:
|
PRIORITY |
| VSwitchIds |
array |
Não |
Os IDs de um ou mais vSwitches. Este parâmetro só entra em vigor 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 numérica crescente, onde 1 indica a prioridade mais alta. Quando uma instância ECS não pode ser criada na zona de um vSwitch de maior prioridade, o sistema seleciona automaticamente o próximo vSwitch de maior prioridade. |
vsw-bp1oo2a7isyrb8igf**** |
|
string |
Não |
Os IDs de um ou mais vSwitches. Valores válidos de N: 1 a 5. Este parâmetro só entra em vigor 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 numérica crescente, onde 1 indica a prioridade mais alta. Quando uma instância ECS não pode ser criada na zona de um vSwitch de maior prioridade, o sistema seleciona automaticamente o próximo vSwitch de maior prioridade. |
vsw-bp1oo2a7isyrb8igf**** |
|
| 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 este parâmetro e LaunchTemplateOverride.N.WeightedCapacity. Este parâmetro especifica o tipo de instância, que 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 só entra em vigor 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 em uma base um para um, e os valores de N devem ser os mesmos. 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 escala horizontalmente duas instâncias ecs.c5.xlarge. Nota
Durante o 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 de lance para o tipo de instância especificado por Nota
Este parâmetro só entra em vigor quando o parâmetro |
0.025 |
| AzBalance |
boolean |
Não |
Especifica se deve distribuir uniformemente a capacidade do grupo de escalonamento entre várias zonas. Este parâmetro só entra em vigor 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 à capacidade spot. Este parâmetro só entra em vigor quando o parâmetro
Valor padrão: priority. |
priority |
| SpotAllocationStrategy |
string |
Não |
A estratégia de alocação de 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 o parâmetro
Valor padrão: priority. |
lowestPrice |
| 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 |
| CustomPolicyARN |
string |
Não |
O Alibaba Cloud Resource Name (ARN) da política de scale-in personalizada (Function). Este parâmetro só entra em vigor quando a primeira política de scale-in em RemovalPolicies estiver 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 deve desativar o recurso de número esperado de instâncias para o grupo de escalonamento. Valores válidos:
Nota
Você pode definir este parâmetro como true 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 |
false |
| ScalingPolicy |
string |
Não |
O modo de recuperação do grupo de escalonamento. Valores válidos:
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 |
| HealthCheckTypes |
array |
Não |
Os modos de verificação de integridade do grupo de escalonamento. Nota
Você pode especificar vários valores para este parâmetro para ativar várias opções de verificação de integridade. Se o parâmetro |
|
|
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 esperar que uma instância ECS pare 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 cria 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 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 como custo ou estoque insuficiente. Este parâmetro só entra em vigor quando o parâmetro
|
true |
| SpotAutoReplaceOnDemand |
boolean |
Não |
Especifica se deve usar instâncias spot para substituir instâncias pay-as-you-go quando
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 zona. Este parâmetro só entra em vigor quando o balanceamento de zona está ativado. Valores válidos:
Valor padrão: BalancedBestEffort. |
BalancedBestEffort |
| AutoRebalance |
boolean |
Não |
Especifica se deve ativar o rebalanceamento automático para o grupo de escalonamento. Este parâmetro só entra em vigor quando BalancedOnly está ativado para um grupo de escalonamento com balanceamento de zona. 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.