Tüm Ürünler
Search

Bu Ürün

    :StartInstanceRefresh

    Belge Merkezi

    :StartInstanceRefresh

    Son Güncelleme:Oct 02, 2026

    Ölçeklendirme grubundaki örneklerin görüntüsünü güncellemeniz veya yeni bir ölçeklendirme yapılandırması uygulamanız gerektiğinde ölçeklendirme grubundaki örnekleri yeniler.

    Operation description

    • Bir ölçeklendirme grubunda aynı anda yalnızca bir örnek yenileme düğümü çalışabilir.

    • Bu özellik yalnızca ölçek büyütme politikası Öncelik Politikası olarak ayarlanmış ECS ölçeklendirme gruplarını destekler. vCPU Tabanlı Kapasite Hesaplama kullanan ölçeklendirme grupları ile örnek iptal düzeni Kapatma ve İptal Düzeni veya Zorla Kapatma ve İptal Düzeni olarak ayarlanmış ölçeklendirme grupları bu özelliği desteklemez.

    • Örnek yenileme sırasında normal ölçek büyütme ve ölçek küçültme işlemleri gerçekleştirilebilir. Ancak ölçek büyütme işlemleri, örnek yenilemenin istenen yapılandırmasını kullanır.

    • Ölçeklendirme grubuna manuel olarak eklenen örnekler, bekleme durumundaki örnekler ve koruma durumundaki örnekler, örnek yenileme düğümü tarafından yoksayılır ve örnek yenilemeye katılmaz.

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

    update

    *ScalingGroup

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

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ScalingGroupId

    string

    Yes

    Ölçeklendirme grubunun kimliği.

    asg-bp18p2yfxow2dloq****
    ClientToken

    string

    No

    İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için bkz. İdempotentlik nasıl sağlanır.

    123e4567-e89b-12d3-a456-42665544****
    RegionId

    string

    Yes

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

    cn-hangzhou
    MinHealthyPercentage

    integer

    No

    Örnek yenileme sırasında ölçeklendirme grubunda hizmette kalması gereken minimum örnek yüzdesi. Geçerli değerler: 0 ile 100 arası. Varsayılan değer: 80.

    80
    MaxHealthyPercentage

    integer

    No

    Örnek yenileme sırasında ölçeklendirme grubundaki örnek sayısının ölçeklendirme grubu kapasitesini aşabileceği maksimum yüzde. Geçerli değerler: 100 ile 200 arası. Varsayılan değer: 120.

    Not

    MinHealthyPercentage = MaxHealthyPercentage = 100 olduğunda, her seferinde bir örnek yenilenir.

    100
    DesiredConfiguration

    object

    No

    Örnek yenileme için istenen yapılandırma.

    Not

    • ScalingConfigurationId, ImageId, LaunchTemplateId ve Containers parametrelerini aynı anda belirtemezsiniz. Bu parametre boş bırakılırsa, yenileme için ölçeklendirme grubunun şu anda etkin olan yapılandırması kullanılır.

    • Örnek yenileme görevi tamamlandıktan sonra, ölçeklendirme grubunun etkin ölçeklendirme yapılandırması bu yapılandırmayla güncellenir.

    ImageId

    string

    No

    Görüntü kimliği.

    Not

    • Örnek yenileme görevi tamamlandıktan sonra, ölçeklendirme grubunun şu anda etkin olan yapılandırmasındaki görüntü bu görüntüyle güncellenir.

    • Ölçeklendirme grubunun örnek yapılandırma kaynağı bir başlatma şablonu olduğunda bu parametre desteklenmez.

    • Veri bulut diskleri içeren görüntüler desteklenmez.

    m-2ze8cqacj7opnf***
    ScalingConfigurationId

    string

    No

    Ölçeklendirme yapılandırmasının kimliği.

    asc-2zed7lqn4ts4****
    LaunchTemplateId

    string

    No

    Başlatma şablonunun kimliği. Bu parametre, ölçeklendirme grubunun başlatma yapılandırma bilgilerini başlatma şablonundan alacağını belirtir.

    lt-2ze2qli30u***
    LaunchTemplateVersion

    string

    No

    Başlatma şablonunun sürümü. Geçerli değerler:

    • Sabit bir şablon sürüm numarası.

    • Default: Her zaman şablonun varsayılan sürümünü kullanır.

    • Latest: Her zaman şablonun en son sürümünü kullanır.

    Not

    Sürüm Default veya Latest olarak ayarlandığında örnek yenileme görevleri için geri alma işlemi desteklenmez.

    8
    LaunchTemplateOverrides

    array<object>

    No

    Başlatma şablonunu genişleten örnek türü bilgileri.

    object

    No

    Başlatma şablonunu genişleten örnek türü bilgileri.

    InstanceType

    string

    No

    Başlatma şablonunda belirtilen örnek türünü geçersiz kılan örnek türü.

    Not

    Bu parametre yalnızca LaunchTemplateId parametresi bir başlatma şablonu belirttiğinde etkili olur.

    ecs.c5.2xlarge
    Containers

    array<object>

    No

    Örnekteki konteynerlerin listesi.

    Not

    • Bu parametre yalnızca Elastic Container Instance (ECI) ölçeklendirme grupları için desteklenir.

    • Yalnızca mevcut ölçeklendirme yapılandırması konteyner listesindeki adı Container.Name ile eşleşen konteyner yapılandırmaları yenilenir.

    array<object>

    No

    Örnekteki konteynerlerin listesi.

    Name

    string

    No

    Özel konteyner adı.

    nginx
    Image

    string

    No

    Konteyner görüntüsü.

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:latest
    Commands

    array

    No

    Konteyner başlatma komutları. En fazla 20 komut desteklenir. Her komut en fazla 256 karakter içerebilir.

    string

    No

    Konteyner başlatma komutları. En fazla 20 komut desteklenir. Her komut en fazla 256 karakter içerebilir.

    sleep
    Args

    array

    No

    Konteyner başlatma komutunun bağımsız değişkenleri. En fazla 10 bağımsız değişken desteklenir.

    string

    No

    Konteyner başlatma komutunun bağımsız değişkenleri. En fazla 10 bağımsız değişken desteklenir.

    100
    EnvironmentVars

    array<object>

    No

    Ortam değişkeni bilgileri.

    object

    No

    Ortam değişkeni bilgileri.

    Key

    string

    No

    Ortam değişkeninin adı. Ad 1 ila 128 karakter uzunluğunda olmalı ve rakam, harf ve alt çizgi (_) içerebilir. Rakamla başlayamaz.

    PATH
    Value

    string

    No

    Ortam değişkeninin değeri. Değer 0 ila 256 karakter uzunluğunda olabilir.

    /usr/local/bin

    FieldRefFieldPath

    string

    No

    Not

    Bu parametre herkese açık değildir.

    fieldPath
    SkipMatching

    boolean

    No

    İstenen yapılandırmayla eşleşen örneklerin atlanıp atlanmayacağını belirtir.

    Not

    Sistem, bir örneğin eşleşip eşleşmediğini tek tek yapılandırma öğelerini karşılaştırarak değil, istenen ölçeklendirme yapılandırmasının kimliğine göre belirler.

    Geçerli değerler:

    • true: Zaten istenen yapılandırmayla oluşturulmuş örnekler atlanır.

    • false: Yenileme görevi başladığında ölçeklendirme grubundaki tüm örnekler yenilenir.

    Varsayılan değer: true.

    true
    Checkpoints

    array<object>

    No

    Yenileme görevi için kontrol noktaları. Örnek yenileme sırasında yeni örneklerin yüzdesi belirtilen değere ulaştığında görevin CheckpointPauseTime dakika boyunca otomatik olarak duraklatılacağını belirtir.

    object

    No

    Yenileme görevi için kontrol noktaları. Örnek yenileme sırasında yeni örneklerin yüzdesi belirtilen değere ulaştığında görevin CheckpointPauseTime dakika boyunca otomatik olarak duraklatılacağını belirtir.

    Percentage

    integer

    No

    Görevin otomatik olarak duraklatılacağı, ölçeklendirme grubundaki toplam örneklere kıyasla yeni örneklerin yüzdesi. Geçerli değerler: 1 ile 100 arası (%).

    Not

    Değerler artan sırada belirtilmelidir ve son yüzde değeri 100 olmalıdır.

    20
    CheckpointPauseTime

    integer

    No

    Bir kontrol noktasına ulaşıldığında görevin duraklatıldığı süre.

    • Birim: dakika.

    • Geçerli değerler: 1 ile 2880 arası.

    • Varsayılan değer: 60.

    10
    Strategy

    string

    No

    Örnek yenileme görevi için yürütme stratejisi. Geçerli değerler:

    • Rolling: Örnek yenileme görevi, örnekleri yenilemek için yeni örnekler oluşturur ve eski örnekleri serbest bırakır.

    • ReplaceSystemDisk: Sistem bulut diskini güncellemek için DesiredConfiguration.image belirtilerek mevcut örneklerin sistem bulut diski değiştirilir.

    Varsayılan değer: Rolling.

    Rolling

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    İstek kimliği.

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

    string

    Örnek yenileme görevinin kimliği.

    ir-a12ds234fasd*****

    Examples

    Success response

    JSON format

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceRefreshTaskId": "ir-a12ds234fasd*****"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.