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

Modifica uma regra de escalonamento.

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 que você deseja modificar.	asr-bp1dvirgwkoowxk7****
ScalingRuleName	string	Não	O nome da regra de escalonamento. 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. Nota O nome de uma regra de escalonamento deve ser exclusivo dentro do mesmo grupo de escalonamento, sob a mesma conta da Alibaba Cloud e na mesma região.	scalingrule****
Cooldown	integer	Não	O tempo de espera da regra de escalonamento. Este parâmetro é aplicável 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 em uma regra de escalonamento. Este parâmetro só entra em vigor quando o tipo de regra de escalonamento é `SimpleScalingRule` ou `StepScalingRule` e o `AdjustmentType` está definido como `PercentChangeInCapacity`.	1
AdjustmentType	string	Não	O método de ajuste da regra de escalonamento. Este parâmetro é aplicável a regras de escalonamento simples e regras de escalonamento em etapas, sendo obrigatório nesses casos. 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 atual para um valor especificado.	QuantityChangeInCapacity
AdjustmentValue	integer	Não	O valor de ajuste da regra de escalonamento. Este parâmetro é aplicável a regras de escalonamento simples e regras de escalonamento em etapas, sendo obrigatório nesses casos. O número de instâncias ECS ajustadas em uma única atividade de escalonamento 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 período de aquecimento de uma instância. Este parâmetro é aplicável a regras de escalonamento de rastreamento de destino e regras de escalonamento em etapas. Uma instância ECS no estado de aquecimento é adicionada ao grupo de escalonamento conforme esperado, mas o CloudMonitor não relata dados de monitoramento para a instância durante esse período. Nota Quando o número de instâncias ECS a serem escalonadas é calculado dinamicamente, as instâncias no estado de aquecimento não são contadas no total de instâncias existentes. Valores válidos: 0 a 86400. Unidade: segundos.	60
MetricName	string	Não	A métrica predefinida. Este parâmetro é aplicável a regras de escalonamento de rastreamento de destino e regras de escalonamento preditivo, sendo obrigatório nesses casos. Valores válidos para regras de escalonamento de rastreamento de destino: CpuUtilizationAgent: (Agent) utilização da CPU (recomendado). MemoryUtilization: (Agent) utilização de memória (recomendado). CpuUtilization: (ECS) utilização média da CPU. IntranetTx: (ECS) tráfego de saída médio pela rede interna. IntranetRx: (ECS) tráfego de entrada médio pela rede interna. VpcInternetTx: (ECS) tráfego de saída médio pela Internet. VpcInternetRx: (ECS) tráfego de entrada médio pela Internet. LoadBalancerRealServerAverageQps: (ALB) QPS por servidor em um grupo de servidores. Valores válidos para regras de escalonamento preditivo: CpuUtilization: (ECS) utilização média da CPU. IntranetRx: (ECS) tráfego de entrada médio pela rede interna. IntranetTx: (ECS) tráfego de saída médio pela rede interna. Para mais informações, consulte Tarefas acionadas por eventos para monitoramento do sistema.	CpuUtilization
TargetValue	number	Não	O valor de destino. Este parâmetro é aplicável a regras de escalonamento de rastreamento de destino e regras de escalonamento preditivo. O valor de TargetValue pode ter até três casas decimais e deve ser maior que 0.	0.125
DisableScaleIn	boolean	Não	Especifica se deve desativar o scale-in. Este parâmetro é aplicável apenas a regras de escalonamento de rastreamento de destino.	true
ScaleInEvaluationCount	integer	Não	Após a criação de uma regra de escalonamento de rastreamento de destino, uma tarefa acionada por eventos é criada automaticamente. Este parâmetro especifica o número de vezes consecutivas que a condição de limite deve ser atendida antes que a tarefa acionada por eventos de scale-in correspondente acione um alerta.	15
ScaleOutEvaluationCount	integer	Não	Após a criação de uma regra de escalonamento de rastreamento de destino, uma tarefa acionada por eventos é criada automaticamente. Este parâmetro especifica o número de vezes consecutivas que a condição de limite deve ser atendida antes que a tarefa acionada por eventos de scale-out correspondente acione um alerta.	3
PredictiveScalingMode	string	Não	O modo da regra de escalonamento preditivo. Valores válidos: PredictAndScale: gera resultados de previsão e cria tarefas de previsão. PredictOnly: gera resultados de previsão, mas não cria tarefas de previsão.	PredictAndScale
PredictiveValueBehavior	string	Não	O método usado para lidar com o valor máximo da 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 da tarefa de previsão será definido como o valor máximo inicial. PredictiveValueOverrideMax: o valor previsto substitui o valor máximo inicial. Se o valor previsto for maior que o valor máximo inicial, o valor máximo da tarefa de previsão será definido como o valor previsto. PredictiveValueOverrideMaxWithBuffer: o valor previsto é aumentado por uma porcentagem especificada. O valor previsto é aumentado com base na porcentagem PredictiveValueBuffer. Se o valor aumentado for maior que o valor máximo inicial, o valor aumentado será usado.	MaxOverridePredictiveValue
PredictiveValueBuffer	integer	Não	Este parâmetro entra em vigor quando `PredictiveValueBehavior` está definido como `PredictiveValueOverrideMaxWithBuffer`. O valor previsto é aumentado por esta porcentagem. 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	As tarefas de previsão criadas automaticamente por uma regra de escalonamento preditivo são executadas a cada hora por padrão. Você pode configurar um tempo de buffer para executar tarefas de previsão antecipadamente e preparar recursos com antecedência. 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	A coleção de informações de ajuste em etapas para o escalonamento em etapas.
	object	Não	A coleção de informações de ajuste em etapas para o escalonamento em etapas.
MetricIntervalUpperBound	number	Não	O limite superior de um ajuste em etapas. Este parâmetro é aplicável 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 escalonadas em um ajuste em etapas. Este parâmetro é aplicável apenas a regras de escalonamento em etapas.	1
MetricIntervalLowerBound	number	Não	O limite inferior de um ajuste em etapas. Este parâmetro é aplicável 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 é aplicável a regras de escalonamento de rastreamento de destino. Defina este parâmetro quando a métrica exigir 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 é aplicável a regras de escalonamento de rastreamento de destino. Defina este parâmetro quando a métrica exigir 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 da dimensão associada à métrica.	rulePool
DimensionValue	string	Não	O valor da dimensão associada à métrica.	sgp-l1cbirz451yxu2****
MetricType	string	Não	O tipo da métrica. Valores válidos: system: usa métricas do sistema 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 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 este parâmetro, consulte Usar regras de escalonamento de rastreamento de destino personalizadas baseadas em fórmulas.
	array<object>	Não
Id	string	Não	O ID de referência da métrica na expressão da fórmula.	a
Expression	string	Não	A expressão da fórmula para múltiplas métricas do Hybrid Cloud Monitoring. O resultado do cálculo da expressão é usado para acionar atividades de escalonamento. A expressão deve estar em conformidade com a especificação de Notação Polonesa Reversa (RPN) e apenas os operadores `+ - * /` são suportados.	(a+b)/2
MetricName	string	Não	O nome das métricas de monitoramento 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: a média de todos os pontos de dados dentro do intervalo especificado. Minimum: o valor mínimo de todos os pontos de dados dentro do intervalo especificado. Maximum: o valor máximo de todos os pontos de dados dentro do intervalo especificado.	Average
Dimensions	array<object>	Não	As dimensões da métrica. Especifica os recursos a serem monitorados para a 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	As definições de propriedades do alerta.
Period	integer	Não	O período estatístico para dados de monitoramento na regra de escalonamento de rastreamento de destino. Unidade: segundos. Valores válidos: 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.