Tüm Ürünler
Search

Bu Ürün

    :RemoveInstances

    Belge Merkezi

    :RemoveInstances

    Son Güncelleme:Oct 13, 2026

    Bir ölçeklendirme grubundan gereksiz bir veya daha fazla örneği siler. Ölçeklendirme grubu etkin durumdayken ve devam eden bir ölçeklendirme etkinliği yokken örnekleri silmek için RemoveInstances API işlemini çağırabilirsiniz.

    Operation description

    • Bu işlemi çağırmadan önce aşağıdaki koşulların karşılandığından emin olun:

      • Ölçeklendirme grubu etkin (Active) durumdadır.

      • Ölçeklendirme grubunda devam eden bir ölçeklendirme etkinliği yoktur.

    Not

    Ölçeklendirme grubunda devam eden bir ölçeklendirme etkinliği yoksa, sistem bekleme süresini (DefaultCooldown) atlayabilir ve bu işlemi doğrudan çalıştırabilir.

    • Bir ECS örneği Auto Scaling tarafından oluşturulduysa veya manuel olarak eklendiyse ancak ölçeklendirme grubu tarafından yönetiliyorsa, ECS örneğini ölçeklendirme grubundan kaldırdığınızda ECS örneği ekonomik modu tetikler veya serbest bırakılır.

    • Bir ECS örneği manuel olarak eklendiyse ve ölçeklendirme grubu tarafından yönetilmiyorsa, ECS örneğini ölçeklendirme grubundan kaldırdığınızda ECS örneği durdurulmaz veya serbest bırakılmaz.

    • Ölçeklendirme grubundaki mevcut örnek sayısı (TotalCapacity) eksi bu işlemde belirtilen örnek sayısı, ölçeklendirme grubundaki minimum örnek sayısından (MinSize) az ise işlemi çağırma girişimi başarısız olur.

    Başarılı bir yanıt, yalnızca Auto Scaling hizmetinin isteği kabul ettiğini ve ölçeklendirme etkinliğinin çalıştırılabileceğini gösterir. Bu, ölçeklendirme etkinliğinin başarıyla çalıştırılacağı anlamına gelmez. Ölçeklendirme etkinliğinin çalıştırma durumunu kontrol etmek için döndürülen ScalingActivityId değerini kullanmanız gerekir.

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

    update

    *Ölçeklendirme grubu.

    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****
    RemovePolicy

    string

    No

    Kaldırılan ECS örnekleri üzerinde gerçekleştirilecek eylemi belirtir. Geçerli değerler:

    • recycle: ECS örnekleri ekonomik modu tetikler.

      Not

      Bu değer yalnızca ScalingPolicy parametresi recycle olarak ayarlandığında geçerli olur.

    • release: ECS örnekleri serbest bırakılır.

    CreateScalingGroup işleminin ScalingPolicy parametresi ölçeklendirme grubunun geri kazanım modunu belirtir, ancak bir örnek kaldırıldığında gerçekleştirilen belirli eylem RemoveInstances işleminin RemovePolicy parametresi tarafından belirlenir. Örnekler:

    • ScalingPolicy recycle ve RemovePolicy recycle olarak ayarlanırsa, ECS örnekleri ekonomik modu tetikler.

    • ScalingPolicy recycle ve RemovePolicy release olarak ayarlanırsa, ECS örnekleri serbest bırakılır.

    • ScalingPolicy release ve RemovePolicy recycle olarak ayarlanırsa, ECS örnekleri serbest bırakılır.

    • ScalingPolicy release ve RemovePolicy release olarak ayarlanırsa, ECS örnekleri serbest bırakılır.

    Varsayılan değer: release.

    release
    DecreaseDesiredCapacity

    boolean

    No

    Beklenen örnek sayısının değiştirilip değiştirilmeyeceğini belirtir. Geçerli değerler:

    • true: ECS örnekleri ölçeklendirme grubundan kaldırıldıktan sonra, beklenen örnek sayısı kaldırılan örnek sayısı kadar azaltılır.

    • false: ECS örnekleri ölçeklendirme grubundan kaldırıldıktan sonra, beklenen örnek sayısı değişmeden kalır.

    Varsayılan değer: true.

    true
    IgnoreInvalidInstance

    boolean

    No

    Ölçeklendirme grubundan bir grup örnek kaldırılırken geçersiz örneklerin yoksayılıp yoksayılmayacağını belirtir. Geçerli değerler:

    • true: Ölçeklendirme grubundan bir grup örnek kaldırılırken geçersiz örnekler yoksayılır. Geçersiz örnekler varsa ve geçerli örnekler başarıyla kaldırılırsa, ölçeklendirme etkinliğinin çalıştırma durumu Uyarı olarak görüntülenir. Geçersiz örnekleri ölçeklendirme etkinliği ayrıntılarında görüntüleyebilirsiniz.

    • false: Ölçeklendirme grubundan bir grup örnek kaldırılırken geçersiz örnekler yoksayılmaz. Grupta geçersiz örnekler varsa bir hata raporlanır.

    Varsayılan değer: false.

    false
    InstanceIds

    array

    Yes

    Kaldırılacak ECS örneklerinin kimlikleri.

    string

    No

    Kaldırılacak ECS örneklerinin kimlikleri.

    i-28wt4****
    RegionId

    string

    No

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

    cn-qingdao
    ClientToken

    string

    No

    İsteğin idempotansını sağlamak için kullanılan istemci belirteci. Değeri oluşturmak için istemciyi kullanabilirsiniz, ancak değerin 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. İdempotans nasıl sağlanır.

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

    integer

    No

    Ölçek küçültme işlemi sırasında ECS örneklerinin başarıyla durmasının beklenmesi için zaman aşımı süresi. Birim: saniye. Geçerli değerler: 30 ile 240 arası.

    Not

    • Varsayılan olarak, bu parametre değerini ölçeklendirme grubundan devralır. RemoveInstances işlemini çağırırken bu değeri sıfırlayabilirsiniz.

    • Bu parametre yalnızca RemovePolicy release olarak ayarlandığında ölçek küçültme işlemi sırasında geçerli olur.

    • Bu parametre ayarlanırsa, sistem örneklerin başarıyla durması için en fazla StopInstanceTimeout süresi kadar bekler. Zaman aşımı süresinden sonra, örneklerin başarıyla durup durmadığına bakılmaksızın ölçek küçültme işlemi devam eder.

    • Bu parametre ayarlanmazsa, sistem örneklerin başarıyla durması için süresiz olarak bekler. Ölçek küçültme işlemi yalnızca örnekler başarıyla durduktan sonra devam eder. Örnekler durmazsa, ölçek küçültme işlemi geri alınır ve ölçek küçültme başarısız olur.

    60
    LifecycleHookContext

    object

    No

    Yaşam döngüsü kancasının bağlam bilgileri.

    DisableLifecycleHook

    boolean

    No

    Ölçeklendirme etkinliği için tüm yaşam döngüsü kancalarının devre dışı bırakılıp bırakılmayacağını belirtir. Geçerli değerler:

    • true: Tüm yaşam döngüsü kancalarını devre dışı bırakır.

    • false: Yaşam döngüsü kancalarını devre dışı bırakmaz.

    false
    IgnoredLifecycleHookIds

    array

    No

    Ölçeklendirme etkinliği için devre dışı bırakılan yaşam döngüsü kancalarının kimlikleri.

    string

    No

    Ölçeklendirme etkinliği için devre dışı bırakılan yaşam döngüsü kancalarının kimlikleri.

    ash-bp14zolna43z266bq***
    LifecycleHookResult

    string

    No

    Response elements

    Element

    Type

    Description

    Example

    object

    ScalingActivityId

    string

    Ölçeklendirme etkinliğinin kimliği.

    asa-bp175o6f6ego3r2j****
    RequestId

    string

    İsteğin kimliği.

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

    array<object>

    İstekte yoksayılan geçersiz örneklerin listesi.

    object

    InstanceId

    string

    Yoksayılan örneğin kimliği.

    Code

    string

    Örneğin neden yoksayıldığını belirten kod.

    Message

    string

    Örneğin neden yoksayıldığına ilişkin açıklama.

    Examples

    Success response

    JSON format

    {
  "ScalingActivityId": "asa-bp175o6f6ego3r2j****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "IgnoredInstances": [
    {
      "InstanceId": "",
      "Code": "",
      "Message": ""
    }
  ]
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    500 InternalError The request processing has failed due to some unknown error, exception or failure.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.