Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::ESS::ScalingRules

Última atualização: Jun 27, 2026

Consulta informações sobre várias regras de dimensionamento.

Sintaxe

{
  "Type": "DATASOURCE::ESS::ScalingRules",
  "Properties": {
    "RefreshOptions": String,
    "ScalingRuleIds": List,
    "ShowAlarmRules": Boolean,
    "ScalingGroupId": String,
    "ScalingRuleAris": List,
    "ScalingRuleType": String,
    "ScalingRuleNames": List
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

RefreshOptions

String

Não

Sim

Política de atualização dos recursos da source de dados durante a atualização da pilha.

Valores válidos:

  • Never (padrão): não atualiza os recursos da source de dados durante a atualização da pilha.

  • Always: atualiza os recursos da source de dados durante a atualização da pilha.

ScalingRuleIds

List

Não

Sim

IDs das regras de dimensionamento a consultar.

Especifique até 20 IDs.

ShowAlarmRules

Boolean

Não

Sim

Define se as tarefas acionadas por eventos do CloudMonitor associadas às regras de dimensionamento devem ser retornadas.

Valores válidos:

  • true

  • false

Valor padrão: false.

ScalingGroupId

String

Não

Sim

ID do grupo de dimensionamento.

Nenhuma.

ScalingRuleAris

List

Não

Sim

Identificadores exclusivos das regras de dimensionamento a consultar.

Especifique até 20 identificadores exclusivos.

ScalingRuleType

String

Não

Sim

Tipo da regra de dimensionamento.

Valores válidos:

  • SimpleScalingRule: ajusta o número de instâncias do Elastic Compute Service (ECS) com base nos valores de AdjustmentType e AdjustmentValue.

  • TargetTrackingScalingRule: calcula dinamicamente a quantidade de instâncias ECS a dimensionar com base em uma métrica predefinida (MetricName) e mantém o valor da métrica próximo ao valor alvo especificado (TargetValue).

  • StepScalingRule: dimensiona instâncias em etapas conforme limiares e valores de métricas predefinidos.

  • PredictiveScalingRule: utiliza machine learning para analisar dados históricos de monitoramento do grupo de dimensionamento e prever valores futuros de métricas. O sistema cria automaticamente tarefas agendadas para ajustar os números mínimo e máximo de instâncias do grupo.

ScalingRuleNames

List

Não

Sim

Nomes das regras de dimensionamento a consultar.

Especifique até 20 nomes.

Valores de retorno

Fn::GetAtt

  • ScalingRules: detalhes das regras de dimensionamento.

  • ScalingRuleIds: IDs das regras de dimensionamento.

Propriedade

Tipo

Descrição

Restrição

ScalingRuleIds

List

IDs das regras de dimensionamento.

Nenhuma.

ScalingRules

List

Detalhes das regras de dimensionamento.

Nenhuma.

PredictiveScalingMode

String

Modo da regra de dimensionamento preditivo.

Nenhuma.

MinAdjustmentMagnitude

Number

Quantidade mínima de instâncias a ajustar em uma atividade de dimensionamento.

Nenhuma.

PredictiveValueBuffer

Number

Proporção de aumento do valor previsto quando PredictiveValueBehavior está definido como PredictiveValueOverrideMaxWithBuffer. Se o valor previsto aumentado por essa proporção exceder a capacidade máxima inicial, o valor aumentado será usado como valor máximo para as tarefas de previsão.

Nenhuma.

ScalingRuleAri

String

Identificador exclusivo da regra de dimensionamento.

Nenhuma.

ScaleOutEvaluationCount

Number

Após a criação de uma regra de dimensionamento de rastreamento de alvo, uma tarefa acionada por evento é criada e associada à regra automaticamente. Esta propriedade indica quantas vezes consecutivas a condição de alerta deve ser atendida antes que a tarefa inicie uma operação de scale-out.

Nenhuma.

ScaleInEvaluationCount

Number

Após a criação de uma regra de dimensionamento de rastreamento de alvo, uma tarefa acionada por evento é criada e associada à regra automaticamente. Esta propriedade indica quantas vezes consecutivas a condição de alerta deve ser atendida antes que a tarefa inicie uma operação de scale-in.

Nenhuma.

MetricName

String

Nome da métrica na tarefa acionada por evento associada à regra de dimensionamento.

Nenhuma.

PredictiveTaskBufferTime

Number

Tempo de buffer antes da execução das tarefas de previsão. Por padrão, todas as tarefas de previsão criadas automaticamente por uma regra de dimensionamento preditivo são executadas na hora cheia. Defina um tempo de buffer para preparação de recursos antes da execução dessas tarefas.

Nenhuma.

MaxSize

Number

Número máximo de instâncias no grupo de dimensionamento.

Nenhuma.

StepAdjustments

String

Ajustes em etapas da regra de dimensionamento em etapas.

Nenhuma.

ScalingRuleName

String

Nome da regra de dimensionamento.

Nenhuma.

DisableScaleIn

String

Indica se o scale-in está desativado. Retornado apenas para regras de dimensionamento de rastreamento de alvo.

Nenhuma.

PredictiveValueBehavior

String

Ação aplicada ao valor máximo previsto.

Nenhuma.

MinSize

Number

Número mínimo de instâncias no grupo de dimensionamento.

Nenhuma.

InitialMaxSize

Number

Número máximo de instâncias que podem ser adicionadas ao grupo de dimensionamento.

Nenhuma.

Alarms

String

Tarefas acionadas por eventos do CloudMonitor associadas à regra de dimensionamento.

Nenhuma.

TargetValue

String

Valor alvo da métrica.

Nenhuma.

EstimatedInstanceWarmup

String

Período de aquecimento durante o qual medidas de preparação são aplicadas às novas instâncias. O sistema não monitora dados de métricas de instâncias em aquecimento.

Nenhuma.

ScalingRuleId

String

ID da regra de dimensionamento.

Nenhuma.

Cooldown

Number

Tempo de resfriamento da regra de dimensionamento. Retornado apenas para regras de dimensionamento simples.

Nenhuma.

ScalingGroupId

String

ID do grupo de dimensionamento.

Nenhuma.

ScalingRuleType

String

Tipo da regra de dimensionamento.

Nenhuma.

AdjustmentType

String

Método de ajuste da regra de dimensionamento.

Nenhuma.

AdjustmentValue

Number

Quantidade de instâncias a ajustar com base na regra de dimensionamento.

Nenhuma.

MetricType

String

Tipo da métrica na tarefa acionada por evento associada à regra de dimensionamento.

Nenhuma.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ScalingRuleIds:
    Type: Json
    Description:
      en: The IDs of the scaling rules that you want to query.
    Required: false
    MinLength: 0
    MaxLength: 20
Resources:
  ExtensionDataSource:
    Type: DATASOURCE::ESS::ScalingRules
    Properties:
      ScalingRuleIds:
        Ref: ScalingRuleIds
Outputs:
  ScalingRules:
    Description: The list of scaling rules.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - ScalingRules
  ScalingRuleIds:
    Description: The list of scaling rule IDs.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - ScalingRuleIds
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ScalingRuleIds": {
      "Type": "Json",
      "Description": {
        "en": "The IDs of the scaling rules that you want to query."
      },
      "Required": false,
      "MinLength": 0,
      "MaxLength": 20
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::ESS::ScalingRules",
      "Properties": {
        "ScalingRuleIds": {
          "Ref": "ScalingRuleIds"
        }
      }
    }
  },
  "Outputs": {
    "ScalingRules": {
      "Description": "The list of scaling rules.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "ScalingRules"
        ]
      }
    },
    "ScalingRuleIds": {
      "Description": "The list of scaling rule IDs.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "ScalingRuleIds"
        ]
      }
    }
  }
}