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
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 |
AdjustmentType | String | No | QuantityChangeInCapacity | Método de ajuste usado pela regra de dimensionamento. Obrigatório se ScalingRuleType for SimpleScalingRule ou StepScalingRule. Valores válidos:
|
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.
|
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:
Valores válidos quando ScalingRuleType é PredictiveScalingRule:
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:
|
PredictiveValueBehavior | String | No | MaxOverridePredictiveValue | Ação a ser executada sobre o valor máximo previsto. Valores válidos:
|
PredictiveValueBuffer | Integer | No | 50 | Proporção de aumento do valor previsto quando |
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:
|
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:
|
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:
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. |