ModifyScalingRule - Auto Scaling: Central de Documentação do Alibaba Cloud

Modifica um ou mais atributos de uma regra de escalonamento. Se uma regra de escalonamento existente não atender mais aos seus requisitos, você pode chamar esta operação para modificar seus atributos em vez de criar uma nova. Isso evita repetições desnecessárias e economiza tempo e recursos.

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

update

*ScalingGroup.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ScalingRuleId	string	Sim	O ID da regra de escalonamento.	asr-bp1dvirgwkoowxk7****
ScalingRuleName	string	Não	O nome da regra de escalonamento. O nome deve ter de 2 a 64 caracteres e começar com um dígito, uma letra ou um caractere chinês. Pode conter dígitos, sublinhados (_), hifens (-) e pontos (.). Nota O nome da regra de escalonamento deve ser exclusivo dentro de um grupo de escalonamento em uma região para uma conta Alibaba Cloud.	scalingrule****
Cooldown	integer	Não	O tempo de resfriamento da regra de escalonamento. Este parâmetro se aplica apenas a regras de escalonamento simples. Valores válidos: 0 a 86400. Unidade: segundos.	60
MinAdjustmentMagnitude	integer	Não	O número mínimo de instâncias a serem ajustadas. Este parâmetro entra em vigor apenas quando o tipo de regra de escalonamento é SimpleScalingRule ou StepScalingRule e AdjustmentType está definido como PercentChangeInCapacity.	1
AdjustmentType	string	Não	O método de ajuste da regra de escalonamento. Este parâmetro é obrigatório quando a regra de escalonamento é uma regra de escalonamento simples ou uma regra de escalonamento em etapas. Valores válidos: QuantityChangeInCapacity: adiciona ou remove um número especificado de instâncias ECS. PercentChangeInCapacity: adiciona ou remove uma porcentagem especificada de instâncias ECS. TotalCapacity: ajusta o número de instâncias ECS no grupo de escalonamento para um número especificado.	QuantityChangeInCapacity
AdjustmentValue	integer	Não	O valor de ajuste da regra de escalonamento. Este parâmetro é obrigatório quando a regra de escalonamento é uma regra de escalonamento simples ou uma regra de escalonamento em etapas. O número de instâncias ECS ajustadas em uma única operação não pode exceder 1.000. Os valores válidos variam de acordo com o método de ajuste: QuantityChangeInCapacity: -1000 a 1000. PercentChangeInCapacity: -100 a 10000. TotalCapacity: 0 a 2000.	100
EstimatedInstanceWarmup	integer	Não	O tempo de aquecimento das instâncias. Este parâmetro se aplica a regras de escalonamento de rastreamento de meta e regras de escalonamento em etapas. As instâncias ECS no estado de aquecimento são adicionadas ao grupo de escalonamento normalmente, mas não relatam dados de monitoramento ao CloudMonitor durante o período de aquecimento. Nota Quando o sistema calcula dinamicamente o número de instâncias ECS a serem escalonadas, as instâncias no estado de aquecimento não são contadas como instâncias existentes. Valores válidos: 0 a 86400. Unidade: segundos.	60
MetricName	string	Não	A métrica predefinida. Este parâmetro é obrigatório quando a regra de escalonamento é uma regra de escalonamento de rastreamento de meta ou uma regra de escalonamento preditivo. Valores válidos para regras de escalonamento de rastreamento de meta: CpuUtilizationAgent: a utilização de CPU coletada pelo agente do CloudMonitor (recomendado). MemoryUtilization: o uso de memória coletado pelo agente do CloudMonitor (recomendado). CpuUtilization: a utilização média de CPU das instâncias ECS. IntranetTx: o tráfego interno de saída médio das instâncias ECS. IntranetRx: o tráfego interno de entrada médio das instâncias ECS. VpcInternetTx: o tráfego de Internet de saída médio das instâncias ECS. VpcInternetRx: o tráfego de Internet de entrada médio das instâncias ECS. LoadBalancerRealServerAverageQps: a média de consultas por segundo (QPS) por servidor backend em um grupo de servidores ALB. Valores válidos para regras de escalonamento preditivo: CpuUtilization: a utilização média de CPU das instâncias ECS. IntranetRx: o tráfego interno de entrada médio das instâncias ECS. IntranetTx: o tráfego interno de saída médio das instâncias ECS. Para mais informações, consulte Tarefas acionadas por eventos de monitoramento do sistema.	CpuUtilization
TargetValue	number	Não	O valor de meta. Este parâmetro se aplica a regras de escalonamento de rastreamento de meta e regras de escalonamento preditivo. O valor pode ter até três casas decimais e deve ser maior que 0.	0.125
DisableScaleIn	boolean	Não	Especifica se deve desativar a redução de escala. Este parâmetro se aplica apenas a regras de escalonamento de rastreamento de meta.	true
ScaleInEvaluationCount	integer	Não	Após a criação de uma regra de escalonamento de rastreamento de meta, uma tarefa acionada por evento é criada automaticamente. Este parâmetro especifica o número de vezes consecutivas que a condição de limite deve ser atendida para acionar um alerta para a tarefa acionada por evento de redução de escala correspondente.	15
ScaleOutEvaluationCount	integer	Não	Após a criação de uma regra de escalonamento de rastreamento de meta, uma tarefa acionada por evento é criada automaticamente. Este parâmetro especifica o número de vezes consecutivas que a condição de limite deve ser atendida para acionar um alerta para a tarefa acionada por evento de expansão de escala correspondente.	3
PredictiveScalingMode	string	Não	O modo da regra de escalonamento preditivo. Valores válidos: PredictAndScale: gera previsões e cria tarefas preditivas. PredictOnly: gera previsões, mas não cria tarefas preditivas.	PredictAndScale
PredictiveValueBehavior	string	Não	O método para lidar com o valor máximo para a regra de escalonamento preditivo. Valores válidos: MaxOverridePredictiveValue: o valor máximo inicial substitui o valor previsto. Se o valor previsto for maior que o valor máximo inicial, o valor máximo inicial será usado como o valor máximo para a tarefa preditiva. PredictiveValueOverrideMax: o valor previsto substitui o valor máximo inicial. Se o valor previsto for maior que o valor máximo inicial, o valor previsto será usado como o valor máximo para a tarefa preditiva. PredictiveValueOverrideMaxWithBuffer: uma taxa de buffer é adicionada ao valor previsto. O valor previsto é aumentado pela taxa especificada por PredictiveValueBuffer. Se o valor aumentado for maior que o valor máximo inicial, o valor aumentado será usado.	MaxOverridePredictiveValue
PredictiveValueBuffer	integer	Não	A taxa de buffer adicionada ao valor previsto. Este parâmetro entra em vigor apenas quando PredictiveValueBehavior está definido como PredictiveValueOverrideMaxWithBuffer. O valor previsto é aumentado por esta taxa. Se o valor aumentado for maior que o valor máximo inicial, o valor aumentado será usado. Valores válidos: 0 a 100.	50
PredictiveTaskBufferTime	integer	Não	O tempo de buffer antes da execução da tarefa preditiva. As tarefas preditivas criadas automaticamente por regras de escalonamento preditivo são executadas a cada hora por padrão. Você pode definir um tempo de buffer para executar a tarefa preditiva com antecedência e preparar recursos. Unidade: minutos. Valores válidos: 0 a 60.	30
InitialMaxSize	integer	Não	O número máximo de instâncias no grupo de escalonamento. Este parâmetro é usado em conjunto com PredictiveValueBehavior.	100
StepAdjustment	array<object>	Não	O conjunto de ajustes em etapas.
	object	Não	O conjunto de ajustes em etapas.
MetricIntervalUpperBound	number	Não	O limite superior do ajuste em etapas. Este parâmetro se aplica apenas a regras de escalonamento em etapas. Valores válidos: -9.999999E18 a 9.999999E18.	5.0
ScalingAdjustment	integer	Não	O número de instâncias a serem ajustadas para o ajuste em etapas. Este parâmetro se aplica apenas a regras de escalonamento em etapas.	1
MetricIntervalLowerBound	number	Não	O limite inferior do ajuste em etapas. Este parâmetro se aplica apenas a regras de escalonamento em etapas. Valores válidos: -9.999999E18 a 9.999999E18.	1.0
AlarmDimension	array<object>	Não	As informações de dimensão associadas à métrica. Este parâmetro se aplica a regras de escalonamento de rastreamento de meta e é configurado quando a métrica requer informações de dimensão adicionais. Por exemplo, a métrica LoadBalancerRealServerAverageQps requer as informações de dimensão rulePool.
	object	Não	As informações de dimensão associadas à métrica. Este parâmetro se aplica a regras de escalonamento de rastreamento de meta e é configurado quando a métrica requer informações de dimensão adicionais. Por exemplo, a métrica LoadBalancerRealServerAverageQps requer as informações de dimensão rulePool.
DimensionKey	string	Não	A chave das informações de dimensão associadas à métrica.	rulePool
DimensionValue	string	Não	O valor das informações de dimensão associadas à métrica.	sgp-l1cbirz451yxu2****
MetricType	string	Não	O tipo de métrica. Valores válidos: system: usa métricas do sistema do CloudMonitor. custom: usa métricas personalizadas relatadas ao CloudMonitor. hybrid: usa métricas do Hybrid Cloud Monitoring.	system
HybridMonitorNamespace	string	Não	O ID do repositório de métricas de monitoramento do Hybrid Cloud Monitoring. Para mais informações sobre como gerenciar repositórios de métricas de monitoramento, consulte Gerenciar repositórios de métricas de monitoramento.	aliyun-test
HybridMetrics	array<object>	Não	As configurações de métricas de monitoramento do Hybrid Cloud Monitoring. Para mais informações sobre como configurar as definições, consulte Personalizar regras de escalonamento de rastreamento de meta usando operações de fórmula.
	array<object>	Não
Id	string	Não	O ID de referência da métrica na expressão de operação da métrica.	a
Expression	string	Não	A expressão de operação da métrica para várias métricas do Hybrid Cloud Monitoring. O resultado do cálculo da expressão é usado para acionar atividades de escalonamento. A expressão de operação deve estar em conformidade com a especificação de Notação Polonesa Reversa (RPN) e apenas os operadores `+`, `-`, `*` e `/` são suportados.	(a+b)/2
MetricName	string	Não	O nome da métrica no repositório de métricas de monitoramento do Hybrid Cloud Monitoring.	AliyunSmq_NumberOfMessagesVisible
Statistic	string	Não	O método estatístico da métrica. Valores válidos: Average: o valor médio de todos os pontos de dados no período especificado. Minimum: o valor mínimo de todos os pontos de dados no período especificado. Maximum: o valor máximo de todos os pontos de dados no período especificado.	Average
Dimensions	array<object>	Não	As dimensões da métrica. Este parâmetro é usado para especificar os recursos monitorados pela métrica.
	object	Não
DimensionKey	string	Não	A chave da dimensão da métrica.	queue
DimensionValue	string	Não	O valor da dimensão da métrica.	testQueue
AlarmOptions	object	Não	Os atributos de alerta.
Period	integer	Não	O período para coleta de dados de métrica na regra de escalonamento de rastreamento de meta. Unidade: segundos. Valores válidos: 15 60 120 300 900 Nota Valor padrão: 60.	60

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.