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

Cria uma regra de escalonamento.

Descrição da operação

Observe as seguintes informações sobre os parâmetros:

Se AdjustmentType estiver definido como TotalCapacity, o número de instâncias ECS ou ECI no grupo de escalonamento atual será ajustado para o valor especificado. O AdjustmentValue correspondente deve ser maior ou igual a 0.
Se AdjustmentType estiver definido como QuantityChangeInCapacity ou PercentChangeInCapacity, um AdjustmentValue positivo indica que instâncias ECS serão adicionadas, e um valor negativo indica que instâncias ECS serão removidas.
Se AdjustmentType estiver definido como PercentChangeInCapacity, o Auto Scaling calcula o número de instâncias ECS ou ECI a serem adicionadas ou removidas usando a seguinte fórmula: Número atual de instâncias no grupo de escalonamento (Capacidade Total) × AdjustmentValue/100. O resultado é arredondado para o número inteiro mais próximo.
Se um tempo de resfriamento (Cooldown) for especificado em uma regra de escalonamento, o tempo de resfriamento especificado na regra de escalonamento entrará em vigor após a conclusão da atividade de escalonamento acionada pela regra. Se nenhum tempo de resfriamento for especificado na regra de escalonamento, o tempo de resfriamento especificado para o grupo de escalonamento (DefaultCooldown) entrará em vigor.
O número de regras de escalonamento que podem ser criadas em um grupo de escalonamento é limitado. Para mais informações, consulte Limites.
O identificador exclusivo da regra de escalonamento (ScalingRuleAri) retornado pode ser usado nas seguintes operações:
- Você pode especificar o parâmetro ScalingRuleAri ao chamar a operação ExecuteScalingRule para executar manualmente a regra de escalonamento.
- Você pode especificar o parâmetro ScheduledAction ao chamar a operação CreateScheduledTask para executar a regra de escalonamento em uma programação.

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

create

*ScalingGroup

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ScalingGroupId	string	Sim	O ID do grupo de escalonamento ao qual a regra de escalonamento pertence.	asg-bp1ffogfdauy0jw0****
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. O nome da regra de escalonamento deve ser exclusivo na mesma região e no mesmo grupo de escalonamento sob a mesma conta. Nota Se você não especificar este parâmetro, o valor de ScalingRuleId será usado por padrão.	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. Valor padrão: vazio.	60
MinAdjustmentMagnitude	integer	Não	O número mínimo de instâncias a serem ajustadas na regra de escalonamento. Este parâmetro só entra em vigor 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 é aplicável a regras de escalonamento simples e regras de escalonamento em etapas, sendo obrigatório neste caso. 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 neste caso. 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
ScalingRuleType	string	Não	O tipo da regra de escalonamento. Valores válidos: SimpleScalingRule: escalonamento simples. Ajusta o número de instâncias ECS ou ECI com base no método de ajuste (AdjustmentType) e no valor de ajuste (AdjustmentValue). TargetTrackingScalingRule: regra de escalonamento de rastreamento de destino. Calcula dinamicamente o número de instâncias ECS ou ECI a serem escalonadas com base em uma métrica de monitoramento predefinida (MetricName) e tenta manter o valor das métricas de monitoramento próximo ao valor de destino (TargetValue). StepScalingRule: regra de escalonamento em etapas. Fornece extensão baseada em etapas com base em limites e valores de métricas. PredictiveScalingRule: regra de escalonamento preditivo. Usa aprendizado de máquina para analisar dados históricos de monitoramento do grupo de escalonamento, prever valores futuros de métricas de monitoramento e oferecer suporte à criação automática de tarefas agendadas para definir os limites do grupo de escalonamento. Valor padrão: SimpleScalingRule.	SimpleScalingRule
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 não relata dados de monitoramento ao CloudMonitor durante o período de aquecimento. 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 contabilizadas no número atual de instâncias. Valores válidos: 0 a 86400. Unidade: segundos. Valor padrão: 300.	300
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 neste caso. 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 médio de saída pela rede interna. IntranetRx: (ECS) tráfego médio de entrada pela rede interna. VpcInternetTx: (ECS) tráfego médio de saída pela Internet. VpcInternetRx: (ECS) tráfego médio de entrada pela Internet. LoadBalancerRealServerAverageQps: (ALB) QPS médio 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 médio de entrada pela rede interna. IntranetTx: (ECS) tráfego médio de saída 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, sendo obrigatório neste caso. 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. Valor padrão: false.	false
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 o limite condicional deve ser atendido antes que a tarefa acionada por eventos de scale-in acione um alerta. Valor padrão: 15.	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 o limite condicional deve ser atendido antes que a tarefa acionada por eventos de scale-out acione um alerta. Valor padrão: 3.	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. Valor padrão: PredictAndScale.	PredictAndScale
PredictiveValueBehavior	string	Não	O método usado 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 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 proporção PredictiveValueBuffer. Se o valor aumentado for maior que o valor máximo inicial, o valor aumentado será usado. Valor padrão: MaxOverridePredictiveValue.	MaxOverridePredictiveValue
PredictiveValueBuffer	integer	Não	Este parâmetro entra em vigor quando PredictiveValueBehavior está definido como PredictiveValueOverrideMaxWithBuffer. O valor previsto é aumentado com base nesta proporção. Se o valor aumentado for maior que o valor máximo inicial, o valor aumentado será usado. Valores válidos: 0 a 100. Valor padrão: 0.	50
PredictiveTaskBufferTime	integer	Não	As tarefas de previsão que são criadas automaticamente pela regra de escalonamento preditivo são executadas de hora em 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. Unidade: minutos. Valor padrão: 0.	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. Valor padrão: o valor de MaxSize do grupo de escalonamento.	100
StepAdjustment	array<object>	Não	A coleção de informações de ajuste de etapas para a regra de escalonamento em etapas.
	object	Não	A coleção de informações de ajuste de etapas para a regra de escalonamento em etapas.
MetricIntervalUpperBound	number	Não	O limite superior do ajuste de 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 para o ajuste de etapas. Este parâmetro é aplicável apenas a regras de escalonamento em etapas.	1
MetricIntervalLowerBound	number	Não	O limite inferior do ajuste de etapas. Este parâmetro é aplicável apenas a regras de escalonamento em etapas. Valores válidos: -9.999999E18 a 9.999999E18.	1.0
RegionId	string	Não	O ID da região do grupo de escalonamento.	cn-hangzhou
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, consulte Gerenciar repositórios de métricas.	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 métrica.	a
Expression	string	Não	A expressã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 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	A definição da propriedade de 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
ScalingRuleAri	string	O identificador exclusivo da regra de escalonamento.	ari:acs:ess:cn-hangzhou:140692647406**:scalingrule/asr-bp1dvirgwkoowxk7**
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
ScalingRuleId	string	O ID da regra de escalonamento. O ID é gerado pelo sistema e é globalmente exclusivo.	asr-bp1dvirgwkoowxk7****

Exemplos

Resposta de sucesso

JSON formato

{
  "ScalingRuleAri": "ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingRuleId": "asr-bp1dvirgwkoowxk7****"
}

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.