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 operações repetitivas 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 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 letras, dígitos, sublinhados (_), hifens (-) e pontos (.). Deve começar com uma letra ou dígito. 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 é 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. 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 e aplicável apenas a regras de escalonamento simples e regras 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 e aplicável apenas a regras de escalonamento simples e regras 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 período de aquecimento das instâncias. Este parâmetro é aplicável a regras de escalonamento de rastreamento de destino 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 para escalar para fora ou para dentro, 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 de monitoramento predefinida. Este parâmetro é obrigatório e aplicável a regras de escalonamento de rastreamento de destino e regras de escalonamento preditivo. Valores válidos para regras de escalonamento de rastreamento de destino: 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 de back-end em um grupo de servidores do Application Load Balancer (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 destino. Este parâmetro é aplicável a regras de escalonamento de rastreamento de destino 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 é 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 redução de escala 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 aumento de escala 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 preditivas. PredictOnly: gera resultados de previsão, 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	Por padrão, as tarefas preditivas criadas automaticamente pelas regras de escalonamento preditivo são executadas de hora em hora. Você pode definir um horário de pré-início para executar as tarefas preditivas com antecedência e preparar recursos. Valores válidos: 0 a 60. Unidade: minutos.	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
StepAdjustments	array<object>	Não	O conjunto de configurações de escalonamento de instâncias para ajustes em etapas.
	object	Não	O conjunto de configurações de escalonamento de instâncias para ajustes em etapas.
MetricIntervalUpperBound	number	Não	O limite superior do 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 ajustadas para o ajuste em etapas. Este parâmetro é aplicável apenas a regras de escalonamento em etapas.	1
MetricIntervalLowerBound	number	Não	O limite inferior do 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
AlarmDimensions	array<object>	Não	Os valores de dimensão da métrica de monitoramento. Este parâmetro é aplicável a regras de escalonamento de rastreamento de destino e é configurado quando a métrica de monitoramento requer informações de dimensão adicionais. Por exemplo, a métrica LoadBalancerRealServerAverageQps requer a dimensão rulePool.
	object	Não	Os valores de dimensão da métrica de monitoramento. Este parâmetro é aplicável a regras de escalonamento de rastreamento de destino e é configurado quando a métrica de monitoramento requer informações de dimensão adicionais. Por exemplo, a métrica LoadBalancerRealServerAverageQps requer a dimensão rulePool.
DimensionKey	string	Não	A chave da dimensão associada à métrica de monitoramento.	rulePool
DimensionValue	string	Não	O valor da dimensão associada à métrica de monitoramento.	sgp-l1cbirz451yxu2dxxx
MetricType	string	Não	O tipo da métrica de monitoramento. Valores válidos: system: usa métricas de 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 Usar operações de fórmula para personalizar regras de escalonamento de rastreamento de destino.
	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 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 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 do alerta.
Period	integer	Não	O período para coleta de dados de métricas de monitoramento na regra de escalonamento de rastreamento de destino. 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	As informações de resposta para a modificação de uma regra de escalonamento.
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.