Tüm Ürünler
Search
Belge Merkezi

:CreateScalingRule

Son Güncelleme:Oct 02, 2026

Bir ölçeklendirme kuralının işlevi türüne göre belirlenir ve bir ölçeklendirme etkinliğini tetiklemek veya bir ölçeklendirme grubunun sınır değerlerini akıllı bir şekilde ayarlamak için kullanılabilir. İş gereksinimlerinize bağlı olarak, farklı türde ölçeklendirme kuralları oluşturmak üzere CreateScalingRule API'sini çağırabilirsiniz. Örneğin, işiniz yalnızca bir ölçeklendirme grubunun sınır değerlerini ayarlamayı gerektiriyorsa, öngörücü kural türünü seçmenizi öneririz.

Operation description

Bir ölçeklendirme kuralı, N sayıda örnek ekleme veya kaldırma gibi belirli ölçek büyütme veya ölçek küçültme işlemlerini tanımlar. Bir ölçeklendirme kuralının çalıştırılması, ölçeklendirme grubundaki ECS veya ECI örneklerinin sayısının MinSize değerinin altına düşmesine veya MaxSize değerini aşmasına neden olacaksa, otomatik ölçeklendirme, gerçek örnek sayısı MinSize veya MaxSize değerine ulaşacak şekilde eklenecek veya kaldırılacak ECS veya ECI örneklerinin sayısını otomatik olarak ayarlar. Ancak, ölçeklendirme kuralının yapılandırılan değeri değişmeden kalır. Örnekler aşağıdaki gibidir:

  • MaxSize=3 ve mevcut Toplam Kapasitesi 2 olan bir ölçeklendirme grubu için, ölçeklendirme kuralı 3 ECS örneği eklenmesini belirtiyorsa, çalıştırma sırasında gerçekte yalnızca 1 ECS örneği eklenir, ancak ölçeklendirme kuralının yapılandırılan değeri 3 olarak kalır.

  • MinSize=2 ve mevcut Toplam Kapasitesi 3 olan bir ölçeklendirme grubu için, ölçeklendirme kuralı 5 ECS örneği kaldırılmasını belirtiyorsa, çalıştırma sırasında gerçekte yalnızca 1 ECS örneği kaldırılır, ancak ölçeklendirme kuralının yapılandırılan değeri 5 olarak kalır.

Lütfen parametrelerle ilgili aşağıdaki açıklamalara dikkat edin:

  • AdjustmentType, TotalCapacity olduğunda, ölçeklendirme grubundaki mevcut ECS veya ECI örneklerinin sayısının belirtilen miktara ayarlanması anlamına gelir. İlgili AdjustmentValue 0'dan büyük veya ona eşit olmalıdır.

  • AdjustmentType, QuantityChangeInCapacity veya PercentChangeInCapacity olduğunda, pozitif bir AdjustmentValue örnek eklenmesini, negatif bir değer ise örnek kaldırılmasını belirtir.

  • AdjustmentType, PercentChangeInCapacity olduğunda, otomatik ölçeklendirme hizmeti, mevcut örnek sayısını (Toplam Kapasite) AdjustmentValue/100 ile çarparak ve ardından yuvarlama uygulayarak eklenecek veya kaldırılacak ECS veya ECI örneklerinin sayısını hesaplar.

  • Ölçeklendirme kuralında bir bekleme süresi (Cooldown) belirtilmişse, bu kural tarafından tetiklenen ölçeklendirme etkinliği tamamlandıktan sonra ölçeklendirme grubu belirtilen süre kadar bekleme dönemine girer. Ölçeklendirme kuralında bir bekleme süresi belirtilmemişse, ölçeklendirme grubunun varsayılan bekleme süresi (DefaultCooldown) kullanılır.

  • Tek bir ölçeklendirme grubu içinde oluşturulabilecek ölçeklendirme kuralı sayısında bir sınır vardır. Ayrıntılar için Sınırlar bölümüne bakın.

  • Ölçeklendirme kuralının döndürülen Benzersiz Tanımlayıcısı (ScalingRuleAri) aşağıdaki API'lerle kullanılabilir:
    • Ölçeklendirme kuralını manuel olarak çalıştırmak için ExecuteScalingRule çağrılırken ScalingRuleAri parametresinde belirtin.

    • Ölçeklendirme kuralını planlanmış bir zamanda çalıştırmak üzere zamanlanmış bir görev (CreateScheduledTask) oluştururken ScheduledAction parametresinde belirtin.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ess:CreateScalingRule

create

*ScalingGroup

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

None None

Request parameters

Parameter

Type

Required

Description

Example

ScalingGroupId

string

Yes

Ölçeklendirme kuralının ait olduğu ölçeklendirme grubunun kimliği.

asg-bp1ffogfdauy0jw0****

ScalingRuleName

string

No

Ölçeklendirme kuralının adı. Ad 2 ila 64 karakter uzunluğunda olmalı ve harf, rakam, alt çizgi (_), tire (-) ve nokta (.) içerebilir. Ad bir harf veya rakamla başlamalıdır.

Her ölçeklendirme kuralının adı, bir bölge içinde aynı hesap altında benzersiz olmalıdır.

Bu parametreyi boş bırakırsanız, ölçeklendirme kuralı kimliği kullanılır.

scalingrule****

Cooldown

integer

No

Ölçeklendirme kuralının bekleme süresi. Bu parametre yalnızca ScalingRuleType parametresini SimpleScalingRule olarak ayarlarsanız kullanılabilir. Geçerli değerler: 0 ile 86400 arası. Birim: saniye.

Varsayılan olarak bu parametre boş bırakılır.

60

MinAdjustmentMagnitude

integer

No

AdjustmentType parametresi PercentChangeInCapacity olarak ayarlandığında ölçeklendirilmesi gereken minimum örnek sayısı. Bu parametre yalnızca ScalingRuleType parametresini SimpleScalingRule veya StepScalingRule olarak ayarlarsanız etkili olur.

1

AdjustmentType

string

No

Ölçeklendirme kuralının ölçeklendirme yöntemi. Bu parametre yalnızca ScalingRuleType parametresini SimpleScalingRule veya StepScalingRule olarak ayarlarsanız gereklidir. Geçerli değerler:

  • QuantityChangeInCapacity: Belirtilen sayıda ECS örneğini ölçeklendirme grubuna ekler veya ölçeklendirme grubundan belirtilen sayıda ECS örneğini kaldırır.

  • PercentChangeInCapacity: Belirtilen yüzde kadar ECS örneğini ölçeklendirme grubuna ekler veya ölçeklendirme grubundan belirtilen yüzde kadar ECS örneğini kaldırır.

  • TotalCapacity: Ölçeklendirme grubundaki ECS örneklerinin sayısını belirtilen bir sayıya ayarlar.

QuantityChangeInCapacity

AdjustmentValue

integer

No

Ölçeklendirme kuralına göre ölçeklendirilmesi gereken örnek sayısı. Bu parametre yalnızca ScalingRuleType parametresini SimpleScalingRule veya StepScalingRule olarak ayarlarsanız gereklidir. Tek bir ölçeklendirme etkinliğinde ölçeklendirilen ECS örneklerinin sayısı 1.000'i aşamaz.

  • AdjustmentType parametresini QuantityChangeInCapacity olarak ayarlarsanız geçerli değerler: -1000 ile 1000 arası.

  • AdjustmentType parametresini PercentChangeInCapacity olarak ayarlarsanız geçerli değerler: -100 ile 10000 arası.

  • AdjustmentType parametresini TotalCapacity olarak ayarlarsanız geçerli değerler: 0 ile 2000 arası.

100

ScalingRuleType

string

No

Ölçeklendirme kuralının türü. Geçerli değerler:

  • SimpleScalingRule: Basit bir ölçeklendirme kuralı. Basit bir ölçeklendirme kuralını çalıştırdıktan sonra Auto Scaling, AdjustmentType ve AdjustmentValue değerlerine göre ölçeklendirme grubundaki ECS örneklerinin veya esnek konteyner örneklerinin sayısını ayarlar.

  • TargetTrackingScalingRule: Hedef izleyen ölçeklendirme kuralı. Hedef izleyen bir ölçeklendirme kuralını çalıştırdıktan sonra Auto Scaling, önceden tanımlanmış metriğe (MetricName) göre ölçeklendirilecek ECS örneklerinin veya esnek konteyner örneklerinin sayısını dinamik olarak hesaplar ve metrik değerini beklenen değere (TargetValue) yakın tutmaya çalışır.

  • StepScalingRule: Adımlı ölçeklendirme kuralı. Adımlı bir ölçeklendirme kuralını çalıştırdıktan sonra Auto Scaling, önceden tanımlanmış eşiklere ve metrik değerlerine göre örnekleri adım adım ölçeklendirir.

  • PredictiveScalingRule: Öngörücü ölçeklendirme kuralı. Öngörücü bir ölçeklendirme kuralını çalıştırdıktan sonra Auto Scaling, ölçeklendirme grubunun geçmiş izleme verilerini analiz etmek için makine öğrenimini kullanır ve metriklerin gelecekteki değerlerini tahmin eder. Ayrıca Auto Scaling, ölçeklendirme grubunun sınır değerlerini ayarlamak için otomatik olarak zamanlanmış görevler oluşturur.

Varsayılan değer: SimpleScalingRule.

SimpleScalingRule

EstimatedInstanceWarmup

integer

No

Bir örneğin ısınma süresi. Bu parametre yalnızca ScalingRuleType parametresini TargetTrackingScalingRule veya PredictiveScalingRule olarak ayarlarsanız kullanılabilir. Auto Scaling, ısınma durumundaki ECS örneklerini bir ölçeklendirme grubuna ekler ancak ısınma süresi boyunca CloudMonitor'a izleme verisi bildirmez.

Not

Auto Scaling, ölçeklendirilmesi gereken ECS örneklerinin sayısını hesaplar. Isınma durumundaki ECS örnekleri, ölçeklendirme grubunun mevcut kapasitesine dahil edilmez.

Geçerli değerler: 0 ile 86400 arası. Birim: saniye.

Varsayılan değer: 300.

300

MetricName

string

No

İzlemek istediğiniz önceden tanımlanmış metrik. ScalingRuleType değerini TargetTrackingScalingRule veya PredictiveScalingRule olarak ayarlarsanız, bu parametreyi belirtmeniz gerekir.

ScalingRuleType değerini TargetTrackingScalingRule olarak ayarlarsanız geçerli değerler:

  • CpuUtilizationAgent (önerilen): CPU kullanımı.

  • MemoryUtilization (önerilen): Bellek kullanımı.

  • CpuUtilization: Ortalama CPU kullanımı.

  • IntranetTx: Dahili ağ üzerinden giden trafik.

  • IntranetRx: Dahili ağ üzerinden ortalama gelen trafik.

  • VpcInternetTx: Sanal özel buluttan (VPC) İnternet'e giden trafik.

  • VpcInternetRx: İnternet'ten VPC'ye gelen trafik.

  • LoadBalancerRealServerAverageQps: Uygulama Yük Dengeleyici (ALB) sunucu grubu başına saniyedeki sorgu sayısı (QPS).

ScalingRuleType değerini PredictiveScalingRule olarak ayarlarsanız geçerli değerler:

  • CpuUtilization: Ortalama CPU kullanımı.

  • IntranetRx: Dahili ağ üzerinden ortalama gelen trafik.

  • IntranetTx: Dahili ağ üzerinden ortalama giden trafik.

Daha fazla bilgi için Sistem izleme türündeki olay tetikli görevler bölümüne bakın.

CpuUtilization

TargetValue

number

No

Hedef değer. Bu parametre yalnızca ScalingRuleType parametresini TargetTrackingScalingRule veya PredictiveScalingRule olarak ayarlarsanız gereklidir. Değer 0'dan büyük olmalı ve en fazla üç ondalık basamak içerebilir.

0.125

DisableScaleIn

boolean

No

Ölçek küçültmenin devre dışı bırakılıp bırakılmayacağını belirtir. Bu parametre yalnızca ScalingRuleType değerini TargetTrackingScalingRule olarak ayarlarsanız kullanılabilir.

Varsayılan değer: false.

false

ScaleInEvaluationCount

integer

No

Ölçek küçültme etkinlikleri için oluşturulan olay tetikli görevin bir uyarı tetiklenmeden önce eşik koşullarını ardışık olarak karşılaması gereken sayı. Hedef izleyen bir ölçeklendirme kuralı oluşturulduktan sonra, otomatik olarak bir olay tetikli görev oluşturulur ve ardından hedef izleyen ölçeklendirme kuralıyla ilişkilendirilir.

Varsayılan değer: 15.

15

ScaleOutEvaluationCount

integer

No

Ölçek büyütme etkinlikleri için oluşturulan olay tetikli görevin bir uyarı tetiklenmeden önce eşik koşullarını ardışık olarak karşılaması gereken sayı. Hedef izleyen bir ölçeklendirme kuralı oluşturulduktan sonra, otomatik olarak bir olay tetikli görev oluşturulur ve ardından hedef izleyen ölçeklendirme kuralıyla ilişkilendirilir.

Varsayılan değer: 3.

3

PredictiveScalingMode

string

No

Öngörücü ölçeklendirme kuralının modu. Geçerli değerler:

  • PredictAndScale: Tahminler üretir ve tahmin görevleri oluşturur.

  • PredictOnly: Tahminler üretir ancak tahmin görevleri oluşturmaz.

Varsayılan değer: PredictAndScale.

PredictAndScale

PredictiveValueBehavior

string

No

Tahmin görevleri için maksimum değer. Geçerli değerler:

  • MaxOverridePredictiveValue: Tahmin edilen değer başlangıç maksimum kapasitesinden büyükse, tahmin görevleri için maksimum değer olarak başlangıç maksimum kapasitesini kullanır.

  • PredictiveValueOverrideMax: Tahmin edilen değer başlangıç maksimum kapasitesinden büyükse, tahmin görevleri için maksimum değer olarak tahmin edilen değeri kullanır.

  • PredictiveValueOverrideMaxWithBuffer: Tahmin edilen değeri, PredictiveValueBuffer parametresi tarafından belirtilen bir yüzde kadar artırır. Yüzde kadar artırılan tahmin edilen değer başlangıç maksimum kapasitesinden büyükse, artırılan değer tahmin görevleri için maksimum değer olarak kullanılır.

Varsayılan değer: MaxOverridePredictiveValue.

MaxOverridePredictiveValue

PredictiveValueBuffer

integer

No

PredictiveValueBehavior değerini PredictiveValueOverrideMaxWithBuffer olarak ayarladığınızda tahmin edilen değerin artırıldığı oran. Bu oran kadar artırılan tahmin edilen değer başlangıç maksimum kapasitesinden büyükse, artırılan değer tahmin görevleri için maksimum değer olarak kullanılır. Geçerli değerler: 0 ile 100 arası.

Varsayılan değer: 0.

50

PredictiveTaskBufferTime

integer

No

Tahmin görevi çalıştırılmadan önceki arabellek süresi miktarı. Varsayılan olarak, öngörücü bir ölçeklendirme kuralı için otomatik olarak oluşturulan tüm tahmin görevleri saatin başında çalıştırılır. Tahmin görevleri çalıştırılmadan önce kaynak hazırlığı için bir arabellek süresi miktarı belirtebilirsiniz. Geçerli değerler: 0 ile 60 arası. Birim: dakika.

Varsayılan değer: 0.

30

InitialMaxSize

integer

No

Ölçeklendirme grubunda bulunabilecek maksimum ECS örneği sayısı. InitialMaxSize değerini belirtirseniz, PredictiveValueBehavior değerini de belirtmeniz gerekir.

Bu parametrenin varsayılan değeri, MaxSize değeridir.

100

StepAdjustments

array<object>

No

Adım ayarlamalarının ayrıntıları.

object

No

Adım ayarlamalarının ayrıntıları.

MetricIntervalUpperBound

number

No

Bir adım ayarlamasında belirtilen üst sınır. Geçerli değerler: -9.999999E18 ile 9.999999E18 arası.

5.0

ScalingAdjustment

integer

No

Bir adım ayarlamasında ölçeklendirmek istediğiniz ECS örneklerinin sayısı. Bu parametre yalnızca ScalingRuleType parametresini StepScalingRule olarak ayarlarsanız kullanılabilir.

1

MetricIntervalLowerBound

number

No

Bir adım ayarlamasında belirtilen alt sınır. Bu parametre yalnızca ScalingRuleType parametresini StepScalingRule olarak ayarlarsanız kullanılabilir. Geçerli değerler: -9.999999E18 ile 9.999999E18 arası.

1.0

RegionId

string

No

Ölçeklendirme grubunun bölge kimliği.

cn-hangzhou

AlarmDimensions

array<object>

No

Metrik boyutları. Bu parametre hedef izleyen ölçeklendirme kuralları için geçerlidir. Önceden tanımlanmış metriğiniz ekstra boyutlar gerektiriyorsa, bu parametreyi belirtmeniz gerekir. Örneğin, önceden tanımlanmış metriğiniz olarak LoadBalancerRealServerAverageQps kullanıyorsanız, rulePool boyutunu belirtmek için bu parametreyi kullanmanız gerekir.

object

No

İzleme metrikleri için boyut bilgi değerleri. Bu parametre hedef izleyen kurallar için geçerlidir ve bir metrik için ek boyut bilgisi gerektiğinde kullanılır. Örneğin, LoadBalancerRealServerAverageQps metriği, rulePool boyut anahtar-değer çiftinin belirtilmesini gerektirir.

DimensionKey

string

No

Metriğin boyut anahtarı.

rulePool

DimensionValue

string

No

Metriğin boyut değeri.

sgp-l1cbirz451yxuxxx

MetricType

string

No

Metrik türü. Geçerli değerler:

  • system: CloudMonitor'ın sistem metrikleri.

  • custom: CloudMonitor'a bildirilen özel metrikler.

  • hybrid: Hibrit Bulut İzleme metrikleri.

system

HybridMonitorNamespace

string

No

Hibrit Bulut İzleme ad alanının kimliği.

Hibrit Bulut İzleme ad alanlarının nasıl yönetileceği hakkında bilgi için Ad alanlarını yönetme bölümüne bakın.

aliyun-test

HybridMetrics

array<object>

No

Hibrit Bulut İzleme metrikleri. Daha fazla bilgi için Özel bir hedef izleyen ölçeklendirme kuralı oluşturma bölümüne bakın.

array<object>

No

Id

string

No

Metrik ifadesindeki metriğin referans kimliği.

a

Expression

string

No

Birden fazla Hibrit Bulut İzleme metriğinden oluşan metrik ifadesi. Ölçeklendirme olaylarını tetiklemek için kullanılan bir sonucu hesaplar.

İfade, Ters Lehçe Gösterimi (RPN) biçiminde yazılmalı ve yalnızca şu operatörleri desteklemelidir: +, -, *, /.

(a+b)/2

MetricName

string

No

Hibrit Bulut İzleme metriğinin adı.

AliyunSmq_NumberOfMessagesVisible

Statistic

string

No

Metrik değerinin istatistiksel yöntemi. Geçerli değerler:

  • Average: Belirtilen bir aralıktaki tüm metrik değerlerinin ortalama değerini hesaplar.

  • Minimum: Belirtilen bir aralıktaki tüm metrik değerlerinin minimum değerini hesaplar.

  • Maximum: Belirtilen bir aralıktaki tüm metrik değerlerinin maksimum değerini hesaplar.

Average

Dimensions

array<object>

No

Metrik boyutları. İzlenen kaynakları belirtmek için bu parametreyi kullanabilirsiniz.

object

No

DimensionKey

string

No

Metrik boyutunun anahtarı.

queue

DimensionValue

string

No

Metrik boyutunun değeri.

testQueue

AlarmOptions

object

No

Uyarı özelliklerinin tanımı.

Period

integer

No

Hedef izleyen bir kuralda izleme metrik verilerinin toplanma dönemi, saniye cinsinden. Geçerli değerler:

  • 15

  • 60

  • 120

  • 300

  • 900

Not

Varsayılan değer: 60.

60

Response elements

Element

Type

Description

Example

object

ScalingRuleAri

string

Ölçeklendirme kuralının benzersiz tanımlayıcısı.

ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****

RequestId

string

İsteğin kimliği.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ScalingRuleId

string

Sistem tarafından oluşturulan ve global olarak benzersiz olan ölçeklendirme kuralının kimliği.

asr-bp1dvirgwkoowxk7****

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.