Tüm Ürünler
Search
Belge Merkezi

:DetachInstances

Son Güncelleme:Oct 02, 2026

Bir ölçeklendirme grubundan örnekleri kaldırır. Etkin durumdaki bir ölçeklendirme grubunda devam eden bir ölçeklendirme etkinliği yoksa, ölçeklendirme grubundan bir veya daha fazla Elastic Compute Service (ECS) örneğini, esnek konteyner örneğini veya Alibaba Cloud'da barındırılan üçüncü taraf örnekleri kaldırmak için DetachInstances işlemini çağırabilirsiniz.

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

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

DecreaseDesiredCapacity

boolean

No

Ölçeklendirme grubundaki beklenen örnek sayısının ayarlanıp ayarlanmayacağını belirtir. Geçerli değerler:

  • true: Ölçeklendirme grubundan belirli sayıda örnek kaldırıldıktan sonra, ölçeklendirme grubundaki beklenen örnek sayısı azalır.

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

Varsayılan değer: true.

true

DetachOption

string

No

Kaldırılmak üzere işaretlenen ECS örneklerinin veya esnek konteyner örneklerinin ilişkili yük dengeleyicilerden ayrılıp ayrılmayacağını ve bu örneklerin özel IP adreslarının ilişkili ApsaraDB RDS örneklerinin IP adresi beyaz listelerinden kaldırılıp kaldırılmayacağını belirtir.

Both: Kaldırılmak üzere işaretlenen ECS örneklerini veya esnek konteyner örneklerini ilişkili yük dengeleyicilerden ayırır ve bu örneklerin özel IP adreslerini ilişkili ApsaraDB RDS örneklerinin IP adresi beyaz listelerinden kaldırır.

Not

Bir ölçeklendirme grubundan Alibaba Cloud'da barındırılan üçüncü taraf örnekleri kaldırmak istiyorsanız bu parametre desteklenmez.

both

InstanceIds

array

Yes

Bir ölçeklendirme grubundan kaldırmak istediğiniz ECS örneklerinin, esnek konteyner örneklerinin veya Alibaba Cloud tarafından yönetilen üçüncü taraf örneklerin kimlikleri.

string

No

Bir ölçeklendirme grubundan kaldırmak istediğiniz ECS örneğinin, esnek konteyner örneğinin veya Alibaba Cloud tarafından yönetilen üçüncü taraf örneğin kimliği.

Örnekler:

  • ECS örneği: i-bp109k5j3dum1ce6****

  • Esnek konteyner örneği: eci-bp17gw49eu09yiwm****

  • Alibaba Cloud'da barındırılan üçüncü taraf örnek: mi-d23fsd******

Not

Tek seferde yalnızca bir örnek türünü kaldırabilirsiniz.

i-bp109k5j3dum1ce6****

LifecycleHook

boolean

No

ECS örnekleri veya esnek konteyner örnekleri ölçeklendirme grubundan kaldırıldığında, ölçek küçültme amacıyla bir yaşam döngüsü kancasının tetiklenip tetiklenmeyeceğini belirtir. Geçerli değerler:

  • true

  • false

Not

Bir ölçeklendirme grubundan Alibaba Cloud'da barındırılan üçüncü taraf örnekleri kaldırmak istiyorsanız bu parametre desteklenmez.

Varsayılan değer: false.

false

IgnoreInvalidInstance

boolean

No

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

  • true: Geçersiz örnekleri yoksayar. Geçersiz örnekler varsa ve geçerli örnekler ölçeklendirme grubundan kaldırılırsa, ilgili ölçeklendirme etkinliği Uyarı durumuna geçer. Yoksayılan geçersiz örnekleri görüntülemek için ölçeklendirme etkinliği ayrıntılarını kontrol edebilirsiniz.

  • false: Geçersiz örnekleri yoksaymaz. Ölçeklendirme grubundan kaldırmak istediğiniz örnek grubunda geçersiz örnekler varsa, bir hata raporlanır.

Varsayılan değer: false.

false

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. İdempotentliği sağlama.

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

Response elements

Element

Type

Description

Example

object

ScalingActivityId

string

Ölçeklendirme etkinliğinin kimliği.

asa-bp1gbswjhjrw8tko****

RequestId

string

İsteğin kimliği.

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

Examples

Success response

JSON format

{
  "ScalingActivityId": "asa-bp1gbswjhjrw8tko****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

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.