Todos os produtos
Search
Central de documentação

Auto Scaling:ModifyScalingRule

Última atualização: Jul 03, 2026

Modifica uma regra de dimensionamento. Se uma regra existente não atender aos requisitos de negócios, chame a operação ModifyScalingRule para ajustá-la sem criar uma nova. Essa operação simplifica tarefas ao eliminar ações repetitivas, o que reduz significativamente o tempo necessário e minimiza o consumo de recursos.

Depuração

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

Parâmetros da solicitação

Parameter

Type

Required

Example

Description

Action

String

Yes

ModifyScalingRule

A operação a ser executada. Defina o valor como ModifyScalingRule.

ScalingRuleId

String

Yes

asr-bp1dvirgwkoowxk7****

O ID da regra de dimensionamento a ser modificada.

ScalingRuleName

String

No

scalingrule****

Nome da regra de dimensionamento. Deve ter entre 2 e 64 caracteres e pode conter letras, dígitos, sublinhados (_), hifens (-) e pontos (.). Precisa começar com uma letra ou dígito.

Nota

O nome de cada regra de dimensionamento deve ser único na mesma conta e região.

Cooldown

Integer

No

60

Período de resfriamento da regra de dimensionamento. Disponível apenas se ScalingRuleType for definido como SimpleScalingRule.

Valores válidos: 0 a 86400. Unidade: segundos.

MinAdjustmentMagnitude

Integer

No

1

Número mínimo de instâncias a serem dimensionadas. Este parâmetro entra em vigor se ScalingRuleType for definido como SimpleScalingRule ou StepScalingRule, e AdjustmentType como PercentChangeInCapacity.

AdjustmentType

String

No

QuantityChangeInCapacity

Método de ajuste usado pela regra de dimensionamento. Obrigatório se ScalingRuleType for SimpleScalingRule ou StepScalingRule. Valores válidos:

  • QuantityChangeInCapacity: adiciona ou remove um número específico de instâncias ECS (Elastic Compute Service) do grupo de dimensionamento.

  • PercentChangeInCapacity: adiciona ou remove uma porcentagem específica de instâncias ECS do grupo de dimensionamento.

  • TotalCapacity: ajusta o número de instâncias ECS no grupo de dimensionamento para um valor especificado.

AdjustmentValue

Integer

No

100

Número de instâncias a adicionar ou remover do grupo de dimensionamento com base na regra. Obrigatório se ScalingRuleType for SimpleScalingRule ou StepScalingRule. O limite máximo de instâncias ECS adicionadas ou removidas em uma única operação é 1.000, independentemente do cenário. O intervalo de valores varia conforme AdjustmentType.

  • Valores válidos quando AdjustmentType é QuantityChangeInCapacity: -1000 a 1000.

  • Valores válidos quando AdjustmentType é PercentChangeInCapacity: -100 a 10000.

  • Valores válidos quando AdjustmentType é TotalCapacity: 0 a 2000.

EstimatedInstanceWarmup

Integer

No

60

Período de aquecimento das instâncias adicionadas ou removidas do grupo de dimensionamento. Aplicável apenas a regras de dimensionamento simples e em etapas. Durante esse período, o Auto Scaling adiciona instâncias ECS no estado Warmup ao grupo, mas não envia dados de monitoramento ao CloudMonitor.

Nota

Instâncias ECS no estado Warmup são excluídas do cálculo de capacidade quando o Auto Scaling determina o número de instâncias a dimensionar.

Valores válidos: 0 a 86400. Unidade: segundos.

MetricName

String

No

CpuUtilization

Métrica predefinida da regra de dimensionamento. Obrigatória se ScalingRuleType for TargetTrackingScalingRule ou PredictiveScalingRule.

Valores válidos quando ScalingRuleType é TargetTrackingScalingRule:

  • CpuUtilizationAgent (recomendado): utilização da CPU.

  • MemoryUtilization (recomendado): uso de memória.

  • CpuUtilization: utilização média da CPU.

  • IntranetTx: tráfego de saída em rede interna.

  • IntranetRx: tráfego médio de entrada em rede interna.

  • VpcInternetTx: tráfego de saída de uma Virtual Private Cloud (VPC) para a Internet.

  • VpcInternetRx: tráfego de entrada da Internet para uma VPC.

  • LoadBalancerRealServerAverageQps: consultas por segundo (QPS) por grupo de servidores do Application Load Balancer (ALB).

Valores válidos quando ScalingRuleType é PredictiveScalingRule:

  • CpuUtilization: utilização média da CPU.

  • IntranetRx: tráfego médio de entrada em rede interna.

  • IntranetTx: tráfego médio de saída em rede interna.

Para mais informações, consulte Tarefas acionadas por eventos do tipo de monitoramento do sistema.

TargetValue

Float

No

0.125

Valor alvo. Disponível apenas se ScalingRuleType for TargetTrackingScalingRule ou PredictiveScalingRule. Deve ser maior que 0 e ter no máximo três casas decimais.

DisableScaleIn

Boolean

No

true

Indica se o scale-in deve ser desativado. Disponível se ScalingRuleType for TargetTrackingScalingRule.

ScaleInEvaluationCount

Integer

No

15

Ao criar uma regra de dimensionamento de rastreamento de alvo, uma tarefa acionada por evento é gerada e associada à regra automaticamente. Este parâmetro define quantas vezes consecutivas a condição de alerta deve ser atendida antes de a tarefa iniciar uma operação de scale-in.

ScaleOutEvaluationCount

Integer

No

3

Ao criar uma regra de dimensionamento de rastreamento de alvo, uma tarefa acionada por evento é gerada e associada à regra automaticamente. Este parâmetro define quantas vezes consecutivas a condição de alerta deve ser atendida antes de a tarefa iniciar uma operação de scale-out.

PredictiveScalingMode

String

No

PredictAndScale

Modo da regra de dimensionamento preditivo. Valores válidos:

  • PredictAndScale: fornece previsões e cria tarefas de previsão.

  • PredictOnly: fornece previsões, mas não cria tarefas de previsão.

PredictiveValueBehavior

String

No

MaxOverridePredictiveValue

Ação a ser executada sobre o valor máximo previsto. Valores válidos:

  • MaxOverridePredictiveValue: usa a capacidade máxima inicial como valor máximo para tarefas de previsão caso o valor previsto seja maior que a capacidade máxima inicial.

  • PredictiveValueOverrideMax: usa o valor previsto como valor máximo para tarefas de previsão caso o valor previsto seja maior que a capacidade máxima inicial.

  • PredictiveValueOverrideMaxWithBuffer: aumenta o valor previsto conforme a proporção especificada por PredictiveValueBuffer e usa o valor resultante como máximo para tarefas de previsão, desde que esse valor ajustado supere a capacidade máxima inicial.

PredictiveValueBuffer

Integer

No

50

Proporção de aumento do valor previsto quando PredictiveValueBehavior é definido como PredictiveValueOverrideMaxWithBuffer. Se o valor previsto aumentado por essa proporção for maior que a capacidade máxima inicial, o valor ajustado será usado como máximo para as tarefas de previsão. Valores válidos: 0 a 100.

PredictiveTaskBufferTime

Integer

No

30

Tempo de buffer antes da execução das tarefas de previsão. Por padrão, todas as tarefas de previsão criadas automaticamente com base em uma regra de dimensionamento preditivo são executadas na hora cheia. Especifique um tempo de buffer para preparação de recursos antes da execução. Valores válidos: 0 a 60.

InitialMaxSize

Integer

No

100

Número máximo de instâncias ECS que podem ser adicionadas ao grupo de dimensionamento. Ao especificar InitialMaxSize, também especifique PredictiveValueBehavior.

StepAdjustment.N.MetricIntervalUpperBound

Float

No

5.0

Limite superior de um ajuste de etapa. Vigente apenas se ScalingRuleType for StepScalingRule. Valores válidos: -9.999999E18 a 9.999999E18.

StepAdjustment.N.ScalingAdjustment

Integer

No

1

Número de instâncias ECS a dimensionar em cada ajuste de etapa. Disponível apenas se ScalingRuleType for StepScalingRule.

StepAdjustment.N.MetricIntervalLowerBound

Float

No

1.0

Limite inferior em um ajuste de etapa. Disponível apenas se ScalingRuleType for StepScalingRule. Valores válidos: -9.999999E18 a 9.999999E18.

AlarmDimension.N.DimensionKey

String

No

rulePool

Chave da dimensão da métrica.

AlarmDimension.N.DimensionValue

String

No

sgp-l1cbirz451yxu2****

Valor da dimensão da métrica.

MetricType

String

No

system

Tipo de métrica usada pela tarefa acionada por evento. Valores válidos:

  • system: métricas de sistema do CloudMonitor.

  • custom: métricas personalizadas relatadas ao CloudMonitor.

  • hybrid: métricas do Hybrid Cloud Monitoring.

HybridMonitorNamespace

String

No

aliyun-test

ID do namespace do Hybrid Cloud Monitoring.

Para obter informações sobre como gerenciar namespaces do Hybrid Cloud Monitoring, consulte Gerenciar namespaces.

HybridMetrics.N.Id

String

No

a

ID de referência da métrica na expressão da métrica.

HybridMetrics.N.Expression

String

No

(a+b)/2

Expressão da métrica composta por múltiplas métricas do Hybrid Cloud Monitoring. Calcula um resultado usado para acionar eventos de dimensionamento.

A expressão deve estar no formato Notação Polonesa Reversa (RPN) e suporta apenas os seguintes operadores: +, -, *, /.

HybridMetrics.N.MetricName

String

No

AliyunSmq_NumberOfMessagesVisible

Nome da métrica do Hybrid Cloud Monitoring.

HybridMetrics.N.Statistic

String

No

Average

Método estatístico do valor da métrica. Valores válidos:

  • Average: calcula o valor médio de todos os valores da métrica dentro de um intervalo especificado.

  • Minimum: calcula o valor mínimo de todos os valores da métrica dentro de um intervalo especificado.

  • Maximum: calcula o valor máximo de todos os valores da métrica dentro de um intervalo especificado.

HybridMetrics.N.Dimensions.N.DimensionKey

String

No

queue

Chave da dimensão da métrica.

HybridMetrics.N.Dimensions.N.DimensionValue

String

No

testQueue

Valor da dimensão da métrica.

AlarmOptions.Period

Integer

No

60

Período estatístico dos dados da métrica na regra de dimensionamento de rastreamento de alvo. Unidade: segundos. Valores válidos:

  • 15

  • 60

  • 120

  • 300

  • 900

Nota

Valor padrão: 60.

Parâmetros de resposta

Parameter

Type

Example

Description

RequestId

String

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

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=ModifyScalingRule
&ScalingRuleId=asr-bp1dvirgwkoowxk7****
&ScalingRuleName=scalingrule****
&Cooldown=60
&MinAdjustmentMagnitude=1
&AdjustmentType=QuantityChangeInCapacity
&AdjustmentValue=100
&EstimatedInstanceWarmup=60
&MetricName=CpuUtilization
&TargetValue=0.125
&DisableScaleIn=true
&ScaleInEvaluationCount=15
&ScaleOutEvaluationCount=3
&PredictiveScalingMode=PredictAndScale
&PredictiveValueBehavior=MaxOverridePredictiveValue
&PredictiveValueBuffer=50
&PredictiveTaskBufferTime=30
&InitialMaxSize=100
&StepAdjustment=[{"MetricIntervalUpperBound":5.0,"ScalingAdjustment":1,"MetricIntervalLowerBound":1.0}]
&AlarmDimension=[{"DimensionKey":"rulePool","DimensionValue":"sgp-l1cbirz451yxu2****"}]
&MetricType=system
&HybridMonitorNamespace=aliyun-test
&HybridMetrics=[{"Id":"a","MetricName":"AliyunSmq_NumberOfMessagesVisible","Statistic":"Average","Dimensions":[{"DimensionKey":"queue","DimensionValue":"testQueue"}]}]
&<Common request parameters>

Exemplos de respostas de sucesso

XML formato

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

<ModifyScalingRuleResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScalingRuleResponse>

JSON formato

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de erro

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

HTTP status code

Error code

Error message

Description

404

InvalidScalingRuleId.NotFound

The specified scaling rule does not exist.

A regra de dimensionamento especificada não existe na conta Alibaba Cloud.

400

InvalidScalingRuleName.Duplicate

The specified value of parameter <parameter name> is duplicated.

O nome da regra de dimensionamento já existe.

400

QuotaExceeded.ScalingRule

Scaling rule quota exceeded in the specified scaling group.

O número máximo de regras de dimensionamento no grupo foi atingido.

400

TargetTrackingScalingRule.UnsupportedMetric

Specific metric is not supported for target tracking scaling rule.

A regra de dimensionamento de rastreamento de alvo não suporta a métrica especificada.

400

TargetTrackingScalingRule.DumplicateMetric

Only one TargetTrackingScaling rule for a given metric specification is allowed.

A métrica já está especificada em outra regra de dimensionamento de rastreamento de alvo no grupo.

400

InvalidMinAdjustmentMagnitudeMismatchAdjustmentType

MinAdjustmentMagnitude is not supported by the specified adjustment type.

MinAdjustmentMagnitude não suporta o método de ajuste da regra de dimensionamento.

400

InvalidStepAdjustments.MultipleNullUpperBound

At most one StepAdjustment may have an unspecified upper bound.

Já existe um ajuste de etapa sem limite superior definido.

400

InvalidStepAdjustments.MultipleNullLowerBound

At most one StepAdjustment may have an unspecified lower bound.

Já existe um ajuste de etapa sem limite inferior definido.

400

InvalidStepAdjustments.NoNullLowerBound

There must be a StepAdjustment with an unspecified lower bound when one StepAdjustment has a negative lower bound.

Um ajuste de etapa tem limite inferior negativo, mas não existe nenhum ajuste sem limite inferior definido.

400

InvalidStepAdjustments.NoNullUpperBound

There must be a StepAdjustment with an unspecified upper bound when one StepAdjustment has a positive upper bound.

Um ajuste de etapa tem limite superior positivo, mas não existe nenhum ajuste sem limite superior definido.

400

InvalidStepAdjustments.Gap

StepAdjustment intervals can not have gaps between them.

Existem lacunas entre os ajustes de etapa.

400

InvalidStepAdjustments.Overlap

StepAdjustment intervals can not overlap.

Os intervalos dos ajustes de etapa se sobrepõem.

400

InvalidStepAdjustments.LowerGtUpper

LowerBound must be less than the UpperBound for StepAdjustment :%s.

O limite inferior de um ajuste de etapa é maior ou igual ao limite superior.

400

InvalidStepAdjustments.BothNull

Both lower and upper bounds of a StepAdjustment can not be left unspecified.

Não é possível deixar o limite superior e o limite inferior de um ajuste de etapa indefinidos simultaneamente.

400

InvalidStepAdjustments.MaxNum

Your scaling rule can have at most %s StepAdjustments.

O número máximo de ajustes de etapa em um grupo de dimensionamento foi atingido.

400

StepBeyondPermitRange

Specific parameter "%s" beyond permit range.

O limite superior ou inferior especificado para um ajuste de etapa é inválido.